Cortex Agent

🧠 Cortex Agent Framework

**Cortex Agent** 是一个为 AI 编程助手（Cursor、Claude Code、Windsurf、Gemini CLI 等）设计的治理与指令框架。它通过一套结构化的**规则 (Rules)**、**工作流 (Workflows)** 和**技能 (Skills)**，将 AI 从简单的代码生成器提升为具有架构意识和工程规范的"资深工程师"。

核心价值

• 架构一致性：强制 AI 遵循项目预定义的架构模式（六边形、分层、微服务等）。
• 专业化委托：核心执行 Sub-agent（planner / implementer / researcher / code-reviewer / documenter）与治理型 Sub-agent 分工协作，职责隔离。
• 上下文预算控制：context-budget skill 按 Tier 0-3 分级裁剪上下文，将有效负载控制在窗口 40% 以内。
• 推理三明治：/ship 按 规划(premium) → 执行(standard) → 验证(standard) 分配模型算力，兼顾质量与成本。
• 结构化交接：/handoff 为跨 Agent、跨会话和 sub-agent 接力生成轻量交接文档，避免依赖对话记忆。
• 提案包共享：/proposal-share 将提案组（proposals + missions + topology + 双仓 peer 卷）打包为自包含 tar.gz，跨开发者/跨仓库共享提案目录；绝对路径 token 化 + 符号链接重建，与 /handoff（运行时状态）互补。
• 长周期任务编排：/mission 通过 milestone、验证契约和命令日志支撑多阶段任务稳定推进。
• 协作运行时 (Communication Runtime)：management-api 提供 inbox / decisions / waitpoints 三个通信对象，所有写入受 workflow gate（mission / user / owner / requester / recipient / workflow）约束；Dashboard、CLI 与可选的 MCP 只读适配器共享同一查询投影。详见 协作运行时设计。
• 熵治理闭环：entropy-scanner 周期扫描知识库漂移，PostCommit Hook 自动修复，保持 .agent/ 长期健康。
• 工具无关：同一套 .agent/ 配置通过符号链接和指令文件适配 11 个主流 AI 平台。

知识层理念 / Knowledge Layer Philosophy

cortex-agent 的 `.agent/references/`、`.agent/workflows/`、`.agent/rules/` 和 `.agent/decisions/` 共同构成项目级的**可验证知识层**，对标 **OKF (Open Knowledge Format) V0.2** 的陈述性知识可信度机制。这不是一个静态 Wiki，而是一套 agent-first 的知识工程基础设施：知识必须有生命周期、可以被自动校验、可以追溯到决策，并且通过 frontmatter 元数据实现程序化消费。

四层知识栈 / 4-Layer Knowledge Stack

层	目录	知识类型	约束	消费方
L0 源代码	lib/ src/ 等	可执行事实	lint / test / type-check	人类 + Agent
L1 程序性知识	.agent/workflows/ .agent/scripts/	工作流（怎么做事）	validate-frontmatter.js 强制必填字段	Agent 调度器
L2 约束性知识	.agent/rules/	规则（什么能做、什么不能做）	knowledge-lint R-LINT 系列规则	Agent 上下文注入
L3 陈述性知识	.agent/references/	模块参考文档（现状是什么）	`knowled