ai-dev-loop

AI 開発ループ

複数の AI プラットフォームにまたがる、QA ゲート付きの自律的なタスク実行です。

概要

AI 開発ループでは、次のような機能開発を完全に自律して実行できます。

• AI エージェントがキューからタスクを取得して実装します
• QA のみを行います（Testing 列で承認または却下します）
• 複数のプラットフォーム（Claude CLI、Cursor、Codex）が並行して作業できます
• プラットフォームを切り替えてレート制限を最大限に活用します

アーキテクチャ

┌─────────────┐     ┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│   BACKLOG   │────▶│   TO DO     │────▶│  TESTING    │────▶│    DONE     │
│             │     │             │     │             │     │             │
│  PRDs ready │     │ Agent picks │     │ YOU review  │     │  Shipped    │
│             │     │ & builds    │     │ & approve   │     │             │
└─────────────┘     └─────────────┘     └─────────────┘     └─────────────┘
                          │                   │
                    ┌─────┴─────┐       ┌─────┴─────┐
                    │  Claude   │       │  Reject   │
                    │  Cursor   │       │  → To Do  │
                    │  Codex    │       └───────────┘
                    └───────────┘

タスクのライフサイクル

1. タスクの作成

タスクは、構造化メタデータとともに .agents/TASKS/[task-name].md に保存します。

## Task: [Feature Name]

**ID:** feature-name-slug
**Status:** Backlog | To Do | Testing | Done
**Priority:** High | Medium | Low
**PRD:** [Link](../PRDS/prd-file.md)

### Agent Metadata

**Claimed-By:** [platform-session-id]
**Claimed-At:** [timestamp]
**Completed-At:** [timestamp]

### Progress

**Agent-Notes:** [real-time updates]
**QA-Checklist:**

- [ ] Code compiles/lints
- [ ] Tests pass (CI)
- [ ] User acceptance
- [ ] Visual review

### Rejection History

**Rejection-Count:** 0
**Rejections:** [list of rejection notes]

2. タスクの取得

エージェントが /loop を実行すると、次の処理を行います。

1. .agents/TASKS/ をスキャンして Status: To Do のタスクを探します
2. 優先度順に並べ替えます（High > Medium > Low）
3. 有効な取得済みタスク（30 分未満）をスキップします
4. タスクの Claimed-By と Claimed-At を更新します

3. 実装

エージェントはタスクに取り組みます。

1. タスクファイルとリンクされた PRD を読みます
2. .agents/SESSIONS/ で関連する過去の作業を確認します
3. 機能または修正を実装します
4. 進捗に合わせて Agent-Notes を更新します
5. ブランチを作成してコミットします

4. 品質チェック

Testing に移す前に、次の処理を行います。

1. qa-reviewer スキルを実行します
2. QA-Checklist の項目を更新します
3. コードがコンパイルおよび lint を通過することを確認します

5. 完了

エージェントは次の処理を行います。

1. Status: Testing に設定します
2. Completed-At のタイムスタンプを設定します
3. 最終的な概要を Agent-Notes に追加します
4. 次のアクションを促します

6. QA ゲート（ユーザーの作業）

Kaiban.md で次の操作を行います。

1. Testing 列を確認します
2. タスクをクリックして PRD のプレビューを表示します
3. リンクされた PR を確認します
4. 承認：Done にドラッグします
5. 却下：却下をクリックし、メモを追加します → To Do に戻ります

7. 却下への対応

却下されると、次の処理が行われます。

1. ステータスが To Do に戻ります
2. Rejection-Count が増加します
3. 却下メモが履歴に追加されます
4. 次の /loop で完全なコンテキストとともにタスクが取得されます

マルチプラットフォーム戦略

プラットフォームの強み

プラットフォーム	最適な用途
Claude CLI	複雑なロジック、バックエンド、アーキテクチャ
Cursor	UI コンポーネント、スタイリング、ビジュアル作業
Codex	大規模なリファクタリング、移行、ドキュメント

並行実行

複数のプラットフォームが同時に作業できます。

• それぞれが異なるタスクを取得します
• 取得によって競合を防ぎます（30 分のロック）
• タスクファイルを介して状態を共有します

レート制限への対応

レート制限に達した場合、次の処理を行います。

1. エージェントが進捗を Agent-Notes に保存します
2. 取得を解放します（Claimed-By をクリアします）
3. プラットフォームの切り替えを提案します
4. ユーザーが別のプラットフォームで作業を続けます

日々のワークフロー

朝の QA セッション

1. VS Code で Kaiban.md 拡張機能を開きます
2. Testing 列を確認します
3. 良好な作業を承認して Done に移します
4. メモを付けて却下し、To Do に戻します

1 日を通して

# Claude CLI
claude
> /loop   # Process task
> /loop   # Next task
# Rate limited? Switch to Cursor

レート制限への対策

Claude limit? → Switch to Cursor
Cursor limit? → Switch to Codex
All limited? → QA time (review Testing)

統合ポイント

Kaiban.md 拡張機能

• .agents/TASKS/ 用のビジュアルなカンバンボード
• ドラッグ＆ドロップによるステータス変更
• PRD プレビューパネル
• メモ入力欄付きの却下ボタン
• エージェントの取得ステータスバッジ

既存のスキル

• qa-reviewer：6 段階の品質検証
• session-documenter：完了した作業を自動でドキュメント化
• rules-capture：却下のフィードバックから学習

Git ワークフロー

• タスクごとにブランチを作成します：feature/[task-id]
• 明確なメッセージでコミットします
• PR をタスクファイルにリンクします

デーモンではありません

重要：/loop はバックグラウンドプロセスではありません。

• 1 回の実行で処理するタスクは 1 つです
• ユーザーに制御を返します
• 続行するか停止するかはユーザーが決めます
• 「バックグラウンドプロセスを決して実行しない」というルールを遵守します

取得の有効期限

取得は 30 分後に期限切れになります。

• エージェントのクラッシュに対応します
• レート制限による中断に対応します
• 以前の Agent-Notes が再開時のコンテキストになります
• 複数プラットフォーム間の引き継ぎが可能になります

ベストプラクティス

タスクを作成する場合

• 明確で実行可能なタスクの説明を書きます
• 要件を示す PRD にリンクします
• 適切な優先度を設定します
• テスト基準を含めます

エージェント向け

• 作業を始める前にタスクと PRD を十分に読みます
• Agent-Notes を定期的に更新します
• 完了前に qa-reviewer を実行します
• 整理され、焦点の明確なコミットを作成します

QA 担当者向け

• 実装と合わせて PRD を確認します
• 具体的な却下理由をフィードバックします
• 段階的に承認します（一括で承認しないでください）
• Testing 列は短く保ちます