Claude Code や Cursor などのAIコーディングツールを使う際の共通の悩み:要件はチャット履歴の中にしかなく、エージェントが曖昧なプロンプトから直接コードを書き始め、方向性のズレ、繰り返し、コンテキストウィンドウの浪費につながる。
OpenSpec(github.com/Fission-AI/OpenSpec)は、AIコーディングに軽量なスペック(仕様)層を導入することで、人とAIがコードを書く前に「何をつくるか」を共有する仕組み。43,956スターを獲得し、npm の月間ダウンロード数も増加中。GitHub で最も人気のあるスペック駆動開発フレームワークです。
どう動くか
OpenSpec の哲学は “fluid not rigid, iterative not waterfall” —— 伝統的なソフトウェアエンジニアリングの煩雑なフェーズゲートを追求せず、プロジェクトの進化に応じてスペックが反復できる柔軟なアーティファクトシステムを採用しています。
各機能変更は openspec/changes/ 以下のフォルダに対応し、4つのアーティファクトを含みます:
- proposal.md — なぜやるか、何が変わるか
- specs/ — 要件と验收シナリオ
- design.md — 技術実装案
- tasks.md — 実装チェックリスト
ワークフローは直感的:
あなた: /opsx:propose add-dark-mode
AI: openspec/changes/add-dark-mode/ を作成
✓ proposal.md — なぜ、何が変わるか
✓ specs/ — 要件とシナリオ
✓ design.md — 技術案
✓ tasks.md — 実装チェックリスト
実装準備完了!
あなた: /opsx:apply
AI: タスクを実装中...
✓ 全タスク完了!
あなた: /opsx:archive
AI: アーカイブ完了。次の機能へ。
代替方案との比較
vs. GitHub Spec Kit — Spec Kit は包括的だが重量級。OpenSpec は軽量で Node.js で動作。
vs. AWS Kiro — Kiro は強力だが自社のIDEとClaudeモデルにロックイン。OpenSpec は 25+ のAIコーディングツールと互換。
クイックスタート
npm install -g @fission-ai/openspec@latest
cd your-project
openspec init
# Claude Code / Codex / Cursor で:
/opsx:propose <作りたい機能>
テレメトリを無効化:export OPENSPEC_TELEMETRY=0。