/brainstorm → /spec → /implement → /review → /test → /compound

# 1. クローン
git clone https://github.com/kousukef/forge.git
cd forge

# 2. インストール（シンボリックリンク方式）
bash install.sh

# 3. 任意のプロジェクトで Claude Code を起動して使う
cd ~/my-project
claude
> /ship ユーザー認証機能を追加したい

  ユーザー: /ship （または個別コマンド）
    │
    ▼
┌──────────────────────────────────────────────────────────────┐
│  /brainstorm                                                 │
│  ソクラテス式対話で要件を深掘り → proposal.md                     │
│                                              [ユーザー承認]     │
├──────────────────────────────────────────────────────────────┤
│  /spec                                                       │
│                                                              │
│  ┌─────────────┐ ┌──────────────┐ ┌───────────┐ ┌────────┐  │
│  │ stack-docs  │ │web-researcher│ │ codebase- │ │compound│  │
│  │ researcher  │ │              │ │ analyzer  │ │learnings│ │
│  └──────┬──────┘ └──────┬───────┘ └─────┬─────┘ └───┬────┘  │
│         └───────────────┴───────────────┴────────────┘       │
│                         ▼                                    │
│              spec-writer → spec-validator                    │
│              design.md / tasks.md / delta-spec.md            │
│                                              [ユーザー承認]     │
├──────────────────────────────────────────────────────────────┤
│  /implement                              ┌──── 以降は自律実行  │
│  Main Agent（オーケストレーション専任）          │                │
│    └─ implementer × N（TDD: RED→GREEN→REFACTOR）             │
├──────────────────────────────────────────────────────────────┤
│  /review                                                     │
│  複数の専門レビュアーが並列でコードを検査                           │
├──────────────────────────────────────────────────────────────┤
│  /test                                                       │
│  テスト → 型チェック → lint → ビルド検証                          │
│  （失敗時は最大3回リトライ）                                      │
├──────────────────────────────────────────────────────────────┤
│  /compound                                                   │
│  学びを記録 + スペックマージ + アーカイブ                          │
└──────────────────────────────────────────────────────────────┘

Main Agent（オーケストレーション専任）
  │
  │  仕様書・タスクリストを読み込み、作業を分配
  │  ※ 実装ファイルの Read / Write / Edit は禁止
  │
  ├─ [Teams モード] --teams
  │   teammate 間で直接通信。フィードバックが必要な場面向け
  │
  └─ [Sub Agents モード] --agents（デフォルト）
      独立した並列実行。各タスクが独立して完了できる場面向け

skills/<skill-name>/
├── SKILL.md           # フル知識（~500行）— /implement, /review で使用
├── design.md          # 設計指針（~120行）— /spec で使用
└── constraints.md     # 制約のみ（~30行）— /brainstorm で使用

/skill-format <skill-name>

openspec/
├── project.md              # プロジェクトコンテキスト
├── specs/                  # 累積スペック（マージ済みの正式仕様）
└── changes/                # 変更単位の作業ディレクトリ
    ├── <change-name>/      # アクティブな変更
    │   ├── proposal.md     # /brainstorm で生成
    │   ├── design.md       # /spec で生成
    │   ├── tasks.md        # /spec で生成
    │   └── specs/          # デルタスペック
    └── archive/            # /compound で完了分をアーカイブ

# カスタムコマンドの追加
cat > ~/.claude/commands/my-command.md << 'EOF'
あなたは...
EOF

# カスタムスキルの追加
mkdir -p ~/.claude/skills/my-skill
cat > ~/.claude/skills/my-skill/SKILL.md << 'EOF'
# My Skill
...
EOF

# agents/review/my-reviewer.md
---
name: my-reviewer
description: "このレビュアーの専門領域と検出対象の説明"
model: opus
tools: [Read, Grep, Glob]
skills: [関連ドメインスキル名]
---

# レビュー観点とチェック項目を記述

forge/
├── install.sh / uninstall.sh     # インストーラー
├── CLAUDE.md                      # プロジェクト CLAUDE.md テンプレート
├── USER-CLAUDE.md                 # ユーザー CLAUDE.md テンプレート
├── settings.json                  # Claude Code 設定
│
├── commands/                      # スラッシュコマンド定義
│   ├── brainstorm.md
│   ├── spec.md
│   ├── implement.md
│   ├── review.md
│   ├── test.md
│   ├── compound.md
│   ├── ship.md
│   ├── commit.md
│   ├── handle-pr-review.md
│   └── skill-format.md
│
├── agents/                        # エージェント定義
│   ├── research/                  #   リサーチ（4種）
│   ├── spec/                      #   スペック（2種）
│   ├── orchestration/             #   オーケストレーション（1種）
│   ├── implementation/            #   実装（3種）
│   └── review/                    #   レビュー（カスタムレビュアーを配置）
│
├── skills/                        # スキル定義
│   ├── forge-skill-orchestrator/  #   方法論スキル（SKILL.md のみ）
│   ├── test-driven-development/
│   ├── <domain-skill>/            #   ドメインスキル（3ファイル構成）
│   │   ├── SKILL.md
│   │   ├── design.md
│   │   └── constraints.md
│   └── ...
│
├── rules/                         # 常時読み込みルール
├── reference/                     # オンデマンド参照ルール
├── hooks/                         # フック（自動ガードレール）
├── docs/                          # 複利ドキュメント
└── openspec/                      # OpenSpec 仕様管理