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.

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

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

Features

Vòng đời một wave

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

Thành phần MCP

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.

Hướng dẫn

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.

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), 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