agents-brain 用于把仓库内的智能体上下文作为一套连贯系统来维护，主要面向 README.md、AGENTS.md（以及旧版 Claude Code 所需的 CLAUDE.md 符号链接）、.agents/skills 下已安装的项目技能、skills/<name>/ 下符合条件的源目录技能，以及其他为智能体或人类提供长期指导的 Markdown 上下文文档。
主要路由有两个：maintain [path] [target ...] [flags] 用于上下文维护和基于任务证据的技能生命周期变更，默认用于维护或检查；create-skill [skill-name] 用于按明确请求创建项目本地技能，创建前需应用仓库目录守卫，明确创建不要求重复使用证据。
维护时以仓库证据支撑内容，尊重受众与范围，只保留能改变行为、防止已证实错误或提供不可发现约束的内容，并通过仓库定义的最窄验证。支持 --dry-run、--preserve、--minimal、--thorough/--full、--force、--root-only 等参数；--minimal 与 --thorough/--full 同时出现时不写入并要求用户选择。删除 README.md、AGENTS.md、常规 CLAUDE.md 或上下文文档目标前需明确确认，--force 不授权删除。
运行前有仓库守卫：拒绝在文件系统根目录或非 git 仓库中运行，拒绝在受管智能体配置仓库内编辑已安装技能，要求到源目录修改。Claude Code v2.1.277 及以上原生读取 AGENTS.md，此时不再创建 CLAUDE.md 符号链接，并删除指向同级 AGENTS.md 的符号链接。
涉及编写或修改面向智能体的提示、技能等文本时，需先完整阅读 references/asd-ste100.md，并按需运行 scripts/fetch-guidance.sh 获取 Anthropic 与 OpenAI 指南；仅做其他编辑时跳过并报告。缓存指南 24 小时内有效，可用 --refresh 强制刷新。
限制：仅限仓库边界内写入，不进行外部写入；不提供后台监控或全目录审计；安装与技能管理属于独立工作流；具体收费、平台支持等信息暂未提供。