Skip to content
neℓson

ἓν οἶδα ὅτι οὐδὲν οἶδα

アイデア

エージェントエンジニアリングのデリバリーループ

仕様優先のエージェントデリバリーループは、レビューポイント・検証シグナル・プロダクションの所有権を保持することでスピードを有用に保つ。

これはエージェントを使いながらエンジニアリング判断を手放さないための仕様優先デリバリーループだ。

有用な部分は、エージェントが素早くコードを書けることではない。有用な部分は、リスク・バリデーション・所有権が可視化されたままで、仕事が明確なチェックポイントを通過することだ。

動作ループ

flowchart TD
  A["📝 仕様ドラフト"] --> B["⚖️ 人間レビュー 1 リスクスコープ"]
  B -->|拒否| A
  B -->|承認| C["🌿 仕様ブランチ"]

  C --> D["⚙️ CI ランナー"]
  D --> E["🤖 エージェント実行"]

  E --> F{"🧪 バリデーションチェック"}

  F -->|失敗| G["🔁 自動フィードバックパッチ"]
  G --> D

  F -->|通過| H["📦 Pull Request"]

  H --> I["👨‍💻 人間チェックポイント 2"]
  I -->|変更が必要| G
  I -->|承認| J["🚀 main へマージ"]

  J --> K["📊 マージ後 CI"]

  K --> L{"🚦 プロダクション準備完了"}

  L -->|失敗| M["🧯 ロールバックパッチ"]
  M --> C

  L -->|通過| N["🎯 完了"]

  N -->|次へ| A

  class A,C spec
  class B,I human
  class D ci
  class E agent
  class F,L validation
  class H,J pr
  class K post
  class G,M loop
  class N done

  classDef spec fill:#1e3a8a,stroke:#3b82f6,color:#ffffff
  classDef human fill:#334155,stroke:#94a3b8,color:#ffffff
  classDef ci fill:#581c87,stroke:#a855f7,color:#ffffff
  classDef agent fill:#6b21a8,stroke:#c084fc,color:#ffffff
  classDef validation fill:#92400e,stroke:#f59e0b,color:#ffffff
  classDef pr fill:#065f46,stroke:#10b981,color:#ffffff
  classDef post fill:#7f1d1d,stroke:#f87171,color:#ffffff
  classDef loop fill:#111827,stroke:#9ca3af,color:#ffffff
  classDef done fill:#14532d,stroke:#22c55e,color:#ffffff

最初のレビューが重要な理由

最初の人間チェックポイントはコードレビューではない。リスクスコープのレビューだ。

エージェントが始まる前に、仕様はブラストラジアスを可視化すべきだ:何が変えられるか、何が変えてはいけないか、そして仕事が受け入れ可能であることを証明するチェックは何か。この段階での拒否はまだ実装が生み出されていないので安価だ。

エージェントが入る場所

エージェントの実行は CI の代わりになるのではなく、CI の後ろに立つ。

エージェントはパッチし、再実行し、バリデーションフィードバックに応答できるが、そのループはテスト・型チェック・ビルド出力・レビュー可能な diff によって制約される。これによってスピードが信頼に結びつく。

2 つ目のチェックポイントがある理由

Pull Request チェックポイントは、人間が結果が保守可能かどうかを判断する場所だ。通過するかどうかだけでなく。

変更に調整が必要なら、フィードバックパッチループに戻る。承認されたら main にマージし、マージ後のバリデーションを独立したプロダクション準備ゲートとして使う。

完了は一時的な状態

このループは次の仕様ドラフトに戻ることで終わる。

それが重要なのは、エージェントエンジニアリングが一発生成のイベントではないからだ。レビュー・ロールバック・プロダクションチェックを保持しながらデリバリーを動かし続ける方法だ。それがソフトウェアを信頼できるものに保つ。