掲載済み (2026-04-04号)
098 153文字 • 1分

Kiroの仕様駆動開発を2案件回して辿り着いた運用設計

日本語

掲載情報

概要

AIコーディングツールKiroを用いた仕様駆動開発において、仕様の肥大化やレビュー負荷を抑制し、長期的な保守性を高めるための実戦的な運用ルールと自動化フローの提案。

詳細内容

AIコーディングツール「Kiro」を実案件で活用する中で直面した「仕様(spec)の肥大化」「全体像の不透明化」といった課題を解決するための運用設計が解説されています。主な戦略として、specファイルを100行程度に制限してヒューマンライクに保つこと、`design.md`をADR(アーキテクチャ決定記録)として活用すること、実装完了後に`task.md`を削除してリポジトリを軽量化することが挙げられています。また、AI用の詳細仕様とは別に、人間が俯瞰するための「地図」として`docs/requirements-spec.md`を運用し、hookを利用してGitHub Wikiと自動同期させる仕組みを構築しています。短期的な速度向上よりも、判断経緯の記録や属人性の排除といった、長期的な運用保守に主眼を置いた高度なAI協調開発の知見が詰まっています。