AI Agent 协作基础设施 — 以 Ψ=Ψ(Ψ) 为第一性原理的智能体协作世界，遵循混沌→萃取→脱胎的双态孵化模型。

AgentForge 是一个 AI Agent 项目约定的开放标准制定与示范实现仓库。它的独特之处在于采用 双态架构：

混沌态 (Chaos)                    脱胎态 (Rebirth)
apps/chaos/         持续萃取      rebirth/
  原始孵化器        ──────────▶    社区标准
  自由探索、试错                   精炼、去个人化
  哲学内核、实验代码               WorldSprout 开放协议

• apps/chaos/ — 一切未精炼的原始探索：哲学内核（Ψ=Ψ(Ψ)、道德经）、实验性代码、个人知识库、技能生态。信息在此自由生长。
• rebirth/ — 从 chaos 持续萃取、去个人化后的精炼产出，以 git submodule 链接到 WorldSprout 组织，作为可独立发布的社区开放标准。

AGENTS.md 是一个独立的社区开放标准——只需在项目根目录放一个 AGENTS.md 文件，AI 工具就能自动读取项目指令。OpenAI Codex、Google Jules、GitHub Copilot、Cursor 等 30+ 工具原生支持，零依赖。

AgentForge 在此基础上提供渐进可选扩展（.agents/ 目录、world.toml、SKILL.md、constraints.toml）。二者关系类比：AGENTS.md ≈ Markdown，AgentForge ≈ CommonMark + GFM 扩展。

详见根目录 AGENTS.md（本项目的 AI 智能体全局契约）。

cd apps/chaos

# 安装依赖
uv sync --group dev --group docs

# 运行测试
uv run pytest

# 构建文档
mise run docs-html

直接读取根目录 AGENTS.md，它会按任务类型路由到正确的子项目规范。

cd rebirth

# 拉取所有子模块最新代码
git submodule update --remote

# 进入参考实现独立开发
cd worldsprout

AgentForge/
├── AGENTS.md              ← AI 智能体全局契约（最高优先级入口）
├── README.md              ← 本文件：人类开发者入口
├── LICENSE                ← Apache 2.0
│
├── apps/                  ← 应用层
│   ├── .agents/           ← 仓库级 AI 配置骨架
│   └── chaos/             ← 混沌态：原始孵化器
│       ├── AGENTS.md      ← chaos 子项目路由
│       ├── .agents/       ← 规则/技能/工作流/角色
│       ├── specs/         ← AgentForge Spec v0.2
│       └── src/taolib/    ← world CLI + 参考实现
│
├── docs/                  ← 人类文档（tech/ + general/ 双轨）
├── .github/workflows/     ← CI/CD 流水线
│
└── rebirth/               ← 脱胎态：WorldSprout 标准（git submodule）
    ├── worldsprout/       → github.com/worldsprout/worldsprout
    ├── spec/              → github.com/worldsprout/spec
    └── .github/           → github.com/worldsprout/.github

• 三层分离架构 (AgentForge Spec v0.2)：Layer 1 项目协议（零前提采用）→ Layer 2 协作协议（多智能体语义）→ Layer 3 世界运行时（示范实现）
• 哲学驱动工程：Ψ=Ψ(Ψ) 元公理 + 马王堆帛书《道德经》→ 极简设计原则 → 技术实施方案
• 约束即代码：constraints.toml 声明式协议 + CI 自动校验
• World CLI 工具链：world init 脚手架 / world guide 诊断推荐 / world fragment 打包分发
• GitHub App 令牌服务：自动化 Token 管理与事件处理
• 双平台 CI：GitHub Actions + GitCode 流水线，Sphinx 文档零警告

• WorldSprout 组织 — 脱胎后的社区开放标准
• taolib PyPI — Python 参考实现包
• 文档 — 完整技术文档与哲学体系
• AGENTS.md 开放标准 — 社区驱动的 AI 指令标准

Apache License 2.0 © LICENSE