プルリクエストを作成する前に
- ビルドエラーがゼロであること。
- TODOやFIXMEのマーカーが残っていないこと。
- コードベースが認可とレート制限を使っている箇所では、エンドポイントにそれらが備わっていること。
- 重大度の高いセキュリティ指摘がないこと。
私たちの提供ライフサイクルは、13のフェーズにわたって連携するAIエージェントのシステムの上で動いています。構想策定から継続的改善まで一貫しています。すべての計画とすべてのマージを、シニアエンジニアが承認します。これは私たちがお客様向けに構築するのと同じエージェント型システムです。このページでは、各フェーズで何が起こり、何をご確認いただき、何をご承認いただくのかを説明します。
何よりもまず、ビジネスの背景、関係者、制約を理解します。
成果物:ビジネス上の課題を平易な言葉で書き起こしたもの。以降のすべてのフェーズが計画の拠り所とするインプットです。
現在の業務プロセスをマッピングし、ソフトウェア(およびAI)が経済性をどう変えるかを定量化します。
成果物:その要件の分析。設計はこれをもとに組み立てられます。
目標を、テスト可能で優先順位付けされた要件へと落とし込みます:AI支援、人間による承認。
成果物:テスト可能で優先順位付けされた要件。ゲート:設計開始前にお客様が承認します。
構築開始前に、スコープ、マイルストーン、要員配置、リスク登録簿を合意します。
成果物:依存関係の順に並べた書面の計画。ゲート:どのビルドタスクも、開始前にエンジニアがこの計画を承認します。
実際のワークフローを軸に設計されたインターフェースを、プロトタイプで検証します。
成果物:検証済みのプロトタイプ。新しいWebサイトでは、10案のホームページデザインを1つの比較ページに並べ、お客様が1つを選びます。
今日のトラフィックだけでなく、想定される負荷と成長に照らして検証したアーキテクチャ。
成果物:システム設計。ゲート:開発前にお客様がアーキテクチャを承認し、マージ前にはレビュアーが各設計判断に反論します。
シニアエンジニアが、必須のコードレビューを伴うAI支援の短いサイクルでリリースします。
成果物:タスクごとに構築したコード。ゲート:各タスクの後にビルドチェックを行い、結果を計画と突き合わせます。
AIが生成したテストスイートをエンジニアがレビューし、マージのたびに回帰テストを実行します。
成果物:受け入れ基準から書き起こしたQAシナリオ(異常系を含む)。ゲート:修正は実際のブラウザと実際のAPI呼び出しで検証します。
手動での探索的テストと、マイルストーンごとの受け入れ基準の承認。
ゲート:2名の独立したレビュアー、続いて3名のレビュアーによるガバナンスレビュー。重大度の高い指摘があるとプルリクエストは作成できません。
ロールバック計画を標準とした、自動化され再現可能なリリース。
成果物:変更ごとのバージョン更新、変更履歴(changelog)への記載、リリースタグ。ゲート:エラーがあるとデプロイはブロックされます。
本番稼働初日からのオブザーバビリティとアラート。
ゲート:修正は本番環境の外で検証し、本番環境に対しては決して行いません。
定められたペースでのパッチ適用、依存関係の更新、パフォーマンス管理。
成果物:コードに紐づいたドキュメント。コードが変更されると、エンジニアが再検証するまでそのページは古い状態として扱われます。
本番環境のテレメトリがロードマップに反映される。このライフサイクルに本当の終わりはありません。
成果物:人が承認するルールとして書き残した教訓。対象はエンジニア1人、1つのコードベース、または会社全体です。
13のフェーズは何が起こるかを示します。ここでは、その中の一つひとつの変更が、お客様のコードベースに届く前にどう計画され、構築され、確認されるかを示します。すべてのステップはシニアエンジニアが進め、AIツールはそのために働きます。
あるプロジェクトから得た学びは、次のプロジェクトを導くルールとして書き残されます。レベルはエンジニア1人、1つのコードベース、会社全体の3つです。すべてのルールは、書き込まれる前に人が承認します。
各コードベースには、記述対象のコードに紐づいたドキュメントが用意されます。そのコードが変わるとページには「古い」というフラグが付き、コードを読み直して再検証しない限り最新の状態には戻りません。エンジニアはファイルを開くと関連するページを目にします。
上記のデリバリーループは、AnthropicのコーディングエージェントであるClaude Codeの中で動いています。以下の各項目はAnthropic自身のドキュメントにリンクしているので、その機能が何をするのかを確かめられます。作業を止めるチェックはいくつかだけで、残りは助言にとどまり、判断はエンジニアが下します。
Claude Codeが決められたタイミングで実行するスクリプトです。私たちのフックのうち5つは作業を止めます。貼り付けられた認証情報、承認済みの計画が保存される前の編集、コマンド内の既知のシークレット、監査エラーのあるデプロイ、そしてあふれたコンテキストです。残りは助言です。Anthropicのフックに関するドキュメント
Claude Codeは計画を提案し、エンジニアが承認するまで何も変更しません。その後、計画が保存されるまでフックが最初の編集を保留するため、作業は承認された計画に照らして確認されます。プランモードのドキュメント
19のスキルと46のスラッシュコマンドに、計画、レビュー、セキュリティテスト、デプロイの手順をまとめています。一度書いて再利用するものです。これらは作業を導くもので、強制するものではありません。スキルのドキュメント
レビュアーは新しいコンテキストを持つ別のエージェントとして動き、並行する変更はリポジトリの隔離されたコピーで構築されます。レビュアーは指摘を報告し、判断はエンジニアが下します。サブエージェントのドキュメント
ブラウザテスト、ドキュメント検索、コードベースのマップがツールとして接続されており、Anthropic自身のマーケットプレイスのプラグインも併用しています。MCPのドキュメント
チームのルールは、各セッションにコンテキストとして読み込まれます。Anthropicのドキュメントはこれを強制ではなくコンテキストと説明しているため、必ず守るべきルールには代わりに専用のフックを用意します。メモリのドキュメント
どのチェックがブロックするのか、失敗したら何が起こるのか、Claude Codeを扱う代理店に何を尋ねるべきか:詳しい解説を読む。ClaudeおよびClaude CodeはAnthropic, PBCの商標です。当社は独立した企業であり、Anthropicと提携しておらず、その承認も受けていません。
はい。すべての案件が同じ13フェーズのフレームワークに沿って進み、規模に合わせて調整されます。順序は固定で、黙って省略されることはありません。変わるのはフェーズ内の作業量です。
専門化されたAIエージェントのシステムが各フェーズ内で機能します。要件の起草、コードの生成とレビュー、テストの作成、本番環境の監視です。エージェントが生み出す成果は、各ステップでシニアエンジニアが確認し承認します。
各フェーズの区切りで承認いただきます。設計開始前に要件を、開発開始前にシステムアーキテクチャを、各マイルストーンで動作するデモを確認いただきます。
はい。既存システムの作業はアーキテクチャレビューとデリバリー監査から始めます。残るフェーズを推測ではなく文書化された基準の上で進めるためです。
軽微でない変更はすべて、2名の独立したレビュアーが互いの判定を見ずに確認し、両者の承認が必要です。続いてガバナンスレビューがセキュリティ、アーキテクチャ、コードベース固有の規約を確認し、重大度の高い指摘が残ったままプルリクエストが作成されることはありません。すべての計画とすべてのマージをシニアエンジニアが承認します。
はい。お客様の認証情報はエンジニアのマシン上の保管庫に置き、リポジトリには決して置きません。私たちのAIツールはシークレットの名前だけを扱い、その値を見ることはありません。出力はマスクされ、チャットに貼り付けられたシークレットはAIに届く前にブロックされます。