Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@shipfast-mcp init a new project and propose the scope for wave W01"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
Related MCP server: Cascade
Cần uv.
# | Bước | Lệnh |
1 | Cài uv |
|
2 | Thêm shipfast vào Claude Code |
|
3 | Gọi prompt init (repo mới) hoặc adopt (dự án đang có code) |
|
4 | Trả lời theo mã vấn đề |
|
5 | Nâng cấp khi có bản mới |
|
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.mdCông cụ | Cách cài |
Claude Code (plugin) |
|
Claude Code (MCP) |
|
Cursor, VS Code, Codex và client MCP khác | Server stdio, lệnh |
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.
📥 Intake → 🗣️ Discussion → ✅ Scope lock → 🔨 Build → 🧹 Cleanup → 🧪 Acceptance → 🚀 ReleaseBướ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ạ |
Loại | Tên | Việc |
🔧 Tool |
| Dựng |
🔧 Tool |
| Nâng khung lên phiên bản mới bằng three-way merge |
🔧 Tool |
| Wave nào đang chạy, chờ PO điều gì; hồ sơ có lệch không |
🔧 Tool |
| Làm mới file subagent bộ phận theo mẫu mới sau khi nâng cấp |
🔧 Tool |
| Lập bộ phận theo dự án: hồ sơ |
🔧 Tool |
| Mở wave, ghi quyết định, cấp mã không trùng |
🔧 Tool |
| Tài liệu hướng dẫn cho người |
💬 Prompt |
| Điểm vào |
📚 Resource |
| 6 skill: luật nền, khởi tạo, áp dụng, chạy wave, debate, nâng cấp |
📚 Resource |
| Bắt đầu, tổ chức, ý nghĩa, phát triển và nâng cấp |
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 ở |
Bảng wave, backlog, decision log | Giữ nguyên |
Bài | File |
Bắt đầu từ đâu | |
Tổ chức ra sao | |
Ý nghĩa và mục đích | |
Phát triển tiếp và nâng cấp | |
Ghi chú phát hành |
Đó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.
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.
Made with contrib.rocks.
MIT License. See LICENSE for details.
Kiểm hồ sơ: biến khung sót, link gãy, wave đóng thiếu rút kinh nghiệm hoặc còn vấn đề Chờ, bảng wave lệch, decision log lệch.
Inputs: project_dir (required). Returns: object
Lập bộ phận theo dự án: hồ sơ docs/departments/<mã>/, subagent .claude/agents/dept-<mã>.md, thêm vào ORGANIZATION.md.
Sau khi lập, mọi việc thuộc lĩnh vực của bộ phận được giao cho subagent này; Orchestrator chỉ điều phối. model và effort là mặc định của bộ phận; Orchestrator ghi đè theo từng việc khi giao (ORGANIZATION.md §5.1).
Inputs: code (required), name (required), owns (required), domain (required), +5 more. Returns: object
Ghi quyết định mới vào docs/05_decisions/ theo mẫu của dự án, cấp mã và cập nhật mục lục.
Inputs: kind (required), title (required), short_name (required), project_dir (required), +4 more. Returns: object
Cấp mã kế tiếp (BL-012, W03-04, CR-W03-02, KT-005…) bằng cách quét hồ sơ, tránh trùng số.
Inputs: kind (required), project_dir (required), wave. Returns: object
Mở wave mới: tạo docs/04_waves/Wxx/ từ mẫu của dự án, thêm dòng vào bảng wave ở trạng thái Intake.
Inputs: goal (required), title (required), project_dir (required), lead, +1 more. Returns: object
Đọc tài liệu hướng dẫn shipfast cho người: bắt đầu từ đâu, tổ chức, ý nghĩa, phát triển và nâng cấp.
Inputs: topic. Returns: result
Làm mới file subagent bộ phận (.claude/agents/dept-*.md) theo mẫu hiện hành, giữ tên, mã, lĩnh vực, vùng sở hữu, model, effort, kỷ luật riêng.
Dùng sau upgrade để bộ phận đã lập nhận luật mới. File đã bị sửa khác mẫu thì bỏ qua và báo.
Inputs: project_dir (required), dry_run. Returns: object
Scaffold quy trình shipfast vào dự án: CLAUDE.md, docs/ (wave, backlog, decision log, tổ chức), skill trong .claude/skills/.
Không ghi đè file đã có. Ghi .shipfast/ để sau này nâng cấp tự gộp. Luôn chạy dry_run trước và trình PO danh sách.
Inputs: name (required), project_dir (required), display_name (required), mode, +4 more. Returns: object
Trạng thái quy trình: phiên bản khung, bảng wave, wave đang mở và vấn đề chờ PO, backlog, quyết định giả định.
Inputs: project_dir (required). Returns: object
Nâng khung quy trình của dự án lên phiên bản shipfast đang chạy, không cần repo gốc.
File dự án chưa sửa thì thay bằng bản mới; file dự án đã sửa thì three-way merge; xung đột thì để bản gộp ở .shipfast/pending/ và giữ nguyên file thật. File dữ liệu của dự án (bảng wave, backlog, decision log) không bị đụng.
Inputs: project_dir (required), dry_run. Returns: object
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 10 tools
Most tools target distinct lifecycle actions: scaffold vs upgrade, status vs check, and create_department vs refresh_departments are separable given their descriptions. The main overlap risk is between status (read state) and check (validate integrity), and among the several record-creation tools, but descriptions clarify boundaries enough.
The set is mostly snake_case, but it mixes bare single-word names (upgrade, status, check) with verb_noun names (scaffold_project, open_wave, read_guide) and uses different creation verbs (new_decision, create_department, open_wave). It remains readable, but the pattern is not predictable.
10 tools is well within a healthy range for managing a project framework lifecycle. Each tool appears to earn its place, covering setup, upgrade, status, code allocation, waves, decisions, departments, validation, and guidance.
The surface covers scaffolding, upgrading, inspecting, and several record-creation workflows, but there are notable gaps around the wave and backlog lifecycle: open_wave exists without a close/update wave operation, and next_code allocates codes without a clear tool to create backlog items. Department management also lacks removal or update beyond refresh.
AI work orchestration for plans, tasks, teams, and coding-agent dispatch.
Design, build and run teams of AI agents with checked handoffs between them.
One shared project for a team's coding agents: decisions, a task board and handoffs.
The AI orchestration agent for modern software teams.
