belt

Claude Code 用の最小構成オートパイロットプラグイン。

専用エージェントによる分析・設計・実装・QA・レビューを自動で実行します。

インストール

/plugin marketplace add HMasataka/belt
/plugin install belt@belt

マーケットプレイス名・プラグイン名はどちらも belt（.claude-plugin/marketplace.json の name）なので、インストール時の指定は belt@belt です。

使い方

単一タスク

/belt:autopilot <タスクの内容>   # 6 フェーズで実装
/belt:dispatch <タスクの内容>    # executor 実装 + reviewer/ai-antipattern-reviewer の最小レビュー

dispatch は executor 単体の実装に、依頼内容を受け入れ基準とした reviewer + ai-antipattern-reviewer の最小レビューゲートを加えた単発タスク版です（roadmap 非依存）。autopilot のような多段構成は小タスクには重いため実装を 1 段に絞り、品質は後段の 2 レビューで担保します。タスクが大きい場合は executor に渡す前に planner で実装単位へ分解・順序付けしてから流します。

壁打ち・ブレスト

/belt:brainstorm このプロジェクトの名前を考えて

大規模プロジェクト

段階的に要件定義からロードマップ作成、実装まで進めるワークフローです。各ステップの間で人間がレビュー・取捨選択できます。

/belt:spec <プロジェクトの説明>    # 仕様ドラフトを生成 → .belt/spec.draft.md
# spec.draft.md のチェックボックスで採用する要件を選択
/belt:spec-confirm                 # チェック済み要件のみを抽出 → .belt/spec.md
# spec.md の内容を確認
/belt:roadmap                      # ロードマップを生成 → .belt/roadmap.md
# roadmap.md の内容を確認

# --- 実装の進め方は 2 通り ---

# A. マイルストーン単位で進める
/belt:cruise                       # 未完了マイルストーンを順に autopilot 実行

# B. PR 単位（JIT）で進める
/belt:breakdown [v0.X]             # 1マイルストーンを 1 PR 粒度に分解 → .belt/breakdown.md
# breakdown.md の内容を確認
/belt:ship                         # breakdown.md の PR を 1 つずつ autopilot 実行

実装フェーズは 2 通りから選べます。マイルストーンをそのまま流すなら /belt:cruise。マイルストーンが大きい場合は /belt:breakdown で 1 PR で提出して違和感がない粒度に細分化し、/belt:ship で PR を 1 つずつ消化します。

スキル一覧

スキル	説明
`autopilot`	分析・設計・計画・実装・QA・レビューの6フェーズを一括実行
`dispatch`	単発タスクを（大きい場合は planner で計画してから）executor で実装し、reviewer + ai-antipattern-reviewer の最小レビューを通す（roadmap 非依存）
`spec`	要件分析を行い、チェックボックス付き仕様ドラフトを `.belt/spec.draft.md` に出力
`spec-confirm`	`spec.draft.md` のチェック済み要件のみを `.belt/spec.md` に出力
`roadmap`	`spec.md` からマイルストーン付きロードマップを生成
`breakdown`	`roadmap.md` の1マイルストーンを 1 PR 粒度に分解し `.belt/breakdown.md` に出力
`cruise`	`roadmap.md` のマイルストーンを順に autopilot で実行するループ
`ship`	`breakdown.md` の PR を 1 つずつ executor で実装し、reviewer + ai-antipattern-reviewer の最小レビューを通して完了マイルストーンをチェックするループ
`brainstorm`	アイデアを大量に発散させる壁打ち相手。名前決め・機能案など何でも

エージェント一覧

エージェント	モデル	説明
`analyst`	opus	計画前の要件分析コンサルタント
`architect`	opus	戦略的アーキテクチャ分析・デバッグアドバイザー
`planner`	opus	構造化されたヒアリングを通じて実行可能な計画を作成する
`critic`	opus	計画・コードの品質ゲート。徹底的・構造的・多角的レビュー
`executor`	sonnet	タスク実装の専門家。計画に基づきコード変更を正確に実行する
`test-engineer`	sonnet	テスト戦略設計、テスト作成、フレーキーテスト対策
`debugger`	sonnet	根本原因分析、リグレッション分離、ビルドエラー解決
`reviewer`	sonnet	コード品質の体系的レビュー。深刻度付きフィードバック
`security-reviewer`	opus	セキュリティ脆弱性検出。OWASP Top 10、秘密情報、危険なパターン
`scout`	haiku	コードベースの高速偵察・情報収集。後続エージェントの材料を準備

