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

by Yona

Embed

Start on current slide

Slide 1

Slide 1 text

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

Slide 2

Slide 2 text

自己紹介与那嶺創（よなみねそう）所属クラスメソッド株式会社  クラウド事業本部コンサルティング部  ソリューションアーキテクト趣味ラジオ、散歩、山最近のトピック最近ClaudeよりKiroを使ってますピザのアイコンでブログ書いてます🍕

Slide 3

Slide 3 text

いきなりですが IaCで管理しているAWSマルチアカウント基盤のドキュメント運用が面倒だ！！

Slide 4

Slide 4 text

直近の課題

Slide 5

Slide 5 text

主にこの2点構成の変更理由がわからないドキュメント更新が面倒

Slide 6

Slide 6 text

構成変更の理由構成や設定変更時の理由あれ、なんでこの構成を選択したんだっけ？誰か覚えてる？？

Slide 7

Slide 7 text

ドキュメント更新構成や設定変更時にREADMEや構成図の更新が面倒めちゃくちゃ大変な訳ではないけど、面倒で後回しにしがちそしてタスクの優先度が下がり、気づいたら忘れている

Slide 8

Slide 8 text

AIがなんかいい感じに解決してくれないかな？

Slide 9

Slide 9 text

ワークフローの整理

Slide 10

Slide 10 text

フロー構成変更の一例追加要件構成検討検証構成決定本番適用

Slide 11

Slide 11 text

フロー構成変更の一例ここで何かアクションができれば良さそう構成決定本番適用追加要件構成検討検証

Slide 12

Slide 12 text

追加要件構成検討検証構成決定変更理由本番適用ドキュメント更新

Slide 13

Slide 13 text

追加要件構成検討検証構成決定本番適用今回の範囲変更理由ドキュメント更新

Slide 14

Slide 14 text

課題と対処法

Slide 15

Slide 15 text

構成の変更理由が分からない

Slide 16

Slide 16 text

追加要件構成検討検証【課題】構成変更の意思決定に関するドキュメントが残っていないためなぜ変更したのか分からない構成決定変更理由本番適用

Slide 17

Slide 17 text

意思決定を文書として残すには？ ADR（Architecture Decision Record）アーキテクチャ決定記録（ADR）とは、チームが構築を計画しているソフトウェアアーキテクチャの重要な側面について下した決定を記述した文書です。各ADRには、アーキテクチャ上の決定、その背景、および結果が記述されます。参照：AWS公式ドキュメント「ADRプロセス」より

Slide 18

Slide 18 text

ひらたく言うとどいう背景・課題があり他に検討した選択肢はあるのか最終的にどれを選択したのかなぜこの選択をしたのかみたいなことを記録するドキュメントです

Slide 19

Slide 19 text

おっ、インフラでも使えそうやん！じゃあADRを簡単に作れるようにしたい！

Slide 20

Slide 20 text

じゃあ、意思決定をするのっていつだろう？ → 会議で決まることが多い

Slide 21

Slide 21 text

追加要件構成検討検証構成決定ミーティング議事録や音声文字起こしミーティング本番適用

Slide 22

Slide 22 text

追加要件構成検討検証構成決定本番適用ミーティング議事録や音声文字起こしこれを元にADRを作れば良さそうミーティング

Slide 23

Slide 23 text

~の変更について議事録からADRを作成してテンプレートは... Kiro 議事録 2026/05/15.md 2026/05/14.md 2026/05/13.md

Slide 24

Slide 24 text

ここも自動化したい！！ ~の変更について議事録からADRを作成してテンプレートは... Kiro 議事録 2026/05/15.md 2026/05/14.md 2026/05/13.md

Slide 25

Slide 25 text

Agent Skills Agent skillsとはスキルとは、オープンなエージェントスキル標準に準拠した、持ち運び可能な指示パッケージです。指示、スクリプト、テンプレートを再利用可能なパッケージにまとめ、Kiroはタスクに関連する場合にそれらを起動できます。参照：https://kiro.dev/docs/ 「skills」より

Slide 26

Slide 26 text

ひらたく言うとここのワークフローを自動化 ~の変更について議事録からADRを作成して Kiro 議事録 2026/05/15.md 2026/05/14.md 2026/05/13.md

