spec-manager は何をしますか?
ローカルファーストの仕様駆動開発プラットフォーム。純粋なMarkdown + Gitストレージ。L0/L1/L2/L3仕様階層、24の検証ルール、エージェントタスクライフサイクル、意思決定カード、差分変更に対応。CLI + Claude Codeスキル。ネットワーク不要、MCP不要、バックエンド不要。
概要
loki-ai-ch/spec-managerは、ローカル環境で動作する仕様駆動開発(Spec-Driven Development)を実現するためのツールです。すべての仕様情報を純粋なMarkdownファイルとしてGitリポジトリに保存し、ネットワーク接続や外部バックエンド、MCPサーバーに依存しません。
主な機能
L0/L1/L2/L3 仕様階層
仕様を4つの階層に分類して管理します。
- L0(概念): プロジェクトのビジョン、目的、主要な概念を定義
- L1(アーキテクチャ): システム全体の構造、コンポーネント間の関係を定義
- L2(設計): 各コンポーネントの詳細設計、インターフェースを定義
- L3(実装詳細): 実際の実装手順、テストケースを定義
24の検証ルール
仕様の一貫性と完全性を自動チェックする24種類の検証ルールを備えています。
エージェントタスクライフサイクル
AIエージェント(Claude Code)向けのタスクライフサイクル管理機能。タスクの作成、割り当て、進行中、完了、レビューといった状態を追跡します。
意思決定カード
プロジェクト内での重要な意思決定を記録・追跡するためのカードシステム。誰が、いつ、なぜその決定を下したかを明確にします。
差分変更(デルタ変更)
仕様の変更履歴を差分として追跡し、どの部分がいつ変更されたかを明確にします。
使用方法
CLIとして
# 仕様の初期化
spec-manager init
# 仕様の検証
spec-manager validate
# タスクの作成
spec-manager task create "タスク名"
# 意思決定カードの追加
spec-manager decision add "決定内容"
Claude Codeスキルとして
このツールはClaude Codeのスキルとしても利用可能です。設定ファイルに以下のように追加します。
{
"skills": [
"loki-ai-ch/spec-manager"
]
}
システム要件
- ネットワーク: 不要(オフライン完全動作)
- MCP: 不要
- バックエンド: 不要
- ストレージ: Git + ローカルファイルシステム
- 形式: 純粋なMarkdown
インストール
npm install -g loki-ai-ch/spec-manager
# またはnpx経由
npx loki-ai-ch/spec-manager init
ライセンス
MIT