学習パス 04レッスン 1 / 10

ソフトウェアのライフサイクル全体をつなぐ

利用者の要求から運用、フィードバックまで、一つの機能を追います。コード生成だけでは決められない判断を特定します。

基礎10 分レビュー日

発行元 執筆方針

理解度を確認エージェントがPRを作成し、テストが成功しました。どの結論が妥当ですか?演習に取り組む
エージェントがPRを作成し、テストが成功しました。どの結論が妥当ですか?

学べること

  • 実装の前後に必要な主な判断を説明します。
  • 要件を検証と運用の証拠に結び付けます。
  • コーディングツールと、ソフトウェア提供のためのシステムを区別します。

一つの機能をシステム全体で追う

コーディング支援ツールは、実装を作る助けになります。ソフトウェアを提供するためのシステムには、何を作るかの決定、結果の検証、リリース、利用の支援も必要です。AIはこれらを支援できますが、判断がなくなるわけではありません。

マネージャーが顧客エクスポートを求める、架空の依頼を考えます。最初に役立つ問いは、なぜエクスポートが必要かです。定期レポートなら、データを開示する範囲を小さくして要求を満たせるかもしれません。早い段階で機能名をそのまま受け入れると、不要な作業が生じる可能性があります。

次は境界を確認します。どの利用者が、どのレコードをエクスポートできますか?どのフィールドが必要ですか?ファイルはどこへ送られますか?これらの判断が、実装と重要な確認を形作ります。

段階間で証拠を保つ

前の段階についての説明が不完全なまま次へ進むと、ライフサイクルの信頼性が下がります。チケットに「エクスポートを追加」とだけ書かれ、PRでエンドポイントが追加され、運用担当者には責任者不明のサービスが渡される、といった状態です。

段階間のつながりを明示します。

段階次の判断を支える証拠
要求の理解明示された利用者、問題、成功条件
動作の仕様化許可する操作、境界、受入基準
実装要件に結び付いた、レビュー可能な変更
検証実際のバージョンに対する関連確認と独立したレビュー
リリース受け入れた成果物、対象環境、復旧方法
運用サービスのシグナル、インシデント責任者、保守プロセス
学習利用者のフィードバックと観察した成果

この表は、実践的な学習用モデルです。組織によって段階の名前を変えたり、活動をまとめたりできます。ワークフローを高度に自動化しても、判断は残してください。

要求に合う検証を保つ

エクスポートでは、ファイルのダウンロード成功が一つの確認になります。別の確認では、マネージャーが他の組織のレコードをエクスポートできないか調べます。さらに、必要なフィールドの組み合わせを確認します。それぞれ異なる要件を扱っています。

テストのバッジが緑だからといって、広い範囲の安全性を推測してはいけません。何を確認し、何が未検証かを特定します。NISTのSSDFは、安全な開発を、最後の一回のスキャンではなく、ライフサイクル全体の実践として説明しています。フレームワークを確認してください。

リリースの判断では、デプロイするバージョンの証拠を使います。レビュー後にコードが変わったら、どの確認と判断をやり直すかを決めます。提供プロセスで、この対応関係を明示してください。

最初の設計に運用を含める

エクスポートの失敗、異常なリクエストパターン、許容できない応答時間を、サービス責任者がどう検出するか決めます。デバッグに便利だからという理由で、エクスポートした顧客データをログに記録しないでください。

監視は、責任者が行動する助けになる必要があります。GoogleのSREガイドは、サービスに表れる症状と内部の原因を区別し、有用なシグナルの重要性を説明しています。監視のガイドを参照してください。

インシデントの前に復旧を計画します。誰が機能を停止し、サービスを復旧し、影響を伝えられるかを特定します。デプロイの完了は、これらの責任へ移る地点です。

フィードバックを次の判断に使う

リリース後は、マネージャーがエクスポートを使っているか、元の問題を解決しているかを確認します。インシデント、サポートへの質問、保守工数をレビューします。重要な知見を、要件の更新や作業に変えます。

このつながりが、ライフサイクル全体を扱うソフトウェアファクトリーと、コード生成ツールの集合との違いです。一連の段階を通じて、意図と証拠を保てるか評価します。ライフサイクル演習で、各判断を確認してください。

演習に取り組む

ライフサイクル演習で、顧客エクスポートを確認してください。各段階の責任者、証拠、判断を示します。自分の組織で、現在コンテキストが失われる引き継ぎを一つ見つけます。その情報を保つための最小限の変更を記述します。

ワークシートをダウンロード(Markdown)
理解度を確認 ↑

学習を続ける

出典と参考資料

Taigaの関連資料