FCoP

A protocol so small the agents already obey it before being told. 一个小到 agent 不用被教就已经遵守的协议。

FCoP is a minimal protocol that lets multiple AI agents — running in Cursor, Claude Code, plain shells, CI runners — collaborate through ordinary markdown files in a folder. Agents write TASK-*.md when they're starting work, REPORT-*.md when they're done, ISSUE-*.md when they need clarification.

No message bus. No new framework. No vendor lock-in. The whole protocol is one document and four file conventions, MIT-licensed.

It came out of field observation: agents kept inventing this exact pattern on their own, three independent times, across unrelated tasks. We just wrote down what they were already doing — then archived a Zenodo DOI for it.

FCoP 是一个极小的协议，让运行在 Cursor、Claude Code、普通 shell、CI runner 里的多个 AI agent，通过一个文件夹里的普通 markdown 文件互相协作。Agent 开始干活时写一份 TASK-*.md，干完写一份 REPORT-*.md，需要澄清写一份 ISSUE-*.md。

没有消息总线。没有新框架。没有 vendor lock-in。整个协议就是一份文档加四条文件命名约定，MIT 许可。

它来自现场观察：agent 自己在三次互不相干的场景里都不约而同地发明了这同一种模式。我们只是把它们已经在做的事写下来 —— 然后给它打了个 Zenodo DOI 备案。

From zero to a 2-agent team in 90 seconds. 90 秒内从零到一个 2-agent 团队。

Three steps. Tested on Cursor, but the protocol itself is host-neutral — any MCP-capable IDE or even a plain shell works. 三步。在 Cursor 上验证过，但协议本身是 host-neutral 的——任何支持 MCP 的 IDE 甚至 纯 shell 都能用。

pipx install fcop-mcp

{
  "mcpServers": {
    "fcop": {
      "command": "fcop-mcp"
    }
  }
}

Initialize me as a solo developer
using FCoP. Then build me a working
Tetris-style game.用 FCoP 把我初始化成单兵开发者。
然后给我做一个能跑的俄罗斯方块。

Need a complete walk-through? See the English Tetris tutorial (full dogfood, 22 screenshots) or the 中文 Snake 教程. 需要完整走查？看 中文贪吃蛇教程（完整 dogfood，18 张截图）或 英文 Tetris 教程。

Six essays. Command the agents — FCoP brings discipline to an AI team. 六篇 essay。指挥 agent —— FCoP 让 AI 团队有纪律。

Two real dogfoods. Every step on disk. 两次真实 dogfood。每一步都在磁盘上。

中文 · Snake

Solo to 2-Person AI Crew (Chinese Snake) 从单兵到 2 人 AI 队（贪吃蛇案例）

18 dogfood screenshots. Captures a real PLANNER-impersonating-CODER easter egg from the 0.6.x era — surfaced by the protocol itself, not by us.

18 张 dogfood 截图。抓到一个 0.6.x 时代真实的 PLANNER 冒充 CODER 彩蛋——是协议自己浮出来的，不是我们抓的。

GitHub 中文 CSDN

English · Tetris

Solo to 2-Person AI Crew (English Tetris) 从单兵到 2 人 AI 队（俄罗斯方块案例）

22 dogfood screenshots, 14 TASK/REPORT files, 8 silent role-switch evidence files, 2 game artefacts, 2 verbatim agent-interview transcripts. The dogfood that became Essay 06.

22 张 dogfood 截图、14 份 TASK/REPORT、8 份静默 role-switch 证据、2 个游戏产物、2 份逐字 agent 访谈。这次 dogfood 变成了 Essay 06。

GitHub EN 中文译本 Dev.to Cursor Forum

Citable. DOI-archived. CFF-ready. 可引用。已归档 DOI。CITATION.cff 就绪。

FCoP is archived on Zenodo as a research snapshot. GitHub renders a "Cite this repository" button automatically from the included CITATION.cff. FCoP 已经作为 research snapshot 归档到 Zenodo。GitHub 会自动从仓库根的 CITATION.cff 渲染一个 "Cite this repository" 按钮。

10.5281/zenodo.19886036

Research snapshot, April 2026 Research snapshot, 2026 年 4 月

Copy BibTeX 复制 BibTeX

@misc{zhu_fcop_2026,
  author       = {Zhu, Wei},
  title        = {{FCoP}: A File-based Coordination Protocol
                  for Multi-Agent AI Systems},
  year         = 2026,
  month        = apr,
  publisher    = {Zenodo},
  doi          = {10.5281/zenodo.19886036},
  url          = {https://doi.org/10.5281/zenodo.19886036},
  note         = {Research snapshot 2026-04-29}
}