Kiroを使ってドキュメント管理を少し楽にしてみた

Transcript

1. Kiroを使ってドキュメント管理を少し楽にしてみた
2. 自己紹介 与那嶺 創（よなみね そう） 所属 クラスメソッド株式会社
 クラウド事業本部コンサルティング部
 ソリューションアーキテクト 趣味 ラジオ、散歩、山 最近のトピック 最近ClaudeよりKiroを使ってます ピザのアイコンでブログ書いてます🍕
3. いきなりですが IaCで管理しているAWSマルチアカウント基盤の ドキュメント運用が面倒だ！！
4. 直近の課題
5. 主にこの2点 構成の変更理由がわからない ドキュメント更新が面倒
6. 構成変更の理由 構成や設定変更時の理由 あれ、なんでこの構成を選択したんだっけ？ 誰か覚えてる？？
7. ドキュメント更新 構成や設定変更時にREADMEや構成図の更新が面倒 めちゃくちゃ大変な訳ではないけど、面倒で後回しにしがち そしてタスクの優先度が下がり、気づいたら忘れている
8. AIがなんかいい感じに解決してくれないかな？
9. ワークフローの整理
10. フロー 構成変更の一例 追加要件 構成検討 検証 構成決定 本番適用
11. フロー 構成変更の一例 ここで何かアクションができれば良さそう 構成決定 本番適用 追加要件 構成検討 検証
12. 追加要件 構成検討 検証 構成決定 変更理由 本番適用 ドキュメント 更新
13. 追加要件 構成検討 検証 構成決定 本番適用 今回の範囲 変更理由 ドキュメント 更新
14. 課題と対処法
15. 構成の変更理由が分からない
16. 追加要件 構成検討 検証 【課題】 構成変更の意思決定に関する ドキュメントが残っていないため なぜ変更したのか分からない 構成決定 変更理由 本番適用
17. 意思決定を文書として残すには？ ADR（Architecture Decision Record） アーキテクチャ決定記録（ADR）とは、チームが構築を計画しているソフトウェアアーキテクチャ の重要な側面について下した決定を記述した文書です。各ADRには、アーキテクチャ上の決定、そ の背景、および結果が記述されます。 参照：AWS公式ドキュメント 「ADRプロセス」より
18. ひらたく言うと どいう背景・課題があり 他に検討した選択肢はあるのか 最終的にどれを選択したのか なぜこの選択をしたのか みたいなことを記録するドキュメントです
19. おっ、インフラでも使えそうやん！ じゃあADRを簡単に作れるようにしたい！
20. じゃあ、意思決定をするのっていつだろう？ → 会議で決まることが多い
21. 追加要件 構成検討 検証 構成決定 ミーティング議事録 や 音声文字起こし ミーティング 本番適用
22. 追加要件 構成検討 検証 構成決定 本番適用 ミーティング議事録 や 音声文字起こし これを元にADRを 作れば良さそう ミーティング
23. ~の変更について 議事録からADRを作成して テンプレートは... Kiro 議事録 2026/05/15.md 2026/05/14.md 2026/05/13.md
24. ここも自動化したい！！ ~の変更について 議事録からADRを作成して テンプレートは... Kiro 議事録 2026/05/15.md 2026/05/14.md 2026/05/13.md
25. Agent Skills Agent skillsとは スキルとは、オープンなエージェントスキル標準に準拠した、持ち運び可能な指示パッケージです。指 示、スクリプト、テンプレートを再利用可能なパッケージにまとめ、Kiroはタスクに関連する場合にそ れらを起動できます。 参照：https://kiro.dev/docs/ 「skills」より
26. ひらたく言うと ここのワークフローを自動化 ~の変更について 議事録からADRを作成して Kiro 議事録 2026/05/15.md 2026/05/14.md 2026/05/13.md
27. 追加要件 構成検討 検証 構成決定 ミーティング議事録 や 音声文字起こし Kiro (skill) ミーティング 本番適用 ADR
28. ここってなんでこの構成にしたんだっけ？ ADRの中から確認して Kiro xxとyyを比較したけど、~な点でxxを選んだよ ADR ADR ADR
29. ドキュメントの更新が面倒
30. 追加要件 構成検討 検証 構成決定 【課題】 構成変更後、手動でドキュメントを 更新するのが面倒 本番適用 ドキュメント 更新
31. 何を管理している？ ログ SecurityOU セキュリティ ControlTowerOU システムA devOU システムB WorkloadOU システムA prodOU システムB AWS Organizations
32. 何を管理している？ Terraformコード ポリシーファイル（jsonファイル） ドキュメント（README, 構成図, runbookなど） コードが主な変更対象、変更内容に応じてドキュメントの更新も必要
33. 不定期に発生するコードの変更 OU構成の変更 AWSアカウントの追加 IAM Identity Centerユーザーの追加 セキュリティ設定の変更 などなど... 運用している中でコードの変更がちょくちょく発生する
34. 課題を解決するためには 構成変更 *.tf *.json 必要に応じて ドキュメントを更新 README, 構成図, runbookなど
35. あれ、、このコード変更したら どのドキュメント変更するんだっけ？
36. 理想は構成を変更したら自動的にドキュメントが更新されて欲しい 構成変更 * .tf * .json 必要に応じて ドキュメントを更新 README, 構成図, runbookなど
37. 構成変更 必要に応じて ドキュメントを更新 * .tf * .json オレの出番だ！ README, 構成図, runbookなど
38. Agent Hooks Agent Hooksとは エージェントフックは、IDE内で特定のイベントが発生した際に、定義済みのエージェントアクション を自動的に実行することで開発ワークフローを効率化する強力な自動化ツールです。フックを使用す ることで、ルーチンタスクを手動で実行する必要がなくなり、コードベース全体の一貫性を確保できま す。 参照：https://kiro.dev/docs/ 「hooks」より
39. ひらたく言うと ファイル保存などをトリガーにコマンドやプロンプトを実行 変更 (トリガー) *.tf 例: terraform validateを実行 Kiro (Agent Hooks)
40. ひらたく言うと *.tf *.json の変更をトリガーにドキュメントを更新 構成変更 *.tf *.json 必要に応じて ドキュメントを更新 README, 構成図, runbookなど
41. とっても簡単。これだけです
42. Hooks運用の課題 構成図など、見た目を重要視するドキュメントを0から作成させるのは難しい 生成物を手動修正 or 先にベースとなる構成図を作成しておくとよき 以下のドキュメントを必要に 応じて更新して OU構成 アカウント一覧 runbook 構成図 Kiro (Agent Hooks) *.tf
43. Hooks運用の課題 毎回Hooksが走ってしまう 他にもトリガーはあるが、ちょうど良いトリガーがない （良い方法があれば教えてください） ~のドキュメントを更新しました ~のドキュメントを更新しました ~のドキュメントを更新しました *.tf *.tf *.tf *.tf Kiro (Agent Hooks) ~のドキュメントを更新しました
44. Hooks運用の課題 じゃあskillsでもいいんじゃない？ skillsにすると、結局コードを変更した後にskillsを実行するのを忘れる(私は) なので、システム的に更新させた方が確実 おい、オレを呼べ！ *.tf *.tf *.tf *.tf Kiro (Agent skills)
45. 学び SkillsもHooksも一発で最高のものはできないので、使いながらチューニン グしていく ドキュメントを自動更新させても、期待とずれていることはよくあるので人 間が目を通す必要がある
46. おわり