仕組み

autopilot

6フェーズのワークフローを実行します。

要件分析 — Analyst (opus) がギャップ・ガードレール・エッジケースを分析
設計・計画 — Architect → Planner (opus) が実装計画を作成
計画レビュー — Critic (opus) が計画を評価、REJECT 時は最大3回リトライ
実装 — Executor がグループ単位で並列実行 (complexity: high は opus、normal は sonnet)
QA — Test Engineer + ビルド・テスト検証、失敗時は Debugger で最大2回リトライ
レビュー — Reviewer + Security Reviewer (sonnet) が品質・セキュリティをチェック

QA が2回失敗すると Architect が根本原因を診断し Phase 1 からやり直します（全体リトライ最大2回）。

flowchart TD
    Start([autopilot 開始]) --> Resume{state_read}
    Resume -->|新規| Clean[".belt/phases/ クリア"]
    Resume -->|レジューム| Restore["phases/ から復元"]
    Clean --> P1
    Restore --> P1

    P1["Phase 1: Analyst<br>要件分析"] --> P2
    P2["Phase 2: Architect → Planner<br>設計・計画"] --> P3
    P3{"Phase 3: Critic<br>計画レビュー"}
    P3 -->|REJECT| P2R{"リトライ<br>3回目?"}
    P2R -->|No| P2
    P2R -->|Yes| P4
    P3 -->|ACCEPT| P4

    P4["Phase 4: Executor<br>実装 (並列)<br>high→opus / normal→sonnet"]
    P4 --> P5

    P5["Phase 5: QA<br>Test Engineer → Debugger"]
    P5 -->|成功| P6
    P5 -->|失敗| QARetry{"QA リトライ<br>2回目?"}
    QARetry -->|No| P5
    QARetry -->|Yes| Diag["Architect で根本原因診断"]
    Diag --> FullRetry{"全体リトライ<br>2回目?"}
    FullRetry -->|No| P1
    FullRetry -->|Yes| Fail([失敗終了])

    P6{"Phase 6: Review<br>Reviewer + Security<br>(並列)"}
    P6 -->|CRITICAL/HIGH| P4R{"リトライ<br>3回目?"}
    P4R -->|No| P4
    P4R -->|Yes| Done
    P6 -->|OK| Done([完了])

spec → spec-confirm → roadmap → 実装（cruise / breakdown+ship）

大規模タスクを段階的に進めるワークフローです。各スキルの間に人間のレビューポイントがあります。

spec — Analyst と Architect が要件を分析、AskUserQuestion で深掘り、チェックボックス付き仕様ドラフトを .belt/spec.draft.md に出力
人間のレビュー — spec.draft.md のチェックボックスで採用する要件を選択
spec-confirm — spec.draft.md に残る Open Questions を AskUserQuestion で解消して要件に反映したうえで、チェック済み要件のみを抽出し、チェックボックスなしの仕様ドキュメントを .belt/spec.md に出力
人間のレビュー — spec.md の内容を確認
roadmap — spec.md の全要件から Architect が設計、Planner がマイルストーンに分解、Critic がレビュー、.belt/roadmap.md に出力
人間のレビュー — roadmap.md の内容を確認
実装 — 2 通りの進め方から選ぶ:
- cruise（マイルストーン単位） — roadmap.md の未完了マイルストーンを順に autopilot で実行。中断後も /belt:cruise で再開可能
- breakdown + ship（PR 単位 / JIT） — breakdown で指定マイルストーン（省略時は最初の未完了）を Planner+Critic で 1 PR 粒度に分解し .belt/breakdown.md に出力 → 人間がレビュー → ship で PR を 1 つずつ executor で実装し、reviewer + ai-antipattern-reviewer の最小レビュー（受け入れ基準の充足・統合の破綻を確認）を通してから checkoff（完了で breakdown.md のチェック更新、全 PR 完了で roadmap.md のマイルストーンを一括チェック + breakdown.md 削除）。1 マイルストーンずつ分解→消化を繰り返す

