daveebbelaar/bama

BAMA（Build Any Mac App） は、AI コーディングエージェントがアイデアや既存のアプリを Swift と SwiftUI で書かれたネイティブ macOS アプリに変換するのに役立つエージェントスキルのコレクションです。Xcode のグラフィカルインターフェースを開かずに動作するように設計されています。すべてはコードとコマンドラインツールで行われます。

機能：

• エージェントに「私の todo アプリをネイティブ Mac アプリとしてクローンして」や「BAMA で window-snapper.md のアプリをビルドして」などのプロンプトを与えます。
• エージェントは 3 段階のプロセスに従います：クローン（気に入ったアプリのすべての画面をスクリーンショットし、画面インデックスを書く）、プラン（画面を受け入れ基準付きのユーザーストーリーに変換し、マイルストーンにグループ化）、ビルド（コミットごとに 1 つのストーリーを実装し、各コミットの前にライト/ダークスナップショットを撮り、テストを実行）。
• /bama コマンドはルーターとして機能します：プロジェクトを検査し、次の適切なスキルを選択します。

スキル（合計 21）：

• 開始： bama（ルーター）、app-brief（アイデアを 1 ページのブリーフに変換）、new-mac-app（SwiftData、ビルドスクリプト、スナップショットモード、git を含むテンプレートから動作するアプリを作成）。
• プラン： research（市場、ユーザー、機能、デザイン、macOS API に関する並行リサーチ）、clone（コンピューター使用またはブラウザで任意のアプリのスクリーンショットを撮る）、user-stories（チェック可能な受け入れ基準付きのバックログ）。
• コード： swift-swiftui（Swift 6 並行性、状態、SwiftData、AppKit ブリッジ）、os-integrations（ホットキー、メニューバー、フローティングパネル、画面キャプチャ、ショートカット、URL スキーム、CLI、権限）、performance（メインスレッド、GPU、画像、Instruments を測定して修正）、improve-architecture（コミットごとに 1 つのホットスポットをリファクタリング）、agent-cli（外部制御用のオプションの CLI と MCP サーバー）。
• デザイン： ux-design（名前、フロー、機能が開く場所、アクセシビリティ）、mac-design（Liquid Glass、レイアウト、ツールバー、メニュー、ダークモード）、design-system（アクセントカラー、トークン、ルール付きのネイティブルック）、layout-grid（整列チェック付きの 4pt グリッド）、design-kit（カスタムパーツ、アイコンセット、すべての状態、パーツギャラリー）、design-from-app（スクリーンショットからアプリの外観を再構築、ピクセル単位の比較）、app-icon（Icon Composer ファイルとしての Liquid Glass アイコン）。
• リリース： build-and-verify（ビルド、インストール、ライト/ダークで各ページのスナップショットを撮る）、test-mac-app（Swift Testing、アプリ内セルフテスト、デバッグブリッジ）、improve-loop（マイルストーンが完了するまでコミットごとに 1 つのストーリーをバックログで処理）。

仕様：

• specs/ フォルダには、小さな Mac アプリ（ウィンドウスナッパー、ウィンドウスイッチャー、ランチャー、クリップボード履歴、スクリーンショット、スクリーンレコーダーなど）の 12 のビルドプランが含まれています。空のフォルダにコピーして、エージェントにビルドを依頼できます。

インストール：

• Claude Code の場合：/plugin marketplace add daveebbelaar/bama 次に /plugin install bama@bama。
• Codex の場合：codex plugin marketplace add daveebbelaar/bama 次に codex plugin add bama@bama。
• その他のエージェント（Cursor、Gemini CLI、Copilot）の場合：npx skills@latest add daveebbelaar/bama -a <agent>（または単一スキルの場合は --skill=clone）を使用します。
• 手動：git clone https://github.com/daveebbelaar/bama.git を実行し、bama/scripts/link-skills.sh を実行してスキルを ~/.claude/skills と ~/.agents/skills にリンクします。

要件：

• macOS 26 以降
• Xcode 26 以降（Swift 6.2 ツールチェーン用。ただし、開く必要はありません）
• スキルをサポートするエージェント（Claude Code、Codex、Cursor、Gemini CLI）
• ネイティブアプリの clone スキルには：コンピューター使用（Claude Pro または Max）

クレジット：

• アイデアと「任意」の約束は、morluto による REA: Reverse Engineer Anything から来ています。
• スキル形式は、Matt Pocock の skills と彼の writing-for-agents スキルに従っています。
• Paul Hudson の SwiftUI Pro と Antoine van der Lee の SwiftUI Expert とよく連携します。

ライセンス： MIT。