Slide 27

Slide 27 text

追加要件構成検討検証構成決定ミーティング議事録や音声文字起こし Kiro (skill) ミーティング本番適用 ADR

Slide 28

Slide 28 text

ここってなんでこの構成にしたんだっけ？ ADRの中から確認して Kiro xxとyyを比較したけど、~な点でxxを選んだよ ADR ADR ADR

Slide 29

Slide 29 text

ドキュメントの更新が面倒

Slide 30

Slide 30 text

追加要件構成検討検証構成決定【課題】構成変更後、手動でドキュメントを更新するのが面倒本番適用ドキュメント更新

Slide 31

Slide 31 text

何を管理している？ログ SecurityOU セキュリティ ControlTowerOU システムA devOU システムB WorkloadOU システムA prodOU システムB AWS Organizations

Slide 32

Slide 32 text

何を管理している？ Terraformコードポリシーファイル（jsonファイル）ドキュメント（README, 構成図, runbookなど）コードが主な変更対象、変更内容に応じてドキュメントの更新も必要

Slide 33

Slide 33 text

不定期に発生するコードの変更 OU構成の変更 AWSアカウントの追加 IAM Identity Centerユーザーの追加セキュリティ設定の変更などなど... 運用している中でコードの変更がちょくちょく発生する

Slide 34

Slide 34 text

課題を解決するためには構成変更 *.tf *.json 必要に応じてドキュメントを更新 README, 構成図, runbookなど

Slide 35

Slide 35 text

あれ、、このコード変更したらどのドキュメント変更するんだっけ？

Slide 36

Slide 36 text

理想は構成を変更したら自動的にドキュメントが更新されて欲しい構成変更 * .tf * .json 必要に応じてドキュメントを更新 README, 構成図, runbookなど

Slide 37

Slide 37 text

構成変更必要に応じてドキュメントを更新 * .tf * .json オレの出番だ！ README, 構成図, runbookなど

Slide 38

Slide 38 text

Agent Hooks Agent Hooksとはエージェントフックは、IDE内で特定のイベントが発生した際に、定義済みのエージェントアクションを自動的に実行することで開発ワークフローを効率化する強力な自動化ツールです。フックを使用することで、ルーチンタスクを手動で実行する必要がなくなり、コードベース全体の一貫性を確保できます。参照：https://kiro.dev/docs/ 「hooks」より

Slide 39

Slide 39 text

ひらたく言うとファイル保存などをトリガーにコマンドやプロンプトを実行変更 (トリガー) *.tf 例: terraform validateを実行 Kiro (Agent Hooks)

Slide 40

Slide 40 text

ひらたく言うと *.tf *.json の変更をトリガーにドキュメントを更新構成変更 *.tf *.json 必要に応じてドキュメントを更新 README, 構成図, runbookなど

Slide 41

Slide 41 text

とっても簡単。これだけです

Slide 42

Slide 42 text

Hooks運用の課題構成図など、見た目を重要視するドキュメントを0から作成させるのは難しい生成物を手動修正 or 先にベースとなる構成図を作成しておくとよき以下のドキュメントを必要に応じて更新して OU構成アカウント一覧 runbook 構成図 Kiro (Agent Hooks) *.tf

Slide 43

Slide 43 text

Hooks運用の課題毎回Hooksが走ってしまう他にもトリガーはあるが、ちょうど良いトリガーがない（良い方法があれば教えてください） ~のドキュメントを更新しました ~のドキュメントを更新しました ~のドキュメントを更新しました *.tf *.tf *.tf *.tf Kiro (Agent Hooks) ~のドキュメントを更新しました

Slide 44

Slide 44 text

Hooks運用の課題じゃあskillsでもいいんじゃない？ skillsにすると、結局コードを変更した後にskillsを実行するのを忘れる(私は) なので、システム的に更新させた方が確実おい、オレを呼べ！ *.tf *.tf *.tf *.tf Kiro (Agent skills)

Slide 45

Slide 45 text

学び SkillsもHooksも一発で最高のものはできないので、使いながらチューニングしていくドキュメントを自動更新させても、期待とずれていることはよくあるので人間が目を通す必要がある

Slide 46

Slide 46 text

おわり