読み込み中

何が変わり、どこから始めるか

レッスン 13 分

組織は1年前には考えられなかったスピードでAIを使ってコードを書くようになりましたが、コードを取り巻くプロセスは同じペースでは変化していません。

ソフトウェア開発ライフサイクル(SDLC)とは、ソフトウェアをアイデアから本番稼働まで導くプロセスです。ほとんどの組織は、計画、設計、構築、テスト、デプロイ、保守という同じ6つの段階の何らかのバージョンを実行しています。

変化の内容

以下の表は、従来のSDLCとClaudeに支えられたAIネイティブSDLCというスペクトルの両端を示しています。ほとんどの組織は、この2つの列の間のどこかに位置しています。

段階従来のSDLCAIネイティブSDLC
計画要件は委員会によって収集され、ワークショップと承認を経て抽出され、手作業で文書化されるClaudeがソースから直接ペインポイントを統合し、それを intent.md として記録する。これは人間が読め、かつ機械が実行可能なファイルである
設計仕様はアナリストによって書かれ、デザイナーによって解釈される要件と設計は、エージェントとの1回の作業セッションに圧縮され、Skillsとしてコード化され、Gitでバージョン管理された標準によって導かれる
構築テストとコードは手書きされ、ドキュメントは主な開発作業の後に書かれるテストとコードはAIによって生成され、組織の知識はバージョン管理された機械可読な CLAUDE.md ファイルとSkillsとして維持される
テスト段階の境界でのQAゲート実装全体に織り込まれた継続的なeval
デプロイ人間がコードの1行1行をレビューし、ガバナンスはレビューサイクルの中で、しばしば一貫性を欠いた形で行われる規制対象・重要コードに人間のレビューを限定し、エージェントによるレビューを何層にも重ねる。ガバナンスはAIが行動する際に強制され、フックが承認ゲートとして機能する
保守人間が本番環境のバグを監視するエージェントが稼働中のデプロイを監視する。制御帯域を逸脱した場合は診断され、新しい intent.md としてループに書き戻される

判断を要するすべての意思決定について、責任は人間に残り続けます。

この表に出てくる2つの用語は、全体を通して登場します。intent.md は、何が望まれているか、なぜそれが望まれているか、どのような制約の下にあるかを記した、短くバージョン管理されたファイルです。制御帯域とは、本番環境の指標の通常レベルを取り巻く範囲のことです。

プレイの仕組み

プレイはプレイブックの中核であり、6つの非線形な段階(計画、設計、構築、テスト、デプロイ、保守)にグループ化されており、これらが合わさってライフサイクル全体をカバーします。

各プレイは以下をカバーします。

  • 何が変わるか
  • 使い始め方
  • 実装のための具体的な手順
  • ガバナンス上の考慮事項
  • 効果を測定する方法

各プレイは「前提条件」の下にその依存関係を明記しており、これは依存関係グラフによってさらに示されています。

5行にまたがる12のプレイの依存関係グラフ。1行目、前提条件なし:意図の取得、CLAUDE.md、Skills、フィードバックループ、フック、プランモード。2行目:サブエージェント(CLAUDE.mdが必要、フィードバックループがあると役立つ)、eval(CLAUDE.mdとフィードバックループが必要)。3行目:要件と設計(意図の取得とSkillsが必要)、PRレビュー(evalとサブエージェントが必要、Skillsがあると役立つ)。4行目:CI/CD(PRレビューとフックが必要)。5行目:ループを閉じる(CI/CDと意図の取得が必要)。CLAUDE.mdはSkillsに役立つが必須ではない。

プレイの依存関係グラフ。最上段のプレイには前提条件がない。実線の矢印はそれを基盤として発展するプレイを指し、点線の矢印は役立つが必須ではないことを意味する。

最初のプレイを選ぶ

プレイはモジュール式であり、組織は自らの固有のニーズに基づいて、異なる段階の変革を異なる時期に優先するよう選択できます。

上記グラフの最上段にある6つのプレイには、前提条件がありません。

  • 計画:intent.mdとして取得する
  • 構築:デフォルトの開始点としてのClaude Codeプランモード
  • 構築:CLAUDE.md
  • 構築:組織の知識としてのSkills
  • テスト:Claudeにフィードバックループを与える
  • デプロイ:承認ゲートとしてのフック

迷ったら、CLAUDE.mdから始めてください。これにはリポジトリ、Claude Code、そしてコードベースを熟知したエンジニアが1人必要であり、サブエージェントとevalのプレイはこれを基盤として発展します。