cdkconf2026_iidaxs

Transcript

1. あなたのCDKコード、AIに任せて大丈夫ですか？ プロンプトではなく構造で品質を担保する話 2026.07.18 株式会社HBA 飯田壮一
2. 本日の内容 ― CDKにおけるハーネスについて ハーネスエンジニアリング AIが「正しく動き続ける環境」を設計する ― 明日から使えそうな実践知 ― タイトルの問いに対する今の私のアンサー コンテキストエンジニアリング AIに「いつ何を見せるか」を設計する ※開発ツールはKiro前提 プロンプトエンジニアリング AIに「どう聞くか」を設計する
3. 自己紹介 • 所属：株式会社HBA • 名前：飯田 壮一 • CDK歴：１年未満の初心者 • 好きなサービス：Amazon Bedrock AgentCore • 座右の銘（?）：登壇駆動学習（為さねば成らぬの精神）
4. 01 ― Intro：Harness 4 Quadrants 01 導入：ハーネスを整理する4象限 ハーネスの全体像を「Agency Control」×「Guides Sensors」の4象限で整理します。
5. 01 ― Intro：Harness 4 Quadrants ハーネスの構成要素 構成要素 用途 補足 AGENTS.md プロジェクト全体の指示書 セッションが開始されるたびに必ず読まれる Steering パス別のコーディング規約、守るべきルール Skills 再利用可能なワークフロー（手順書） Agents ドメイン特化の専門エージェント Hooks イベント駆動の自動実行 Memory エージェントの行動履歴 例：PreToolUse／PostToolUse／AgentStop
6. 01 ― Intro：Harness 4 Quadrants ハーネスを整理する4象限 ハーネスの設計パターンは2軸、4象限で整理できます Guides（知識の事前注入） 能力の事前拡張 方針・規約の事前注入 Agency（能力拡張） Control（制御・検証） 実行時フィードバック Sensor（実行時の検知） 結果の検証・観測
7. 02 ― Practice：Harness for AWS CDK 02 実践：CDKにおけるハーネス実装例 CDKにおけるハーネス実装例として、 Kiro Powers ／ TDD Guide ／ Quality Gate ／ Retrospective を紹介します。
8. 02 ― Practice：Harness for AWS CDK ハーネスの全体像 Guides（知識の事前注入） 能力の事前拡張 方針・規約の事前注入 Kiro Powers TDD Guide Agency（能力拡張） Control（制御・検証） 実行時フィードバック 結果の検証・観測 Retrospective Quality Gate Sensor（実行時の検知） すべての象限をバランスよく設計することが大事
9. 02 ― Practice：Harness for AWS CDK Kiro Powers / Quality Gate Agency × Guide Control × Sensors Kiro Powers Quality Gate Build AWS infrastructure with CDK and Cloud Formation Hooksによる確実な検証で水際対策 • 最新ドキュメント、コードサンプル検索 • Format / Lint / 型チェック • ベストプラクティス適用 • cdk-nag によるセキュリティ検証 • テンプレート検証、トラブルシューティング • synth によるテンプレート生成確認 • 内部的にawslabs.aws-iac-mcp-server連携 • 失敗したら自己修復
10. 02 ― Practice：Harness for AWS CDK Appendix. cdk-nag v3 cdk-nag v3がリリースされ、登録方法や抑制の書き方が大きく変わりました。 現状のaws-iac-mcp-serverはv2の書き方を返してくるので、v3を利用する場合はエージェントに教える必要がある。 https://github.com/cdklabs/cdk-nag/blob/main/MIGRATION.md
11. 02 ― Practice：Harness for AWS CDK TDD Guide Control × Sensors TDD Guide TDDでAIの自由度を制約する • テスト駆動とHITL（人間レビュー）で曖昧さを検証可能にする • 「文法は正しいが意図と違う」というCDK特有の問題に直接効く • KiroのSpec駆動との相性が良い
12. 02 ― Practice：Harness for AWS CDK Appendix. cdk-skills https://github.com/go-to-k/cdk-skills
13. 02 ― Practice：Harness for AWS CDK Retrospective Agency × Sensors Retrospective 検知した学びを、次の能力へ 過去の SESSION_LOG.md／ ADRを検索 今回のセッションで 発生した問題を分析 再発パターンを検出 steering更新を提案 ／ADR・ログに記録
14. 03 ― Summary 03 まとめ まとめとして、全体のファイル構成例と、実行の流れを紹介します。
15. 03 ― Summary ファイル構成例 ＜ワークスペース＞ ＜グローバル＞ アーキテクチャ決定レコード格納（WHY, WHY NOT） Kiro Powers ファイル書き込み後に Format/Lint/型チェック を自動実行 手動トリガーで全品質チェックを実行 セッション終了時に振り返り分析（セッションログ、ADR記録） lib/ 書き込み前にテスト先行を強制 test/ 書き込み前にCDK単体テストスキルのアクティベート test/ 書き込み後にテスト仕様の HITL レビューを要求 セッションログ CDK単体テストスキル スキル本体: 判断フロー・3種テストの使い分けガイドライン メインルール: TDD開発フロー・禁止事項・品質ルール
16. 03 ― Summary 実行の流れ① テスト失敗（RED）を確認 CDK単体テストスキルをアクティブ化 テスト実装後に Format/Lint/型チェック Kiro Powerをアクティブ化 Kiro Powerを使って設計 ・ドキュメント検索 ・サンプルコード検索 ・ベストプラクティス取得 テスト仕様のレビュー承認依頼 テスト駆動で開始 ①RED: テストを先に実装する ②HITL: テスト仕様の人間レビュー ③GREEN: 実装してテストする
17. 03 ― Summary 実行の流れ② Retrospective（振り返り）を実施 テスト成功（GREEN）を確認 失敗があればTDDワークフローに従い 修正を繰り返す 全品質チェックの完了確認 ADR、セッションログの記録
18. End Q：あなたのCDKコード、AIに任せて大丈夫ですか？ A：KIRO POWERで能力を補完し、TDDワークフローと品質ゲートで確実に検 証し、振り返りでフィードバックを与えて、ハーネスが育つ環境が整えば、任せ られます。 完.