Archcore 是一个面向 AI 编程智能体的规格驱动开发与 Git 原生上下文工程工具。它解决的核心问题是：编程智能体虽然能写代码，但不了解你的项目——功能应该做什么、代码应该放在哪里、哪些决策和规则已经生效。因此智能体会猜测，而你需要在下一次会话中重复解释同样的事情。Archcore 将规格、架构、决策、规则和计划保存在 Git 中，并在 AI 编程智能体工作时提供正确的项目上下文，帮助智能体做出符合仓库架构、规则和过往决策的修改。
主要能力 Archcore 提供三个核心命令，可以单独使用，也可以组合用于同一次变更：
-
/archcore:plan：在构建之前进行规划。智能体首先读取仓库和现有文档，然后只询问文档中找不到的信息。你的回答会成为 .archcore/ 中的文档：包含需求的规格，以及将任务映射到文件的计划。面向用户的变更还会获得 Given/When/Then 形式的示例。较大的工作可以添加 PRD、研究或正式需求链。Archcore 会权衡变更、计算路线，并报告从 S 到 XL 的大小，你无需选择模板或大小。风险会提高大小：安全需求会增加正式需求链，数据迁移会增加迁移运行手册。随后智能体根据规格、示例和任务进行实现，开放性问题在代码之前解决，而不是之后。
-
/archcore:document：边说边记录。你的一句话会变成一份完整、链接的文档。/archcore:document 记录当前为真的事项：一个决策、团队标准、模块如何工作或操作指南。你无需选择格式，Archcore 会选择文档类型，读取代码和现有文档，并检查文档是否已存在。它只询问找不到的信息，并将新文档链接到相关文档。一个决策还可以产生随之而来的规则和指南。如果没有主题，/archcore:document 会读取分支上的变更，并询问一个关于要记录什么的问题。文档比会话更长久，它与代码一起存放在 Git 中，具有状态（先 draft，后 accepted），审查时会对照代码检查。
-
/archcore:review：合并前审查。当文档覆盖变更时，/archcore:review 会双向比较分支与文档。每个发现都会指出不一致的代码和文档，并给出一个判定：code-wrong（代码破坏了仍然有效的文档）或 spec-wrong（文档已过时）。你修复正确的一方。当计划覆盖分支时，审查会检查其任务，并在工作完成时关闭计划。当没有文档覆盖变更时，审查仍会对照项目已有的决策和规则检查分支。如果分支重复了没有文档记录的模式，审查会提议记录它。要记录没有计划就发布的工作，请运行 /archcore:document。
使用方式 在 macOS、Linux 或 WSL 上，以及 Windows（PowerShell 5.1+）上，安装程序会添加 CLI 以及 Claude Code、Codex CLI 和 GitHub Copilot CLI 的插件（如果找到）。archcore init 会将你选择的智能体连接到当前项目。它还支持 Gemini CLI、OpenCode、Roo Code 和 Cline。Cursor 需要额外一步设置。如果你已有 CLAUDE.md、AGENTS.md 或规则文件，可以在智能体中输入 /archcore:init import 将它们转换为项目文档。文档保留在你的仓库中，位于 .archcore/ 目录。
斜杠命令可在 Claude Code、Cursor、Codex CLI 和 GitHub Copilot 中运行。在每个连接的智能体中，普通句子也可以工作，例如“Plan [your feature]”、“Record why we chose [X]”、“Review my branch”。
适用场景 Archcore 适用于希望 AI 编程智能体遵循项目架构、规则和过往决策的团队或个人开发者。它特别适合需要规格驱动开发、上下文工程、以及希望将项目知识以文档形式与代码一起版本化的场景。通过将项目知识变为文件，每个命令都会在 .archcore/ 中留下纯 Markdown，与它所描述的代码一起版本化。文档类型在文件名中体现。规格只是上下文的一部分，决策、规则、计划和指南与它并存。对文档的更改就是拉取请求中的差异，就像对代码的更改一样。
限制 Archcore 需要与支持的 AI 编程智能体配合使用，包括 Claude Code、Cursor、Codex CLI、GitHub Copilot、Gemini CLI、OpenCode、Roo Code 和 Cline。Cursor 需要额外设置步骤。文档存储在 .archcore/ 目录中，需要 Git 仓库。关于隐私的详细信息，请参考项目文档。Archcore 采用 Apache 2.0 许可证，源代码在 dev 分支上。
