コンテンツにスキップ

実装と検証(反復構築)

← 反復構築 のワークフロー(第2階層)へ戻る

AI が実装・テスト生成し、CI 通過後に開発者が挙動を検証して理解を記録する

担当ロールAIエージェント、開発者(検証者)
インプット実装計画(タスク分解)
アウトプット検証済みインクリメント(コード+テスト)

タスク(第3階層)

  1. AI がコードとテストを生成する — 承認済みの実装計画からタスクを1つ選び、feature/<機能ID>-task-<N> ブランチを切って AI に実装とテストを生成させる(ブランチ命名・保護はフェーズ5「Git 戦略」に従う)。コミットには Spec: / ADR: トレーラで仕様・判断記録への参照を付ける。タスク完了時点で PR を作成し(自律度 L1〜L2 では人が gh pr create を実行、L3 では AI が作成し人へ通知)、PR 本文に対応タスクと検証方法を書く
  2. 自動検証(テスト・静的解析・脆弱性)を通過させる — PR の必須ステータスチェック(テスト・静的解析・脆弱性スキャン。フェーズ5「CI ゲート」の gate-g5)がすべて GREEN になるまで修正を繰り返す。失敗は AI に修正させてよいが、基準値そのものの変更(カバレッジ引き下げ等)は CI 設定変更の PR として分離し、技術判断者の承認を必要とする。RED のままのマージはブランチ保護で物理的に不可
  3. 開発者が挙動を実際に確認し、自分の言葉で説明できる状態にする — 開発者が PR の挙動をローカルまたはプレビュー環境で実際に動かして確認し、「何をどう変えたか・なぜ動くか」を自分の言葉で PR 本文へ記録する(AI の説明の転記は不可)。説明できない差分が残っている場合は、理解できるまで AI に質問するか、差分を小さくやり直させる。この記録が独立レビューのインプットになる

実装リファレンス

この作業の具体的なやり方・様式は次のページで定義しています。