shipfast-mcp

shipfast-mcp

POとAIのワークフローを、MCP サーバーとしてパッケージ化します。
POがスコープを決定し、受け入れを行います。Orchestratorが調整、提案、レビューを担います。専門的な作業はプロジェクトごとに編成された部門が担当し、各部門がサブエージェントとなります。

紹介ページ · PyPI · ドキュメント · リリースノート

プロダクトオーナーとAIエージェント間のウェーブ型作業プロセスをあらゆる技術スタックにもたらす、Model Context Protocol サーバーです。調整とレビューを行うオーケストレーター、サブエージェントとして機能するプロジェクト固有の部門、単一の意思決定ログ、検証済みの品質ゲート、そして三者間マージによるアップグレードを備えています。

目次

• 🚀 クイックスタート
• 🛠️ インストール
• 📦 機能
• 🤝 貢献方法
• 💬 コミュニティとサポート
• 👥 リポジトリのコントリビューター
• ⚖️ ライセンス
• 🌟 Star の履歴

---

クイックスタート

uv が必要です。

#	手順	コマンド
1	uv をインストール	curl -LsSf https://astral.sh/uv/install.sh | sh
2	Claude Code に shipfast を追加	/plugin install shipfast --marketplace QuocTang/shipfast-mcp
3	init プロンプト（新規リポジトリ）または adopt（既存コードのあるプロジェクト）を呼び出す	/mcp__shipfast__init
4	問題コードで回答する	W01-02: A。スコープに同意したら**「確定」**と言います
5	新しいバージョンが出たらアップグレード	/mcp__shipfast__upgrade

Claude Code での init セッションの例（抜粋）：

> /mcp__shipfast__init

● shipfast - scaffold_project (MCP)(mode: "init", dry_run: true)
  └ 34 file sẽ tạo, 0 file trùng

● Đã mở wave W01. Sản phẩm làm gì, cho ai dùng?

> App quản lý kho cho cửa hàng nhỏ, hai vai: chủ cửa hàng và nhân viên.

● W01-01: nhập xuất kho, cảnh báo sắp hết, báo cáo tồn; in hoá đơn và đa chi
  nhánh để sau (BL-005, BL-006). W01-02 stack: đề xuất A (Next.js + Postgres).
  Phản biện: cần thêm runtime khi có job nền. W01-09: lập ba bộ phận PRODUCT,
  PLATFORM, TRUST.

> W01-02: A, còn lại theo đề xuất. Chốt.

● shipfast - create_department (MCP)(code: "PLATFORM")
  └ docs/departments/platform/, .claude/agents/dept-platform.md

インストール

ツール	インストール方法
Claude Code（プラグイン）	/plugin install shipfast --marketplace QuocTang/shipfast-mcp
Claude Code（MCP）	claude mcp add shipfast -- uvx shipfast-mcp
Cursor、VS Code、Codex、その他のMCPクライアント	stdio サーバー、uvx コマンド、shipfast-mcp 引数

クライアントが mcpServers を読み込むための JSON 形式の設定：

{
  "mcpServers": {
    "shipfast": { "command": "uvx", "args": ["shipfast-mcp"] }
  }
}

バージョンを固定する場合：uvx [email protected]。

機能

1つのウェーブのライフサイクル

📥 Intake → 🗣️ Discussion → ✅ Scope lock → 🔨 Build → 🧹 Cleanup → 🧪 Acceptance → 🚀 Release

ステップ	作業
Intake	作業をまとめ、各課題に選択肢を添えます
Discussion	Orchestratorが提案とレビューを行い、各部門の意見を集めます。POが確定します
Scope lock	POが「確定」と伝えると、スコープが凍結され、変更はCRを通じて行います
Build	担当部門が項目ごとにビルドします
Cleanup	不要なコードや古くなったドキュメントを整理します
Acceptance	ビルドを担当した部門とは独立したQAが受け入れを行い、品質ゲートを実際に実行します
Release	リリースし、振り返りを行い、ウェーブを終了します

確定モード	適用場面
POが確定	デフォルト
即時確定	小規模なウェーブで、要件が明確な場合
Delegation	POが部門間の議論による決定を委任し、Orchestratorが議長を務めます

MCP コンポーネント

種類	名前	内容
🔧 ツール	scaffold_project	CLAUDE.md、docs/（wave、backlog、decision log、組織）およびスキル .claude/skills/shipfast-* を生成します。先にドライランを行い、上書きはしません
🔧 ツール	upgrade	three-way merge でフレームワークを新しいバージョンにアップグレードします
🔧 ツール	status、check	実行中の wave、PO の対応待ち事項、ファイルの整合性を確認します
🔧 ツール	refresh_departments	アップグレード後、新しいテンプレートで部門のサブエージェントファイルを更新します
🔧 ツール	create_department	プロジェクトに合わせて部門を作成します。プロファイルは docs/departments/<mã>/、サブエージェントは .claude/agents/dept-<mã>.md に配置します
🔧 ツール	open_wave、new_decision、next_code	wave を開始し、決定を記録し、重複しないコードを割り当てます
🔧 ツール	read_guide	人向けのガイドドキュメント
💬 プロンプト	init、adopt、upgrade	エントリーポイント
📚 リソース	skill://shipfast-*/SKILL.md	6 つのスキル：基本ルール、初期化、導入、wave の実行、ディベート、アップグレード
📚 リソース	shipfast://guide/*	開始方法、組織、意義、発展、アップグレード

フレームワークのアップグレード

プロジェクトには .shipfast/manifest.json と .shipfast/base/（前回のフレームワークのコピー）が保持されます。upgrade は、元のバージョン、プロジェクトのバージョン、新しいバージョンの 3 つを比較します。

ケース	結果
プロジェクトでファイルが変更されていない	新しいバージョンに置き換えます
両方で異なる箇所が変更されている	自動でマージします
両方で同じ箇所が変更されている	実ファイルはそのまま保持し、競合マーカー付きのマージ結果を .shipfast/pending/ に配置して確認できるようにします
wave、backlog、decision log の表	そのまま保持します

ガイド

記事	ファイル
どこから始めるか	start.md
どのように組織するか	organization.md
意義と目的	purpose.md
継続的な発展とアップグレード	evolve.md
リリースノート	changelog.md

貢献方法

貢献内容は、実際のプロジェクトで運用され、あらゆるスタックで活用できる方法であることが望まれます。

1. リポジトリを Fork します。
2. 変更用の 新しいブランチを作成 します。
3. Pull Request を送信 します。遭遇した問題、方法、実際のプロジェクトでの証拠を記載してください。

ローカルで開発する場合：

uv sync
uv run pytest
uv run shipfast-mcp

ナレッジベースは src/shipfast_mcp/knowledge/ にあります。project/（プロジェクトに生成するフレームワーク）、department/（部門のプロファイルとサブエージェント）、skills/、guide/ で構成されています。ランディングページは site/ にあります（site/README.md）。設計上の決定については docs/decisions/README.md をご覧ください。

コミュニティとサポート

• バグ報告や提案：GitHub Issues。
• 新しいリリースを確認するには、リポジトリにスター（⭐）を付けてください。

リポジトリのコントリビューター

contrib.rocks で作成しました。

ライセンス

MIT License です。詳細は LICENSE をご覧ください。

スター履歴