shipfast-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
shipfast: quy trình làm việc theo wave giữa PO (người dùng), Orchestrator (phiên AI chính) và subagent, dùng được cho mọi stack.
Repo mới: dùng prompt
init(hoặc đọc skill://shipfast-init/SKILL.md). Dự án đang chạy: promptadopt.Dự án đã có
.shipfast/manifest.json: đọcCLAUDE.mdvàdocs/04_waves/README.mdcủa dự án, gọi toolstatustrước khi làm việc. Luật quy trình nằm trong skill://shipfast-process/SKILL.md.Nâng khung lên phiên bản mới: tool
upgrade(chạy dry_run trước). Không cần repo gốc để so sánh.Tài liệu cho người: tool
read_guide. Mọi tool ghi file nhậnproject_dirlà đường dẫn tuyệt đối tới gốc repo dự án.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": true
} |
| resources | {
"subscribe": false,
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| scaffold_projectA | 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. |
| upgradeA | 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. |
| statusC | 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. |
| next_codeB | 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ố. |
| open_waveA | 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. |
| new_decisionA | 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. |
| create_departmentA | 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). |
| refresh_departmentsA | 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. |
| checkB | 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. |
| read_guideA | Đọ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. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| init | Khởi tạo dự án mới theo quy trình shipfast: chạy wave W01, AI đề xuất và phản biện stack, PO chốt. |
| adopt | Áp quy trình shipfast vào dự án đang chạy, giữ tài liệu và quyết định sẵn có. |
| upgrade | Nâng khung quy trình của dự án lên phiên bản shipfast mới, gộp với phần dự án đã sửa. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| guide-changelog | |
| guide-evolve | |
| guide-organization | |
| guide-purpose | |
| guide-start | |
| shipfast-adopt/SKILL.md | Áp quy trình shipfast vào một dự án đang chạy (đã có code, có thể đã có tài liệu, decision log, quy trình riêng) mà không phá cái đang có. Dùng khi người dùng nói "áp quy trình vào dự án này", "cài shipfast cho repo đang có", gọi prompt adopt của MCP shipfast, hoặc repo đã có code nhưng chưa có .shipfast/. |
| shipfast-adopt/_manifest | File listing for shipfast-adopt |
| shipfast-upgrade/SKILL.md | Nâng khung quy trình shipfast của dự án lên phiên bản mới mà không cần repo gốc hay so sánh tay - tool upgrade tự three-way merge, Orchestrator trình PO các thay đổi và giải quyết xung đột. Dùng khi người dùng nói "nâng cấp quy trình", "cập nhật shipfast", "update template", hoặc tool status báo có phiên bản khung mới. |
| shipfast-upgrade/_manifest | File listing for shipfast-upgrade |
| shipfast-init/SKILL.md | Khởi tạo dự án mới theo quy trình shipfast từ một repo trống hoặc gần trống - chạy wave W01 (trao đổi, đề xuất và phản biện stack, chốt), scaffold tài liệu, dựng bộ khung code theo stack đã chốt, chạy được và acceptance. Dùng khi người dùng nói "khởi tạo dự án", "setup dự án mới", "bắt đầu dự án", gọi prompt init của MCP shipfast, hoặc repo chưa có .shipfast/ và chưa có code. |
| shipfast-init/_manifest | File listing for shipfast-init |
| shipfast-debate/SKILL.md | Tổ chức debate nhiều vai trong quy trình shipfast - AI đóng các vai phản biện (người dùng, sản phẩm, kiến trúc, an toàn, vận hành, QA, phản biện tự do) hoặc các bộ phận đã lập, viết lập trường độc lập R1, phản biện chéo R2, rồi tổng hợp cho PO hoặc Chủ toạ phán quyết. Dùng khi một vấn đề có nhiều phương án ngang nhau, rủi ro cao, PO muốn "phản biện", "debate", "xem các góc nhìn", hoặc wave chạy chế độ delegation. |
| shipfast-debate/_manifest | File listing for shipfast-debate |
| shipfast-wave/SKILL.md | Chạy một wave shipfast từ intake tới đóng - mở wave, thảo luận và chốt với PO, viết phạm vi, giao việc cho các bộ phận, cleanup, acceptance, release, rút kinh nghiệm. Dùng khi người dùng muốn làm tính năng hoặc nhóm việc mới, nói "mở wave", "W0x", "chốt", "acceptance", "đóng wave", hoặc khi wave đang mở cần đi tiếp bước sau. |
| shipfast-wave/_manifest | File listing for shipfast-wave |
| shipfast-process/SKILL.md | Luật nền của quy trình shipfast (PO, Orchestrator, subagent; làm việc theo wave; decision log; mã BL/Wxx/CR/SP/KT/QT). Dùng mỗi khi làm việc trong repo có thư mục .shipfast/ hoặc docs/04_waves/, trước khi viết code, nhận việc mới, trả lời PO, mở hay đóng wave, ghi quyết định, hoặc khi người dùng hỏi "đang tới đâu", "làm tiếp". |
| shipfast-process/_manifest | File listing for shipfast-process |
TDQS
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.