ワークフロー¶
CodexSpecは開発をレビュー可能なチェックポイントに構造化し、各段階で人間による検証を行います。
ワークフロー概要¶
┌──────────────────────────────────────────────────────────────────────────┐
│ CodexSpec 人間-AI協調ワークフロー │
├──────────────────────────────────────────────────────────────────────────┤
│ │
│ 1. Constitution ──► プロジェクト原則を定義 │
│ │ │
│ ▼ │
│ 2. Specify ───────► 対話型Q&Aで要件を明確化 │
│ │ │
│ ▼ │
│ 3. Generate Spec ─► spec.mdドキュメントを作成 │
│ │ ✓ 自動レビュー: review-spec.mdを生成 │
│ ▼ │
│ 4. Spec to Plan ──► 技術計画を作成 │
│ │ ✓ 自動レビュー: review-plan.mdを生成 │
│ ▼ │
│ 5. Plan to Tasks ─► 原子的なタスクを生成 │
│ │ ✓ 自動レビュー: review-tasks.mdを生成 │
│ ▼ │
│ 6. Implement ─────► 条件付きTDDワークフローで実行 │
│ │
└──────────────────────────────────────────────────────────────────────────┘
なぜレビューが重要なのか¶
| レビューなし | レビューあり |
|---|---|
| AIが誤った仮定をする | 人間が早期に誤解を発見 |
| 不完全な要件が伝播する | 実装前にギャップを特定 |
| アーキテクチャが意図から逸脱する | 各段階で整合性を検証 |
| 結果: 手戻り | 結果: 一発で正しく |
自動レビュー¶
各生成コマンドは自動的にレビューを実行します：
/codexspec:generate-spec→ 自動的にreview-specを呼び出し/codexspec:spec-to-plan→ 自動的にreview-planを呼び出し/codexspec:plan-to-tasks→ 自動的にreview-tasksを呼び出し
レビューレポートは成果物と一緒に生成され、問題をすぐに確認できます。
反復品質ループ¶
レビューレポートで問題が見つかった場合、自然言語で修正内容を記述すると、成果物とレポートの両方が更新されます：
┌──────────────────────────────────────────────────────────────────────┐
│ 反復品質ループ │
├──────────────────────────────────────────────────────────────────────┤
│ │
│ 成果物 (spec/plan/tasks.md) │
│ │ │
│ ▼ │
│ 自動レビュー ──────► レビューレポート (review-*.md) │
│ │ │ │
│ │ ▼ │
│ │ 問題が見つかりましたか？ │
│ │ │ │
│ │ ┌─────┴─────┐ │
│ │ │ │ │
│ │ はい いいえ │
│ │ │ │ │
│ │ ▼ ▼ │
│ │ 会話で修正内容 次のステップへ │
│ │ を記述する │
│ │ │ │
│ │ ▼ │
│ │ 同時に更新： │
│ │ • 成果物 (spec/plan/tasks.md) │
│ │ • レビューレポート (review-*.md) │
│ │ │ │
│ └────────────────┘ │
│ (満足するまで繰り返し) │
│ │
│ 手動再レビュー: /codexspec:review-* をいつでも実行で最新分析を取得 │
│ │
└──────────────────────────────────────────────────────────────────────┘
仕組み：
- 自動レビュー: 各生成コマンドが対応するレビューを自動実行
- レビューレポート: 発見された問題を含む
review-*.mdファイルを生成 - 反復的修正: 会話で修正内容を記述すると、成果物とレポートが同時に更新
- 手動再レビュー:
/codexspec:review-spec|plan|tasksをいつでも実行して最新の分析を取得
コアコマンド¶
| 段階 | コマンド | 目的 |
|---|---|---|
| 1 | /codexspec:constitution |
プロジェクト原則を定義 |
| 2 | /codexspec:specify |
要件の対話型Q&A |
| 3 | /codexspec:generate-spec |
仕様書ドキュメントを作成 (★ 自動レビュー) |
| - | /codexspec:review-spec |
自動呼び出し、または手動で再検証 |
| 4 | /codexspec:spec-to-plan |
技術計画を作成 (★ 自動レビュー) |
| - | /codexspec:review-plan |
自動呼び出し、または手動で再検証 |
| 5 | /codexspec:plan-to-tasks |
タスクに分割 (★ 自動レビュー) |
| - | /codexspec:review-tasks |
自動呼び出し、または手動で再検証 |
| 6 | /codexspec:implement-tasks |
実装を実行 |
2フェーズ仕様化¶
specifyとclarifyの違い¶
| 側面 | /codexspec:specify |
/codexspec:clarify |
|---|---|---|
| 目的 | 初期探索 | 反復的精緻化 |
| タイミング | spec.mdが存在しない場合 | spec.mdが存在し、ギャップを埋める必要がある場合 |
| 入力 | 初期アイデア | 既存のspec.md |
| 出力 | なし（対話のみ） | spec.mdを更新 |
条件付きTDD¶
実装は条件付きTDDに従います：
- コードタスク: テストファースト（Red → Green → Verify → Refactor）
- テスト不可能なタスク（ドキュメント、設定）: 直接実装