io.github.QuocTang/shipfast-mcp
Quy trình theo wave giữa PO và AI: khung tài liệu, skill, scaffold, nâng cấp three-way merge.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
shipfast-mcpclaude mcp add shipfast-mcp -- uvx shipfast-mcp==0.2.3{
"mcpServers": {
"shipfast-mcp": {
"command": "uvx",
"args": [
"shipfast-mcp==0.2.3"
]
}
}
}Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
shipfast-mcp
Quy trình làm việc giữa PO và AI, đóng gói thành MCP server.
PO quyết định phạm vi và nghiệm thu. Orchestrator điều phối, đề xuất và phản biện. Việc chuyên môn do các bộ phận lập theo dự án đảm nhận, mỗi bộ phận là một subagent.
Trang giới thiệu · PyPI · Tài liệu · Ghi chú phát hành
A Model Context Protocol server that brings a wave-based working process between a product owner and AI agents to any stack: an orchestrator that coordinates and critiques, project-specific departments as subagents, a single decision log, verified quality gates, and three-way-merge upgrades.
Table of Contents
- 🚀 Quick Start
- 🛠️ Installation
- 📦 Features
- 🤝 How to Contribute
- 💬 Community & Support
- 👥 Repo Contributors
- ⚖️ License
- 🌟 Star History
Quick Start
Cần uv.
| # | Bước | Lệnh | |
|---|---|---|---|
| 1 | Cài uv | `curl -LsSf https://astral.sh/uv/install.sh \ | sh` |
| 2 | Thêm shipfast vào Claude Code | /plugin install shipfast --marketplace QuocTang/shipfast-mcp | |
| 3 | Gọi prompt init (repo mới) hoặc adopt (dự án đang có code) | /mcp__shipfast__init | |
| 4 | Trả lời theo mã vấn đề | W01-02: A; nói "chốt" khi đồng ý phạm vi | |
| 5 | Nâng cấp khi có bản mới | /mcp__shipfast__upgrade |
Một phiên init trong Claude Code (rút gọn):
> /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.mdInstallation
| Công cụ | Cách cài |
|---|---|
| Claude Code (plugin) | /plugin install shipfast --marketplace QuocTang/shipfast-mcp |
| Claude Code (MCP) | claude mcp add shipfast -- uvx shipfast-mcp |
| Cursor, VS Code, Codex và client MCP khác | Server stdio, lệnh uvx, tham số shipfast-mcp |
Cấu hình dạng JSON cho client đọc mcpServers:
{
"mcpServers": {
"shipfast": { "command": "uvx", "args": ["shipfast-mcp"] }
}
}Ghim phiên bản: uvx shipfast-mcp@0.2.2.
Features
Vòng đời một wave
📥 Intake → 🗣️ Discussion → ✅ Scope lock → 🔨 Build → 🧹 Cleanup → 🧪 Acceptance → 🚀 Release| Bước | Việc |
|---|---|
| Intake | Gom việc, mỗi vấn đề kèm phương án |
| Discussion | Orchestrator đề xuất và phản biện, lấy ý kiến bộ phận; PO chốt |
| Scope lock | PO nói "chốt"; phạm vi đóng băng, đổi qua CR |
| Build | Bộ phận phụ trách build theo hạng mục |
| Cleanup | Dọn mã chết, tài liệu lệch |
| Acceptance | QA độc lập với bộ phận đã build; quality gate chạy thật |
| Release | Phát hành, rút kinh nghiệm, đóng wave |
| Chế độ chốt | Khi nào |
|---|---|
| PO chốt | Mặc định |
| Chốt thẳng | Wave nhỏ, yêu cầu đã rõ |
| Delegation | PO giao quyền chốt cho debate giữa các bộ phận; Orchestrator làm Chủ toạ |
Thành phần MCP
| Loại | Tên | Việc |
|---|---|---|
| 🔧 Tool | scaffold_project | Dựng CLAUDE.md, docs/ (wave, backlog, decision log, tổ chức) và skill .claude/skills/shipfast-*; dry run trước, không ghi đè |
| 🔧 Tool | upgrade | Nâng khung lên phiên bản mới bằng three-way merge |
| 🔧 Tool | status, check | Wave nào đang chạy, chờ PO điều gì; hồ sơ có lệch không |
| 🔧 Tool | refresh_departments | Làm mới file subagent bộ phận theo mẫu mới sau khi nâng cấp |
| 🔧 Tool | create_department | Lập bộ phận theo dự án: hồ sơ docs/departments/<mã>/, subagent .claude/agents/dept-<mã>.md |
| 🔧 Tool | open_wave, new_decision, next_code | Mở wave, ghi quyết định, cấp mã không trùng |
| 🔧 Tool | read_guide | Tài liệu hướng dẫn cho người |
| 💬 Prompt | init, adopt, upgrade | Điểm vào |
| 📚 Resource | skill://shipfast-*/SKILL.md | 6 skill: luật nền, khởi tạo, áp dụng, chạy wave, debate, nâng cấp |
| 📚 Resource | shipfast://guide/* | Bắt đầu, tổ chức, ý nghĩa, phát triển và nâng cấp |
Nâng cấp khung
Dự án giữ .shipfast/manifest.json và .shipfast/base/ (bản khung lần trước). upgrade so ba bản: bản gốc, bản dự án, bản mới.
| Trường hợp | Kết quả |
|---|---|
| Dự án chưa sửa file | Thay bằng bản mới |
| Hai bên sửa khác chỗ | Gộp tự động |
| Hai bên sửa cùng chỗ | File thật giữ nguyên; bản gộp có dấu xung đột ở .shipfast/pending/ để duyệt |
| Bảng wave, backlog, decision log | Giữ nguyên |
Hướng dẫn
| Bài | File |
|---|---|
| Bắt đầu từ đâu | start.md |
| Tổ chức ra sao | organization.md |
| Ý nghĩa và mục đích | purpose.md |
| Phát triển tiếp và nâng cấp | evolve.md |
| Ghi chú phát hành | changelog.md |
How to Contribute
Đóng góp nên là cách làm đã chạy ở dự án thật và dùng được cho mọi stack.
- Fork repository.
- Tạo nhánh mới cho thay đổi.
- Gửi Pull Request: mô tả vấn đề gặp phải, cách làm, bằng chứng từ dự án thật.
Phát triển tại máy:
uv sync
uv run pytest
uv run shipfast-mcpKho tri thức nằm ở src/shipfast_mcp/knowledge/: project/ (khung dựng vào dự án), department/ (hồ sơ và subagent bộ phận), skills/, guide/. Landing page ở site/ (site/README.md). Quyết định thiết kế: docs/decisions/README.md.
Community & Support
- Báo lỗi, đề xuất: GitHub Issues.
- Gắn sao (⭐) repository để theo dõi các bản phát hành mới.
Repo Contributors
Made with contrib.rocks.
License
MIT License. See LICENSE for details.
Star History
Frequently asked questions
What is io.github.QuocTang/shipfast-mcp?
Quy trình theo wave giữa PO và AI: khung tài liệu, skill, scaffold, nâng cấp three-way merge.
How do I install io.github.QuocTang/shipfast-mcp?
It runs on your machine. In Claude Code: claude mcp add shipfast-mcp -- uvx shipfast-mcp==0.2.3. For other clients, paste the JSON configuration from this page into their MCP settings.
Does io.github.QuocTang/shipfast-mcp need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is io.github.QuocTang/shipfast-mcp open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains io.github.QuocTang/shipfast-mcp?
It is published by QuocTang. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.