flowchart TD
    subgraph spec ["/spec"]
        S1["Analyst<br>要件分析"] --> S2["Architect<br>技術調査"]
        S2 --> S3["AskUserQuestion<br>深掘り・提案"]
        S3 --> S4["仕様ドラフト生成<br>.belt/spec.draft.md"]
    end

    S4 --> Human1{{"人間がレビュー<br>チェックボックスで<br>要件を選択"}}

    subgraph specConfirm ["/spec-confirm"]
        SC0["spec.draft.md 読み込み"]
        SC0 --> SC1{"Open Questions<br>あり?"}
        SC1 -->|Yes| SC1a["AskUserQuestion で解消<br>結論を要件に反映<br>spec.draft.md 更新"]
        SC1a --> SC1
        SC1 -->|No| SC2["チェック済み項目を抽出<br>spec.md 生成<br>.belt/spec.md"]
    end

    Human1 --> SC0
    SC2 --> Human1b{{"人間がレビュー<br>spec.md を確認"}}

    subgraph roadmap ["/roadmap"]
        R1["spec.md 読み込み<br>全要件を抽出"]
        R1 --> R2["Architect<br>アーキテクチャ設計"]
        R2 --> R3["Planner<br>マイルストーン分解"]
        R3 --> R4{"Critic<br>レビュー"}
        R4 -->|REJECT| R3R{"リトライ<br>3回目?"}
        R3R -->|No| R3
        R3R -->|Yes| R5
        R4 -->|ACCEPT| R5["ロードマップ生成<br>.belt/roadmap.md"]
    end

    Human1b --> R1

    R5 --> Human2{{"人間がレビュー<br>内容を確認"}}

    subgraph breakdown ["/breakdown (任意)"]
        B1["対象マイルストーン特定<br>(引数 or 最初の未完了)"]
        B1 --> B2["Planner<br>1 PR 粒度に分解"]
        B2 --> B3{"Critic<br>レビュー"}
        B3 -->|REJECT| B2R{"リトライ<br>3回目?"}
        B2R -->|No| B2
        B2R -->|Yes| B4
        B3 -->|ACCEPT| B4["breakdown 生成<br>.belt/breakdown.md"]
    end

    Human2 -->|マイルストーン単位| C1
    Human2 -->|PR 単位| B1
    B4 --> Human3{{"人間がレビュー<br>PR 分解を確認"}}
    Human3 --> SH1

    subgraph cruise ["/cruise（マイルストーン単位）"]
        C1["roadmap.md 読み込み"]
        C1 --> C2{"未完了マイルストーン<br>あり?"}
        C2 -->|Yes| C3["autopilot 実行<br>(マイルストーン単位)"]
        C3 --> C4["roadmap.md<br>チェック更新"]
        C4 --> C2
        C2 -->|No| C5([cruise 完了])
    end

    subgraph ship ["/ship（PR 単位）"]
        SH1["breakdown.md 読み込み"]
        SH1 --> SP1{"未チェック PR<br>あり?"}
        SP1 -->|Yes| SP2["executor 実装<br>(PR 単位)"]
        SP2 --> SPR{"reviewer +<br>ai-antipattern-reviewer<br>最小レビュー"}
        SPR -->|REQUEST_CHANGES| SPRR{"リトライ<br>2回目?"}
        SPRR -->|No| SP2
        SPRR -->|Yes| SPE([未解決指摘を報告し終了])
        SPR -->|APPROVE / COMMENT| SP3["breakdown.md<br>チェック更新"]
        SP3 --> SP1
        SP1 -->|No| SP4["roadmap.md の<br>マイルストーンを一括チェック<br>+ breakdown.md 削除"]
        SP4 --> SMS([次の breakdown を促し終了])
    end

MCP サーバーで状態を永続化するため、中断したワークフローを再開できます。

アンインストール

/plugin uninstall belt@belt
/plugin marketplace remove belt

Name		Name	Last commit message	Last commit date
.claude-plugin		.claude-plugin
agents		agents
hooks		hooks
scripts		scripts
skills		skills
.gitignore		.gitignore
.markdownlint.json		.markdownlint.json
.mcp.json		.mcp.json
CLAUDE.md		CLAUDE.md
README.md		README.md
package.json		package.json
pnpm-lock.yaml		pnpm-lock.yaml

Navigation Menu

Repository files navigation

belt

インストール

使い方

単一タスク

壁打ち・ブレスト

大規模プロジェクト

スキル一覧

エージェント一覧

仕組み

autopilot

spec → spec-confirm → roadmap → 実装（cruise / breakdown+ship）

アンインストール

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

belt

インストール

使い方

単一タスク

壁打ち・ブレスト

大規模プロジェクト

スキル一覧

エージェント一覧

仕組み

autopilot

spec → spec-confirm → roadmap → 実装（cruise / breakdown+ship）

アンインストール

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages