AI ネイティブなソフトウェア開発のための製品意思の標準仕様フォーマット
中辛 の解説
TypeScript + npm パッケージ (@productspec/parser)、CLI ツール、MCP サーバーで実装され、AI エージェント (Claude・Codex・Cursor) との統合を想定しています。Markdown ベースの ProductSpec、Agent Run、Decision Trace の 3 つの標準フォーマットを定義。npm exec か npx で即座にバリデーション・ハンドオフ生成・MCP 起動が可能で、GitHub Actions での CI 検証も対応済みです。実際の実装例が examples/ に揃っています。
こんなリポジトリです
こんなときに便利です
- AI コーディングエージェントに与えるスコープ・受け入れ基準・検証項目を明確に定義し、実装品質を確保したい場合
- 複数機能を並行開発する際に各機能の依存関係・競合・実行順序を自動グラフ化して conflict を事前検知したい場合
- 製品意思の改版・ドリフト・実装結果を時系列で記録し、後で「何が、いつ、なぜ変わったのか」を根拠付きで遡りたい場合
主な機能
ほかとの違い
従来の PRD・Jira・エンジニアリング仕様は人間向けテキストに留まりますが、ProductSpec は AI エージェント向けに Markdown を機械可読化し、スコープ・受け入れ基準・評価・成功メトリクスを構造化 ID で参照可能にしたうえ、Agent Run と Decision Trace で実装と意思変更を追跡可能にする点で異なります。
このリポジトリの作り方
はじめてですか？ むずかしくありません — 上から順にたどれば、自分の環境で動かして味見できます。
準備するもの
- Node.js・npm
- AI コーディングエージェント (Claude・Codex・Cursor など) との統合を想定する場合は MCP クライアント
すぐに始める
- ProductSpec パーサーをインストールし、デモファイルをバリデーションします。
npm exec --package @productspec/parser -- productspec validate examples/harness-demo/checkout-notifications.product-spec.md
- Agent Handoff (実装ブリーフ) を生成します。
npm exec --package @productspec/parser -- productspec handoff examples/product-harness/video-transcript.product-spec.md
- MCP サーバーを起動します。
npx --yes -p @productspec/parser@latest productspec mcp
- Claude・Cursor などの MCP 対応エージェント用の設定を生成します。
npx --yes -p @productspec/parser@latest productspec mcp-config claude
- Agent Run の初期化テンプレートを作成します。
npm exec --package @productspec/parser -- productspec init-run examples/harness-demo/checkout-notifications.product-spec.md /tmp/checkout-notifications.agent-run.json
- 検証済みの例を検証します。
npm exec --package @productspec/parser -- productspec validate-run examples/harness-demo/checkout-notifications.agent-run.json
ギット飯トライで味見
入れるのが面倒で少し不安だったなら — 安全スキャンからインストールまで、ターミナル一行で終わります。
ターミナルに貼り付ければ、ギット飯の安全スキャン → 隔離フォルダへ clone → インストール → 実行方法の案内まで自動です。はじめてでも大丈夫 — この一行だけです。
npx gitbap-try gokulrajaram/ProductSpec
Node.js さえあれば、インストールなしで動きます · ギット飯トライとは？ →
これを仕事に活かす
味見がすんだら次は応用です — 仕事やビジネスに活かす方法をまとめました。
レシピ — AI にこのまま頼んでみてください
レシピを読み込んでいます…
スター推移 · 7日
確認日時
使いやすさ · まねしやすいか
- ゆるいライセンス
- テストあり
- サンプル集
- 最近の更新
- AGENTS.md
- llms.txt
- テンプレート
最近の更新あり · 2026 年に作成
「企画・設計」 こういうリポジトリを毎週受け取りませんか？
毎週月曜の朝、選んだ一膳だけ。広告なし · いつでも解除。
自分のリポジトリですか？ README にギット飯バッジを貼る
[](https://www.gitbap.com/r/gokulrajaram/ProductSpec)Claude からそのまま使う — ギット飯のつなぎ方
ギット飯を Claude につなぐと、こうしたリポジトリを Claude・Cursor・Codex から直接さがして試せます。
Claude の設定 → コネクタにこのアドレスを貼り付け。
https://www.gitbap.com/api/mcpプラグインを入れると /gitbap-trending·/gitbap-try のスラッシュコマンドで、その場でリポジトリを試せます。Claude Code で下の 2 行を順に実行してください。
/plugin marketplace add jakeparkcolde/gitbap-cowork/plugin install gitbap-cowork@gitbapAI が README をもとに要約しました · 原文を見る