猫でもわかるKiro CLI(CDKコーディング編)

「JAWS-UG CDK支部 #25 〜AI時代のCDK、みんなどう書いてる？〜」登壇資料

Transcript

1. © NTT TechnoCross Corporation 猫でもわかる Kiro CLI(CDK コーディング編 ) 2026/04/15 JAWS -UG CDK 支部 #25 〜 AI 時代のCDK 、みんなどう書いてる？ 〜 NTT テクノクロス株式会社 加藤 洋雄
2. © NTT TechnoCross Corporation 2 自己紹介 ◼氏名：加藤 洋雄 (X ： @kamogashira) ◼所属： NTT テクノクロス株式会社 ⚫AWS 業務歴約5年 ◼AWS 認定 ⚫2024 、 2025 Japan AWS All Certifications Engineers ⚫2026 Community Builder に選出して頂きました ◼JAWS -UG 横浜支部運営(2025 年3 月なりたてです ) ◼好きな AWS サービス： Kiro CLI 、 Amazon Q Developer CLI (※以降Q CLI と略す ) ◼うさぎのけんた (ネザーランドドワーフ )の飼い主 けんたのオリジナルイラストです X のアイコンにも使用しています
3. © NTT TechnoCross Corporation 3 ◼話すこと ⚫私がKiro CLI を使う理由 ⚫簡単な開発環境紹介 ⚫私なりの Kiro CLI を使った CDK 開発ノウハウ ◼話さないこと ⚫AI Agent 全般について ⚫Kiro CLI の機能、 設定内容 ⚫仕様駆動開発、 AI 駆動開発の詳しい内容 今日話すこと・話さないこと
4. © NTT TechnoCross Corporation 4 ◼私はCDK ライトユーザです ◼こんな奴もいるんだなぁの暖かい目で発表を聞いて頂けると幸いです 最初におことわり
5. © NTT TechnoCross Corporation 5 ◼業務では、 AWS 環境設計・ 構築を専門に行っています (年平均2～3個程度の新規システム設計 ・ 構築) ◼3 ～4年くらい前から CFn から CDK に移行 ◼AI Agent が出現し 、 ここ１年は私一人で CDK 開発が完結するようになりました 私のIaC による開発履歴
6. © NTT TechnoCross Corporation 6 この１年の Kiro CLI(Q CLI) との関係 ◼とにかく進化が激しい ！ Vibe コーディイングでゲーム作成 後にCDK+ サーバレス構成へ 社内投資案件で Azure →AWS 移行のインフ ラ CDK 開発を一人で担当中に Kiro( 無印)が発 表になる ※発表直後にダウンロード 。 仕様駆動開発 で の要件定義、 設計、 タスク化に衝撃を受ける 社内投資案件でAI Agent 開発で Strads+AgentCore の開発を一人で担 当(Kiro CLI で仕様駆動開発を実践 ) ★Opus 4.6の衝撃 Plan モードを知る＋積極活用 Skills を知る＋活用開始 2026 年 1月 2月 3月 ４月 2025 年 5月 6月 7月 8月 9月 10 月 11 月 12 月 Agent の設定方法を知る ＋専用Agent 作成 仕様駆動開発の模索 AI 駆動開発を知る ＋検証 ハーネスエンジニアリン グ何それおいしいの ？
7. © NTT TechnoCross Corporation 7 現在の開発PJ および個人の開発環境紹介
8. © NTT TechnoCross Corporation 8 その前に： 2026 /3/13 にKiro CLI v 2.0.0がリリースされました ！ ◼３つの大きな新機能が追加 ⚫Windows 11 ネイティブ対応： /paste で画像のコピペが Ctrl+C で可能に ⚫Terminal UI がデフォルト：ざっくり言うと Claude Code っぽい TUI 画面 ⚫Headless モード： CI/CD パイプラインから非対話実行 ◼ 補足：メジャーバージョンアップの意味 ⚫ Q CLI から Kiro CLI にリブランディングし時でもバージョン番号は継続されていました 。 Kiro CLI 本気出しました ！ ⚫ Q CLI オープンソース化時バージョン： v1.5.1(2024 /12 /13 ) ⚫ Q CLI 最後のバージョン ： v1.19 .7(2025 /11 /17 ) ⚫ Kiro CLI 最初のバージョン： v1.20 .0(2026 /3/13 ) リブランディング時ですら バージョンは連続
9. © NTT TechnoCross Corporation 9 私個人のCDK 開発環境 ◼基本構成： Windows 11 +WSL 2(Ubuntu) ⚫メイン： Kiro CLI + Auto モード 。 ここ一番は手動で Opus 4 .6指定 ⚫サブ： Claude Cade + Bedrock( Sonnect 、 Opus) ◼ 補足 ⚫ Windows 11 +WSL 2の環境だとメモリ 16 G だと結構厳しいです ⚫ mcp サーバを uvx +@latest で使用すると ~.cacsh /.uv 配下のキャッシュファイル容量があっという 間に数GB になります ◼ 愚痴 ⚫ 会社一括購入PC スペック：メモリ 16 G ､SSD 256 ではストレスが溜まり精神衛生上よくありません
10. © NTT TechnoCross Corporation 10 開発PJ のAI Agnet ・ CDK 開発環境 ◼EC 2上にAWS Generative AI Solution Box (*1)のAI Agent Development Code Server (*2 )をカスタマイズ (*3)した環境 →個人的にはCloud 9 の代替環境はこれがおすすめ 。 VSCode が使えて便利 *1 ： https ://aws -samples .github .io/sample -one -click -generative -ai -solutions/solutions/aiagentdev/ *2 ： https ://aws -samples .github .io/sample -one -click -generative -ai -solutions/?industry=development *3 ：個人アカウント単位で code server を割り当て 1 つのEC 2 インスタンス上で複数人が同時開発可能にしています オリジナルは 1アカウントで EC2 占有 するので複数人共用可能にしてます
11. © NTT TechnoCross Corporation 11 参考情報： Kiro 、 Kiro CLI の料金体系 ◼Anthropic のLLM(Opus 、 Sonnect )がちょっとだけなら無料でためせる ◼$ 20 からセキュア (ユーザーのコンテンツが AI モデル訓練に使用されない )にLLM が 利用可能です
12. © NTT TechnoCross Corporation 12 参考情報： Kiro CLI が利用可能なLLM ◼4 月x 日時点でKiro CLI で利用可能な LLM は以下の通りです ◼auto モードを選択すれば入力内容に合わせて最適な LLM を選択してくれます (デフォルトは auto モード ) モデルによって消費 Credits が異なります
13. © NTT TechnoCross Corporation 13 参考情報：私のチームにおけるピーク時 Kiro CLI 使用料金 ◼3 月使用料実績(*1)： $ 2,029 /月= 324 ,640 円(1$ 160 円換算：最近の円安がキツイ ) ◼私個人では平均約4 万円弱/月(Pro+ に従量課金オプション )ぐらいです *1： 3月が開発ピークだったためちょっとお高めの使用料になっています 。 【 豆知識】 ⚫ 1Kiro アカウント (Pro 、 Pro+ 共)で従量課金を ON にしても約 10,000 クレジットで上限になります →約10,000 クレジット以上使う場合は上限緩和申請が必要になり ます
14. © NTT TechnoCross Corporation 14 なぜClaude Code ではなく Kiro CLI なのか(※単なる個人の好みです ) ◼個人的にClaude Code ≒ Kiro CLI と思っています ⚫Kiro CLI はClaude Code のノウハウがかなり流用できる (これが大きい ！) ◼例えると Claude Code は日本メーカー多機能電子レンジ (※個人の感想です) ⚫多機能でも使いこなせい機能はただの飾り ⚫制約がある中で工夫することで長期記憶管理などへの理解が深まる (その他の理由) ⚫ キャラクターの Kiro がかわいいから 限定品のKiro Tシャ ツは私の自慢です
15. © NTT TechnoCross Corporation 15 2025 年度私のQ CLI 、 Kiro CLI 推し活内容：外部登壇分 ◼Q CLI 、 Kiro CLI 外部登壇一覧 # 発表日 内容 1 2025/07/28 JAWS -UG AI/ML #29 猫でもわかる Q Developer CLI(CDK 開発編)＋ほんのちょっとだけ Kiro 2 2025/07/31( クラメソさん主催 ) AWS インフラ × AI 活用 LT ！ 猫でもわかる Q Developer CLI(CDK 開発編)＋ちょっとだけ Kiro( *1) →#1 に更なるノウハウ、 Kiro 説明追記した内容 3 2025/10/29 JAWS -UG AI/ML #32 猫でもわかる Q Developer CLI 解体新書(Q CLI の取説的サイト ) ( *2) →#1 ､2の続編として Q CLI の仕様、 Tips 紹介 4 2025/11/12 JAWS -UG 朝会 #75 猫でもわかる Q Developer CLI( できる子編 )( *3) →なるべく幅広い層に Q CLI で出来る事を紹介した内容 5 2026/02/12 Security -JAWS #40 猫でもわかる Kiro CLI( セキュリティ編： 20 分) (*4) →セキュリティレビュー用 Agent 作成＋レビュー結果紹介した内容 6 2026/03/13 JAWS -UG 朝会 #79 猫でもわかる Kiro CLI(AI 駆動開発への道編： 20 分) ( *5) →Kiro CLI でAI -DLC( aidlc -workflows) を行う前に知っておいて欲しいこと *1 ： https ://qiita .com/kamogashira/items/ 672 fbc 6cbc 48 c 28364 ff *2 ： https ://qiita .com/kamogashira/items/ec 2ed 9 b 39052 d 55 d 4 f 13 *3 ： https ://qiita .com/kamogashira/items/ 95 cc 366 b 4 a 1815 bc 4 c50 *4 ： https ://qiita .com/kamogashira/items/ 52 bbf 8 f 66 a 8ce 0cb 9166 *5 ： https ://qiita .com/kamogashira/items/ 4f 6dac 31 ab 4919278412 社内勉強会でも 3回登壇発表しています
16. © NTT TechnoCross Corporation 16 最近のCDK コードの書き方 やっと本題です
17. © NTT TechnoCross Corporation 17 なるべく Kiro CLI にコードを書かせない (会の主旨に反していてすいません ) ◼CDK コードは GitHub のAWS サンプルコードをベースとして使用する ⚫一般的なコード： https ://github .com/aws -samples/aws -cdk -examples ⚫AgentCore 関連： https ://github .com/awslabs/agentcore -samples 私が開発する規模のシステムの場合はたいがい上記 GitHub サンプルの 組み合わせでベース部分はまかなえます AI Agent の開発をしているのでこちらも 欠かせない情報源になっています
18. © NTT TechnoCross Corporation 18 勝負その１ いかに効率よくサンプルコードを Kiro CLI に理解させるか 人間のためにもなります
19. © NTT TechnoCross Corporation 19 AI ｰDLC テンプレート (GitHub 公開： aidlc ｰworkflows) を活用 https ://github .com/awslabs/aidlc -workflows 2025 年12 月にAWS から各種 AI Agent に対応した AI 駆動開発用テンプ レートが GitHub 上に公開されています ◼2025 年12 月にAWS から各種 AI Agent に対応したテンプレートが公開されました ◼誰でも AI 駆動開発を試せる時代に (GitHubo 公開： aidlc ｰworkflows)
20. © NTT TechnoCross Corporation 20 AI ｰDLC のBrownfield でReverse Engineering を行う ◼ゼロから作る： Greenfield ◼既存のコードがある状態から始める： Brownfield →Workspace Detection （ ステップ 1 ） の時点でプロジェクトが空かで判断 名称 aidlc ｰworkflows での判断条件 Greenfield ワークスペースにコードなし Brownfield ワークスペースに既存コードあり Brownfield 判定時の Reverse Engineering( 既存 のコードベースを解析 )が超強力です サンプルコードをワークス ペースへクローンしておく
21. © NTT TechnoCross Corporation 21 参考情報： Reverse Engineering の内容(※詳しい説明は省略します ) ◼Reverse Engineering ステージ 1. ビジネス概要 2. アーキテクチャ 3. コード構造 4. API 仕様 5. コンポーネント一覧 6. 技術スタック 7. 依存関係 8. コード品質評価 GitHub awslabs /fullstack -solution -template -for -agentcore を Revers Engineering した時に生成された architecture.md 抜粋
22. © NTT TechnoCross Corporation 22 勝負その２ AI Agent でのコーディングは 作業計画書が命 ※あくまでも個人の考えです
23. © NTT TechnoCross Corporation 23 私の計画書作成手順 ◼仕様粒度、 タスクの複雑さを考慮した精度の高い作業計画を作成すること 1. Plan モード等を利用して作業計画書たたき台を作成させる (※ここがスタート ) 2. 作業計画書をaws mcp サーバ等を利用して AWS ドキュメント 、 AWS GitHub サンプルを調査させてソースコードも記入 3. 作業計画書をaws mcp サーバ等を利用してレビューする 4. 作業計画書にレビュー報告書の内容を反映させる時も指摘が正しいかチェック Kiro CLI が行う作業を可視化して上流工程で品質を担保するのが大事
24. © NTT TechnoCross Corporation 24 参考情報： Kiro CLI が選んだベスト修正計画書 ◼概要：セキュリティ診断の指摘事項の対応例 ⚫Lambda Authorizer の環境変数に平文保存されたシークレットを Secrets Manager に移行する CDK 修正計画。 【 指摘概要】
25. © NTT TechnoCross Corporation 25 参考情報： Kiro CLI が選んだ私のベスト修正計画書 ◼修正計画書 ⚫行数： 364 ⚫項目：目的 、 現状分析、 対応方針、 変更ファイル一覧 、 詳細手順、 テスト計画 、 ロールバック手順 、 注意事項、 付録(計画書に対するレビュー指摘事項反映状況 ) AI Agent にコーディング時 余計なことを考えさせない 不確定要素は極力事前に排除する
26. © NTT TechnoCross Corporation 26 参考情報： Kiro CLI が選んだ私のベスト修正計画書 抜粋 ◼修正方式選定の根拠を記載
27. © NTT TechnoCross Corporation 27 参考情報： Kiro CLI が選んだ私のベスト 修正計画書 抜粋 ◼制約事項を記載
28. © NTT TechnoCross Corporation 28 参考情報： Kiro CLI が選んだベスト修正計画書 抜粋 ◼注意事項を記載
29. © NTT TechnoCross Corporation 29 参考情報： Kiro CLI が選んだベスト修正計画書 抜粋 ◼修正対象ファイルを記載
30. © NTT TechnoCross Corporation 30 参考情報： Kiro CLI が選んだベスト修正計画書 抜粋 ◼詳細手順としてレビュー済みのソースコードを記載
31. © NTT TechnoCross Corporation 31 参考情報： Kiro CLI が選んだベスト修正計画書 抜粋 ◼テスト計画も含める
32. © NTT TechnoCross Corporation 32 参考情報： Kiro CLI が選んだベスト修正計画書 抜粋 ◼修正計画書自身へのレビュー指摘事項の反映状況も忘れずに ！
33. © NTT TechnoCross Corporation 33 ソース修正後はテストのみ ソースコードレビュはしない https ://speakerdeck .com/watany/dark -factory -for -agent ソースコードレビューに対する考え は弊社AWS 絶対王 watany さん資 料を参照してください 5/2 にwatany さん著書 Agentic Coding 本が出ます
34. © NTT TechnoCross Corporation 34 私の結論： AI 時代のCDK 、みんなどう書いてる？ ◼私の現時点でのCDK の書き方です ⚫AI Agent に極力CDK ソースを書かせない ⚫CDK ソース修正時に AI Agent に考えさせない ⚫高品質な作業計画書を作ることが全て
35. © NTT TechnoCross Corporation 35 Kiro CLI はできる子です 最後に