【要約】【インフラエンジニアのkiro活用】既存環境をドキュメントに書きだす [Qiita_Trend] | Summary by TechDistill
> Source: Qiita_Trend
Execute Primary Source
// Problem
インフラエンジニアは、長年運用してきた手動構築のAWS環境において、ドキュメントと実環境の乖離に直面している。定期的な棚卸しを行っても、最終的には実環境を直接確認せざるを得ない状況が発生している。具体的には以下の課題がある。
- ・手動構築による構成情報のブラックボックス化。
- ・ドキュメント更新の工数増大と、実環境との不一致。
- ・大規模なマルチアカウント環境における構成把握の困難さ。
// Approach
KiroのSpec機能を利用し、AIエージェントと共に「要件定義・設計・タスク分解・実装」の4段階で構成情報を抽出する。これにより、単なるコード生成ではなく、構造化されたプロセスでドキュメント化を行う。
1.要件定義（requirements.md）: 対象リソースやリージョンを対話形式で決定する。
2.設計（design.md）: Mermaid形式のアーキテクチャ図やコンポーネント詳細を生成する。
3.タスク分解（tasks.md）: 実装工程をトレーサビリティを確保した状態で細分化する。
4.実装: AWS MCP経由で実環境の情報を取得し、CloudFormationテンプレートを生成する。
// Result
既存のAWS環境から、詳細な設計書と複数のCloudFormationテンプレートを自動生成することに成功した。これにより、引き継いだ環境の理解や、構成の再現性が大幅に向上する。
- ・設計書: IAM、ネットワーク、セキュリティ等の構成を網羅したMarkdown。
- ・IaC: 依存関係（Fn::ImportValue）を考慮した6つのテンプレート。
- ・効率化: ゼロから作成するよりも遥かに迅速に、レビュー可能なベースラインを得られる。
Senior Engineer Insight
> 本手法は、既存環境の「棚卸し」という高負荷な作業を劇的に効率化する。特にSpec機能による構造化プロセスは、AIの暴走を防ぎ、精度の高い成果物を生む。ただし、生成物はあくまでスナップショットである。運用の継続性を担保するには、CI/CDへの組み込みや定期実行の仕組みが不可欠だ。また、セキュリティ観点から、実行時は必ずReadOnly権限を使用すべきである。