Skip to content

docs: connect the open product to TMPA and FCoP #13

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
joinwell52-AI merged 1 commit into from
Aug 12, 2026
Merged

docs: connect the open product to TMPA and FCoP #13

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 17 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,11 @@
<a href="README.zh.md">Simplified Chinese README</a> ·
<a href="#quick-install">Quick Install</a> ·
<a href="#real-product-screens">Product Screens</a> ·
<a href="https://joinwell52-ai.github.io/CodeFlowMu-open/"><strong>Product Site</strong></a> ·
<a href="https://github.com/joinwell52-AI/FCoP">FCoP GitHub</a> ·
<a href="https://joinwell52-ai.github.io/FCoP/">FCoP Site</a> ·
<a href="https://github.com/joinwell52-AI/joinwell52">TMPA</a> ·
<a href="https://joinwell52-ai.github.io/joinwell52/">Digital Employee Works</a> ·
<a href="INSTALL.md">Installation Guide</a> ·
<a href="docs/open/help.md">Illustrated PC & PWA Manual</a>
</p>
Expand All @@ -36,12 +41,24 @@ Full release record：[RELEASES.md](RELEASES.md)

CodeFlowMu Open is a local-first multi-agent development team application. You submit a requirement; PM analyzes and dispatches it, DEV implements it, OPS handles runtime and delivery, and QA verifies it. Tasks, reports, evidence, approvals, and project state are visible in the PC Panel and available from the Mobile PWA.

> **Current provider boundary:** this open product connects to agents through **Cursor SDK / Cursor API Key only**. Provider-neutral interfaces are future extension points; this release does not include or claim support for other agent providers.

It is not another chat window. It gives multiple agents one traceable delivery lifecycle:

```text
Requirement → PM Plan → TASK → DEV / OPS / QA → REPORT → REVIEW / APPROVAL → Done
```

## Project family

| Layer | Project | Role |
|---|---|---|
| Theory and specification | [TMPA](https://github.com/joinwell52-AI/joinwell52) · [Site](https://joinwell52-ai.github.io/joinwell52/) | Governance architecture, normative Core, conformance, and evidence |
| Protocol | [FCoP GitHub](https://github.com/joinwell52-AI/FCoP) · [Site](https://joinwell52-ai.github.io/FCoP/) | MIT-licensed file-based behavior-governance protocol used for durable team artifacts |
| Product | **CodeFlowMu Open** · [Site](https://joinwell52-ai.github.io/CodeFlowMu-open/) | This installable MIT-licensed four-role development team; currently Cursor-only |

The broader research and product map is available at [Digital Employee Works](https://joinwell52-ai.github.io/joinwell52/).

## Core Capabilities

| Capability | What it provides |
Expand Down
17 changes: 17 additions & 0 deletions README.zh.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,11 @@
<a href="README.md">English README</a> ·
<a href="#快速安装">快速安装</a> ·
<a href="#真实界面">真实界面</a> ·
<a href="https://joinwell52-ai.github.io/CodeFlowMu-open/"><strong>产品主页</strong></a> ·
<a href="https://github.com/joinwell52-AI/FCoP">FCoP GitHub</a> ·
<a href="https://joinwell52-ai.github.io/FCoP/">FCoP 主页</a> ·
<a href="https://github.com/joinwell52-AI/joinwell52">TMPA</a> ·
<a href="https://joinwell52-ai.github.io/joinwell52/zh/">Digital Employee Works</a> ·
<a href="INSTALL.md">安装手册</a> ·
<a href="docs/open/help.zh.md">PC 与 PWA 操作手册</a>
</p>
Expand All @@ -36,12 +41,24 @@

CodeFlowMu Open 是一个本地优先的多 Agent 开发团队应用。你提交需求，PM 负责分析和派发，DEV 实现，OPS 处理运行与交付，QA 验证；任务、报告、证据、审批和项目状态统一呈现在 PC Panel，并可通过手机 PWA 随时查看和操作。

> **当前 Provider 边界：**这个开源产品目前只通过 **Cursor SDK / Cursor API Key** 接入 Agent。Provider-neutral 接口属于未来扩展点；当前发行版不包含、也不宣称支持其他 Agent Provider。

它解决的不是“再增加一个聊天窗口”，而是让多个 Agent 围绕同一套可追踪的任务生命周期协作：

```text
需求 → PM 规划 → TASK → DEV / OPS / QA → REPORT → REVIEW / APPROVAL → 完成
```

## 项目家族

| 层级 | 项目 | 定位 |
|---|---|---|
| 理论与规范 | [TMPA](https://github.com/joinwell52-AI/joinwell52) · [主页](https://joinwell52-ai.github.io/joinwell52/zh/) | 治理架构、规范 Core、符合性测试与证据 |
| 协议 | [FCoP GitHub](https://github.com/joinwell52-AI/FCoP) · [主页](https://joinwell52-ai.github.io/FCoP/) | MIT 开源文件式行为治理协议，承载团队的持久工作工件 |
| 产品 | **CodeFlowMu Open** · [主页](https://joinwell52-ai.github.io/CodeFlowMu-open/) | 当前这个 MIT 开源、可安装的四人开发团队产品；目前只对接 Cursor |

完整研究与产品地图：[Digital Employee Works](https://joinwell52-ai.github.io/joinwell52/zh/)。

## 为什么需要它

普通 Agent 工具通常只解决“让一个 AI 回答问题”。CodeFlowMu 关注的是团队协作：谁接收需求、谁实施、谁验证、交付证据在哪里、哪些动作需要人类批准，以及一个任务为什么完成或阻塞。
Expand Down
Loading