既存のHugoサイトにSpecKitを導入し読書リスト機能を追加する実践手順

既存のコードベースにSpecKit（spec-driven developmentのツール群）をどう組み込めるかを、実際のHugo製ブログを題材に段階的に解説します。憲法（constitution）の定義から仕様・計画・タスクの生成、実装後の反復調整、そして学びの仕様ファイルへの反映まで、一連のワークフローを画面操作とともに追える内容です。

■ 既存プロジェクトへの組み込み
- 静的サイト（Hugo＋Tailwind CSS＋Congoテーマ）をリポジトリとして SpecKit をブートストラップする手順
- プロジェクトの制約を憲法に記述し、生成内容を人間が確認・修正するポイント
- /specify で読書リストの要件を定義し、/clarify で並び順や表示形式などの不足点を質問形式で補う
- /plan、/tasks、/analyze を使い、計画・タスク分解と矛盾の検出を行う

■ 実装と反復
- /implement で本の読書リストページを実装し、Hugo server でローカル動作を確認
- 初期出力を踏まえて表示崩れなどを修正し、複数のモデルを使い分けて調整
- 経験則を機能要件として仕様に書き戻し、将来の再実装に備える

仕様駆動開発の進め方やAIとの協働に興味がある方、既存リポジトリへツールを導入したい開発者におすすめです。視聴後は、要件の明確化から反復改善までを自分で回すための具体的な流れを把握できます。まず自分のプロジェクトで憲法と最初の仕様を書き、clarify を通して不足を埋めるところから試してみてください。