spec-kitty/spec-kitty

解決する課題

AI コーディングセッションでは、要件、決定、受け入れ基準が失われることが多く、複数のエージェントを並行して実行したり、カジュアルな vibe coding から反復可能なプロセスに移行したりすることが困難になります。Spec Kitty は、明確な作業パッケージの境界、可視化された進捗、レビューゲートを備えた、ガバナンスされたリポジトリネイティブなワークフローに製品意図を変換する方法をチームに提供し、リポジトリを単一の真実の源として維持します。

仕組み

Spec Kitty は、定義されたパイプライン（spec -> plan -> tasks -> next -> review -> accept -> merge）に従う CLI です。特定のエージェント（Claude Code、Codex、Cursor、Gemini、Copilot、Windsurf、OpenCode など）用にプロジェクトを初期化し、スラッシュコマンドまたはスキルを使用して仕様、計画、作業パッケージを作成します。このツールは、すべてのミッションアーティファクトを kitty-specs/ に保存し、ライフサイクルレーン（planned、in_progress、for_review、approved、done）を通じて作業パッケージを追跡し、.worktrees/ の下の分離された git worktree でエージェントを実行します。dispatch コマンドはガバナンスコンテキストをロードして操作記録を開き、ランタイムはミッションがレビューとマージの準備ができるまで次のアクションを選択します。完了したミッションはデフォルトでレトロスペクティブを生成します。

対象読者

AI コーディングエージェントの周りに、反復可能な入力、明確な作業境界、分離された実行、レビューゲートを必要とするソフトウェアファクトリーを構築するチーム。複数のエージェントや大規模なコードベースの開発者を調整する人々、またはアドホックな vibe coding から規律ある仕様駆動型ワークフローに移行する人々に適しています。1回限りの編集や小さなスクリプトには過剰であり、Git が必要です。

ハイライト

• リポジトリネイティブなガバナンス：仕様、計画、作業パッケージ、受け入れ基準、レビュー状態、マージ決定が Git に保存されます。
• 分離された git worktree による並行エージェント実行で、ブランチの混乱を回避。
• 多くの AI コーディングエージェント（Claude Code、Codex、Cursor、Gemini、Copilot、Windsurf、OpenCode など）をスラッシュコマンドまたはスキルでサポート。
• 明示的なワークフローループ：next -> review -> accept -> merge、監査証跡付き。
• ローカルファーストでオープンソース（MIT）、オプションのホスト型同期とトラッカー統合は必須ではありません。
• 完了した各ミッションは自動的にレトロスペクティブを生成し、ミッション間の学習を可能にします。