🚢 shipfast-mcp

Quy trình làm việc theo wave giữa PO và AI, đóng gói thành MCP server. AI làm Orchestrator: điều phối, đề xuất, phản biện; việc chuyên môn giao cho các bộ phận lập theo dự án, mỗi bộ phận là một subagent. Người làm PO: chốt và nghiệm thu. Dùng được cho mọi stack.

Trang giới thiệu: https://quoctang.github.io/shipfast-mcp/

A Model Context Protocol server that ships a wave-based PO ↔ AI working process (propose, critique, decide, build, verify) to any stack, with three-way-merge upgrades so projects never diff against a template repo by hand.

Table of Contents

• 🚀 Quick Start
• 🛠️ Installation
• 📦 Features
• 🤝 How to Contribute
• 💬 Community & Support
• 👥 Repo Contributors
• ⚖️ License
• 🌟 Star History

Quick Start

Cần uv. Trong Claude Code:

/plugin install shipfast --marketplace QuocTang/shipfast-mcp

Mở repo cần làm, gọi điểm vào phù hợp:

Sau đó làm việc như với một trưởng nhóm: nêu yêu cầu, trả lời theo mã ("W02-03: A"), nói "chốt" khi đồng ý phạm vi.

Installation

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.0.

Features

Vấn đề và cách giải

Vòng đời một wave

📥 Intake → 🗣️ Discussion → ✅ Scope lock → 🔨 Build → 🧹 Cleanup → 🧪 Acceptance → 🚀 Release, rút kinh nghiệm, đóng

Thành phần MCP

Nâng cấp không cần repo gốc

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.

Hướng dẫn

How to Contribute

Đóng góp được hoan nghênh, nhất là cách làm đã chạy thật ở dự án của bạn và dùng được cho mọi stack.

1. Fork repository.
2. Tạo nhánh mới cho thay đổi.
3. 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-mcp

Kho tri thức nằm ở src/shipfast_mcp/knowledge/: project/ (khung dựng vào dự án), skills/, guide/. Quyết định thiết kế: docs/decisions/README.md.

Community & Support

• Báo lỗi, đề xuất: GitHub Issues.
• Nếu repository giúp bạn tiết kiệm thời gian, hãy để lại một ⭐.

Repo Contributors

Made with contrib.rocks.

License

MIT License. See LICENSE for details.

Star History