# ruflo - Doramagic AI Context Pack

> 定位：安装前体验与判断资产。它帮助宿主 AI 有一个好的开始，但不代表已经安装、执行或验证目标项目。

## 充分原则

- **充分原则，不是压缩原则**：AI Context Pack 应该充分到让宿主 AI 在开工前理解项目价值、能力边界、使用入口、风险和证据来源；它可以分层组织，但不以最短摘要为目标。
- **压缩策略**：只压缩噪声和重复内容，不压缩会影响判断和开工质量的上下文。

## 给宿主 AI 的使用方式

你正在读取 Doramagic 为 ruflo 编译的 AI Context Pack。请把它当作开工前上下文：帮助用户理解适合谁、能做什么、如何开始、哪些必须安装后验证、风险在哪里。不要声称你已经安装、运行或执行了目标项目。

## Claim 消费规则

- **事实来源**：Repo Evidence + Claim/Evidence Graph；Human Wiki 只提供显著性、术语和叙事结构。
- **事实最低状态**：`supported`
- `supported`：可以作为项目事实使用，但回答中必须引用 claim_id 和证据路径。
- `weak`：只能作为低置信度线索，必须要求用户继续核实。
- `inferred`：只能用于风险提示或待确认问题，不能包装成项目事实。
- `unverified`：不得作为事实使用，应明确说证据不足。
- `contradicted`：必须展示冲突来源，不得替用户强行选择一个版本。

## 它最适合谁

- **正在使用 Claude/Codex/Cursor/Gemini 等宿主 AI 的开发者**：README 或插件配置提到多个宿主 AI。 证据：`README.md` Claim：`clm_0004` supported 0.86
- **希望把专业流程带进宿主 AI 的用户**：仓库包含 Skill 文档。 证据：`.agents/skills/agent-adaptive-coordinator/SKILL.md`, `.agents/skills/agent-agent/SKILL.md`, `.agents/skills/agent-agentic-payments/SKILL.md`, `.agents/skills/agent-analyze-code-quality/SKILL.md` 等 Claim：`clm_0005` supported 0.86

## 它能做什么

- **AI Skill / Agent 指令资产库**（可做安装前预览）：项目包含可被宿主 AI 读取的 Skill 或 Agent 指令文件，可用于把专业流程带入 Claude、Codex、Cursor 等宿主。 证据：`.agents/skills/agent-adaptive-coordinator/SKILL.md`, `.agents/skills/agent-agent/SKILL.md`, `.agents/skills/agent-agentic-payments/SKILL.md`, `.agents/skills/agent-analyze-code-quality/SKILL.md` 等 Claim：`clm_0001` supported 0.86
- **多宿主安装与分发**（需要安装后验证）：项目包含插件或 marketplace 配置，说明它面向一个或多个 AI 宿主的安装和分发。 证据：`.claude-plugin/marketplace.json`, `.claude-plugin/plugin.json`, `plugin/.claude-plugin/plugin.json`, `plugins/ruflo-adr/.claude-plugin/plugin.json` 等 Claim：`clm_0002` unverified 0.25
- **命令行启动或安装流程**（需要安装后验证）：项目文档中存在可执行命令，真实使用需要在本地或宿主环境中运行这些命令。 证据：`.claude-plugin/docs/QUICKSTART.md`, `AGENTS.md`, `README.md`, `v3/@claude-flow/neural/docs/SONA_QUICKSTART.md` Claim：`clm_0003` supported 0.86

## 怎么开始

- `/plugin marketplace add ruvnet/ruflo` 证据：`README.md` Claim：`clm_0006` supported 0.86
- `/plugin install ruflo-core@ruflo` 证据：`README.md` Claim：`clm_0007` supported 0.86
- `/plugin install ruflo-swarm@ruflo` 证据：`README.md` Claim：`clm_0008` supported 0.86
- `/plugin install ruflo-rag-memory@ruflo` 证据：`README.md` Claim：`clm_0009` supported 0.86
- `/plugin install ruflo-neural-trader@ruflo` 证据：`README.md` Claim：`clm_0010` supported 0.86
- `curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash` 证据：`README.md` Claim：`clm_0011` supported 0.86
- `npx ruflo@latest init wizard` 证据：`README.md` Claim：`clm_0012` supported 0.86
- `npm install -g ruflo@latest` 证据：`README.md` Claim：`clm_0013` supported 0.86
- `claude mcp add ruflo -- npx ruflo@latest mcp start` 证据：`README.md` Claim：`clm_0014` supported 0.86
- `npx claude-flow@latest federation init` 证据：`README.md` Claim：`clm_0015` supported 0.86

## 继续前判断卡

- **当前建议**：需要管理员/安全审批
- **为什么**：继续前可能涉及密钥、账号、外部服务或敏感上下文，建议先经过管理员或安全审批。

### 30 秒判断

- **现在怎么做**：需要管理员/安全审批
- **最小安全下一步**：先跑 Prompt Preview；若涉及凭证或企业环境，先审批再试装
- **先别相信**：工具权限边界不能在安装前相信。
- **继续会触碰**：命令执行、宿主 AI 配置、本地环境或项目文件

### 现在可以相信

- **适合人群线索：正在使用 Claude/Codex/Cursor/Gemini 等宿主 AI 的开发者**（supported）：有 supported claim 或项目证据支撑，但仍不等于真实安装效果。 证据：`README.md` Claim：`clm_0004` supported 0.86
- **适合人群线索：希望把专业流程带进宿主 AI 的用户**（supported）：有 supported claim 或项目证据支撑，但仍不等于真实安装效果。 证据：`.agents/skills/agent-adaptive-coordinator/SKILL.md`, `.agents/skills/agent-agent/SKILL.md`, `.agents/skills/agent-agentic-payments/SKILL.md`, `.agents/skills/agent-analyze-code-quality/SKILL.md` 等 Claim：`clm_0005` supported 0.86
- **能力存在：AI Skill / Agent 指令资产库**（supported）：可以相信项目包含这类能力线索；是否适合你的具体任务仍要试用或安装后验证。 证据：`.agents/skills/agent-adaptive-coordinator/SKILL.md`, `.agents/skills/agent-agent/SKILL.md`, `.agents/skills/agent-agentic-payments/SKILL.md`, `.agents/skills/agent-analyze-code-quality/SKILL.md` 等 Claim：`clm_0001` supported 0.86
- **能力存在：命令行启动或安装流程**（supported）：可以相信项目包含这类能力线索；是否适合你的具体任务仍要试用或安装后验证。 证据：`.claude-plugin/docs/QUICKSTART.md`, `AGENTS.md`, `README.md`, `v3/@claude-flow/neural/docs/SONA_QUICKSTART.md` Claim：`clm_0003` supported 0.86
- **存在 Quick Start / 安装命令线索**（supported）：可以相信项目文档出现过启动或安装入口；不要因此直接在主力环境运行。 证据：`README.md` Claim：`clm_0006` supported 0.86

### 现在还不能相信

- **工具权限边界不能在安装前相信。**（unverified）：MCP/tool 类项目通常会触碰文件、网络、浏览器或外部 API，必须真实检查权限和日志。
- **真实输出质量不能在安装前相信。**（unverified）：Prompt Preview 只能展示引导方式，不能证明真实项目中的结果质量。
- **宿主 AI 版本兼容性不能在安装前相信。**（unverified）：Claude、Cursor、Codex、Gemini 等宿主加载规则和版本差异必须在真实环境验证。
- **不会污染现有宿主 AI 行为，不能直接相信。**（inferred）：Skill、plugin、AGENTS/CLAUDE/GEMINI 指令可能改变宿主 AI 的默认行为。 证据：`.agents/skills/agent-adaptive-coordinator/SKILL.md`, `.agents/skills/agent-agent/SKILL.md`, `.agents/skills/agent-agentic-payments/SKILL.md`, `.agents/skills/agent-analyze-code-quality/SKILL.md` 等
- **可安全回滚不能默认相信。**（unverified）：除非项目明确提供卸载和恢复说明，否则必须先在隔离环境验证。
- **真实安装后是否与用户当前宿主 AI 版本兼容？**（unverified）：兼容性只能通过实际宿主环境验证。 证据：`.claude-plugin/marketplace.json`, `.claude-plugin/plugin.json`, `plugin/.claude-plugin/plugin.json`, `plugins/ruflo-adr/.claude-plugin/plugin.json` 等
- **项目输出质量是否满足用户具体任务？**（unverified）：安装前预览只能展示流程和边界，不能替代真实评测。
- **安装命令是否需要网络、权限或全局写入？**（unverified）：这影响企业环境和个人环境的安装风险。 证据：`README.md`

### 继续会触碰什么

- **命令执行**：包管理器、网络下载、本地插件目录、项目配置或用户主目录。 原因：运行第一条命令就可能产生环境改动；必须先判断是否值得跑。 证据：`.claude-plugin/docs/QUICKSTART.md`, `AGENTS.md`, `README.md`, `v3/@claude-flow/neural/docs/SONA_QUICKSTART.md`
- **宿主 AI 配置**：Claude/Codex/Cursor/Gemini/OpenCode 等宿主的 plugin、Skill 或规则加载配置。 原因：宿主配置会改变 AI 后续工作方式，可能和用户已有规则冲突。 证据：`.agents/skills/agent-adaptive-coordinator/SKILL.md`, `.agents/skills/agent-agent/SKILL.md`, `.agents/skills/agent-agentic-payments/SKILL.md`, `.agents/skills/agent-analyze-code-quality/SKILL.md` 等
- **本地环境或项目文件**：安装结果、插件缓存、项目配置或本地依赖目录。 原因：安装前无法证明写入范围和回滚方式，需要隔离验证。 证据：`.claude-plugin/docs/QUICKSTART.md`, `.claude-plugin/marketplace.json`, `.claude-plugin/plugin.json`, `AGENTS.md` 等
- **环境变量 / API Key**：项目入口文档明确出现 API key、token、secret 或账号凭证配置。 原因：如果真实安装需要凭证，应先使用测试凭证并经过权限/合规判断。 证据：`CLAUDE.md`, `docs/USERGUIDE.md`, `docs/benchmarks/submission/reproduction.md`, `docs/security/socket-baseline.md` 等
- **宿主 AI 上下文**：AI Context Pack、Prompt Preview、Skill 路由、风险规则和项目事实。 原因：导入上下文会影响宿主 AI 后续判断，必须避免把未验证项包装成事实。

### 最小安全下一步

- **先跑 Prompt Preview**：用安装前交互式试用判断工作方式是否匹配，不需要授权或改环境。（适用：任何项目都适用，尤其是输出质量未知时。）
- **只在隔离目录或测试账号试装**：避免安装命令污染主力宿主 AI、真实项目或用户主目录。（适用：存在命令执行、插件配置或本地写入线索时。）
- **先备份宿主 AI 配置**：Skill、plugin、规则文件可能改变 Claude/Cursor/Codex 的默认行为。（适用：存在插件 manifest、Skill 或宿主规则入口时。）
- **不要使用真实生产凭证**：环境变量/API key 一旦进入宿主或工具链，可能产生账号和合规风险。（适用：出现 API、TOKEN、KEY、SECRET 等环境线索时。）
- **安装后只验证一个最小任务**：先验证加载、兼容、输出质量和回滚，再决定是否深用。（适用：准备从试用进入真实工作流时。）

### 退出方式

- **保留安装前状态**：记录原始宿主配置和项目状态，后续才能判断是否可恢复。
- **准备移除宿主 plugin / Skill / 规则入口**：如果试装后行为异常，可以把宿主 AI 恢复到试装前状态。
- **记录安装命令和写入路径**：没有明确卸载说明时，至少要知道哪些目录或配置需要手动清理。
- **准备撤销测试 API key 或 token**：测试凭证泄露或误用时，可以快速止损。
- **如果没有回滚路径，不进入主力环境**：不可回滚是继续前阻断项，不应靠信任或运气继续。

## 哪些只能预览

- 解释项目适合谁和能做什么
- 基于项目文档演示典型对话流程
- 帮助用户判断是否值得安装或继续研究

## 哪些必须安装后验证

- 真实安装 Skill、插件或 CLI
- 执行脚本、修改本地文件或访问外部服务
- 验证真实输出质量、性能和兼容性

## 边界与风险判断卡

- **把安装前预览误认为真实运行**：用户可能高估项目已经完成的配置、权限和兼容性验证。 处理方式：明确区分 prompt_preview_can_do 与 runtime_required。 Claim：`clm_0030` inferred 0.45
- **宿主 AI 插件或 Skill 规则冲突**：新规则可能改变用户现有宿主 AI 的工作方式。 处理方式：安装前先检查插件 manifest 和 Skill 文件，必要时隔离测试。 证据：`.claude-plugin/marketplace.json`, `.claude-plugin/plugin.json`, `plugin/.claude-plugin/plugin.json`, `plugins/ruflo-adr/.claude-plugin/plugin.json` 等 Claim：`clm_0031` inferred 0.45
- **命令执行会修改本地环境**：安装命令可能写入用户主目录、宿主插件目录或项目配置。 处理方式：先在隔离环境或测试账号中运行。 证据：`.claude-plugin/docs/QUICKSTART.md`, `AGENTS.md`, `README.md`, `v3/@claude-flow/neural/docs/SONA_QUICKSTART.md` Claim：`clm_0032` supported 0.86
- **源文档冲突：skill_count**：项目文档中存在数量表述不一致，AI Context Pack 必须提示用户不要把单一数字当作已验证事实。 处理方式：在 Human Manual 和 AI Context Pack 中共同标记为待核实，而不是强行选择一个数字。 证据：`plugins/ruflo-cost-tracker/docs/adrs/0003-implementation-arc-v0.5-to-v0.15.md`, `v3/implementation/integration/AGENTS-SKILLS-COMMANDS-HOOKS.md`, `v3/implementation/adrs/ADR-071-guidance-tools-mcp-fixes.md`, `docs/USERGUIDE.md` 等 Claim：`clm_0033` inferred 0.45
- **源文档冲突：agent_count**：项目文档中存在数量表述不一致，AI Context Pack 必须提示用户不要把单一数字当作已验证事实。 处理方式：在 Human Manual 和 AI Context Pack 中共同标记为待核实，而不是强行选择一个数字。 证据：`v3/implementation/migration/v3-migration-roadmap.md`, `v3/docs/adr/ADR-127-github-stack-modernization.md`, `v3/implementation/optimization/V3-OPTIMIZATION-ROADMAP.md`, `v3/implementation/swarm-plans/AGENT-SPECIFICATIONS.md` 等 Claim：`clm_0034` inferred 0.45
- **源文件冲突 skill_count**：发现多个值 `13, 28, 37, 42, 100`，应在真实使用前核实。
- **源文件冲突 agent_count**：发现多个值 `10, 13, 15, 19, 30, 45, 54, 58, 76, 85, 87, 100, 107, 2014`，应在真实使用前核实。
- **待确认**：真实安装后是否与用户当前宿主 AI 版本兼容？。原因：兼容性只能通过实际宿主环境验证。
- **待确认**：项目输出质量是否满足用户具体任务？。原因：安装前预览只能展示流程和边界，不能替代真实评测。
- **待确认**：安装命令是否需要网络、权限或全局写入？。原因：这影响企业环境和个人环境的安装风险。

## 开工前工作上下文

### 加载顺序

- 先读取 how_to_use.host_ai_instruction，建立安装前判断资产的边界。
- 读取 claim_graph_summary，确认事实来自 Claim/Evidence Graph，而不是 Human Wiki 叙事。
- 再读取 intended_users、capabilities 和 quick_start_candidates，判断用户是否匹配。
- 需要执行具体任务时，优先查 role_skill_index，再查 evidence_index。
- 遇到真实安装、文件修改、网络访问、性能或兼容性问题时，转入 risk_card 和 boundaries.runtime_required。

### 任务路由

- **AI Skill / Agent 指令资产库**：先基于 role_skill_index / evidence_index 帮用户挑选可用角色、Skill 或工作流。 边界：可做安装前 Prompt 体验。 证据：`.agents/skills/agent-adaptive-coordinator/SKILL.md`, `.agents/skills/agent-agent/SKILL.md`, `.agents/skills/agent-agentic-payments/SKILL.md`, `.agents/skills/agent-analyze-code-quality/SKILL.md` 等 Claim：`clm_0001` supported 0.86
- **多宿主安装与分发**：先说明这是安装后验证能力，再给出安装前检查清单。 边界：必须真实安装或运行后验证。 证据：`.claude-plugin/marketplace.json`, `.claude-plugin/plugin.json`, `plugin/.claude-plugin/plugin.json`, `plugins/ruflo-adr/.claude-plugin/plugin.json` 等
- **命令行启动或安装流程**：先说明这是安装后验证能力，再给出安装前检查清单。 边界：必须真实安装或运行后验证。 证据：`.claude-plugin/docs/QUICKSTART.md`, `AGENTS.md`, `README.md`, `v3/@claude-flow/neural/docs/SONA_QUICKSTART.md` Claim：`clm_0003` supported 0.86

### 上下文规模

- 文件总数：4695
- 重要文件覆盖：40/4695
- 证据索引条目：180
- 角色 / Skill 条目：260

### 证据不足时的处理

- **missing_evidence**：说明证据不足，要求用户提供目标文件、README 段落或安装后验证记录；不要补全事实。
- **out_of_scope_request**：说明该任务超出当前 AI Context Pack 证据范围，并建议用户先查看 Human Manual 或真实安装后验证。
- **runtime_request**：给出安装前检查清单和命令来源，但不要替用户执行命令或声称已执行。
- **source_conflict**：同时展示冲突来源，标记为待核实，不要强行选择一个版本。

## Prompt Recipes

### 适配判断

- 目标：判断这个项目是否适合用户当前任务。
- 预期输出：适配结论、关键理由、证据引用、安装前可预览内容、必须安装后验证内容、下一步建议。

```text
请基于 ruflo 的 AI Context Pack，先问我 3 个必要问题，然后判断它是否适合我的任务。回答必须包含：适合谁、能做什么、不能做什么、是否值得安装、证据来自哪里。所有项目事实必须引用 evidence_refs、source_paths 或 claim_id。
```

### 安装前体验

- 目标：让用户在安装前感受核心工作流，同时避免把预览包装成真实能力或营销承诺。
- 预期输出：一段带边界标签的体验剧本、安装后验证清单和谨慎建议；不含真实运行承诺或强营销表述。

```text
请把 ruflo 当作安装前体验资产，而不是已安装工具或真实运行环境。

请严格输出四段：
1. 先问我 3 个必要问题。
2. 给出一段“体验剧本”：用 [安装前可预览]、[必须安装后验证]、[证据不足] 三种标签展示它可能如何引导工作流。
3. 给出安装后验证清单：列出哪些能力只有真实安装、真实宿主加载、真实项目运行后才能确认。
4. 给出谨慎建议：只能说“值得继续研究/试装”“先补充信息后再判断”或“不建议继续”，不得替项目背书。

硬性边界：
- 不要声称已经安装、运行、执行测试、修改文件或产生真实结果。
- 不要写“自动适配”“确保通过”“完美适配”“强烈建议安装”等承诺性表达。
- 如果描述安装后的工作方式，必须使用“如果安装成功且宿主正确加载 Skill，它可能会……”这种条件句。
- 体验剧本只能写成“示例台词/假设流程”：使用“可能会询问/可能会建议/可能会展示”，不要写“已写入、已生成、已通过、正在运行、正在生成”。
- Prompt Preview 不负责给安装命令；如用户准备试装，只能提示先阅读 Quick Start 和 Risk Card，并在隔离环境验证。
- 所有项目事实必须来自 supported claim、evidence_refs 或 source_paths；inferred/unverified 只能作风险或待确认项。

```

### 角色 / Skill 选择

- 目标：从项目里的角色或 Skill 中挑选最匹配的资产。
- 预期输出：候选角色或 Skill 列表，每项包含适用场景、证据路径、风险边界和是否需要安装后验证。

```text
请读取 role_skill_index，根据我的目标任务推荐 3-5 个最相关的角色或 Skill。每个推荐都要说明适用场景、可能输出、风险边界和 evidence_refs。
```

### 风险预检

- 目标：安装或引入前识别环境、权限、规则冲突和质量风险。
- 预期输出：环境、权限、依赖、许可、宿主冲突、质量风险和未知项的检查清单。

```text
请基于 risk_card、boundaries 和 quick_start_candidates，给我一份安装前风险预检清单。不要替我执行命令，只说明我应该检查什么、为什么检查、失败会有什么影响。
```

### 宿主 AI 开工指令

- 目标：把项目上下文转成一次对话开始前的宿主 AI 指令。
- 预期输出：一段边界明确、证据引用明确、适合复制给宿主 AI 的开工前指令。

```text
请基于 ruflo 的 AI Context Pack，生成一段我可以粘贴给宿主 AI 的开工前指令。这段指令必须遵守 not_runtime=true，不能声称项目已经安装、运行或产生真实结果。
```

## 角色 / Skill 索引

- 共索引 260 个角色 / Skill / 项目文档条目。

- **agent-adaptive-coordinator**（skill）：Agent skill for adaptive-coordinator - invoke with $agent-adaptive-coordinator 激活提示：当用户任务与“agent-adaptive-coordinator”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-adaptive-coordinator/SKILL.md`
- **agent-agent**（skill）：Agent skill for agent - invoke with $agent-agent 激活提示：当用户任务与“agent-agent”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-agent/SKILL.md`
- **agent-agentic-payments**（skill）：Agent skill for agentic-payments - invoke with $agent-agentic-payments 激活提示：当用户任务与“agent-agentic-payments”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-agentic-payments/SKILL.md`
- **agent-analyze-code-quality**（skill）：Agent skill for analyze-code-quality - invoke with $agent-analyze-code-quality 激活提示：当用户任务与“agent-analyze-code-quality”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-analyze-code-quality/SKILL.md`
- **agent-app-store**（skill）：Agent skill for app-store - invoke with $agent-app-store 激活提示：当用户任务与“agent-app-store”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-app-store/SKILL.md`
- **agent-arch-system-design**（skill）：Agent skill for arch-system-design - invoke with $agent-arch-system-design 激活提示：当用户任务与“agent-arch-system-design”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-arch-system-design/SKILL.md`
- **agent-architecture**（skill）：Agent skill for architecture - invoke with $agent-architecture 激活提示：当用户任务与“agent-architecture”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-architecture/SKILL.md`
- **agent-authentication**（skill）：Agent skill for authentication - invoke with $agent-authentication 激活提示：当用户任务与“agent-authentication”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-authentication/SKILL.md`
- **agent-automation-smart-agent**（skill）：Agent skill for automation-smart-agent - invoke with $agent-automation-smart-agent 激活提示：当用户任务与“agent-automation-smart-agent”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-automation-smart-agent/SKILL.md`
- **agent-base-template-generator**（skill）：Agent skill for base-template-generator - invoke with $agent-base-template-generator 激活提示：当用户任务与“agent-base-template-generator”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-base-template-generator/SKILL.md`
- **agent-benchmark-suite**（skill）：Agent skill for benchmark-suite - invoke with $agent-benchmark-suite 激活提示：当用户任务与“agent-benchmark-suite”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-benchmark-suite/SKILL.md`
- **agent-byzantine-coordinator**（skill）：Agent skill for byzantine-coordinator - invoke with $agent-byzantine-coordinator 激活提示：当用户任务与“agent-byzantine-coordinator”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-byzantine-coordinator/SKILL.md`
- **agent-challenges**（skill）：Agent skill for challenges - invoke with $agent-challenges 激活提示：当用户任务与“agent-challenges”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-challenges/SKILL.md`
- **agent-code-analyzer**（skill）：Agent skill for code-analyzer - invoke with $agent-code-analyzer 激活提示：当用户任务与“agent-code-analyzer”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-code-analyzer/SKILL.md`
- **agent-code-goal-planner**（skill）：Agent skill for code-goal-planner - invoke with $agent-code-goal-planner 激活提示：当用户任务与“agent-code-goal-planner”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-code-goal-planner/SKILL.md`
- **agent-code-review-swarm**（skill）：Agent skill for code-review-swarm - invoke with $agent-code-review-swarm 激活提示：当用户任务与“agent-code-review-swarm”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-code-review-swarm/SKILL.md`
- **agent-coder**（skill）：Agent skill for coder - invoke with $agent-coder 激活提示：当用户任务与“agent-coder”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-coder/SKILL.md`
- **agent-collective-intelligence-coordinator**（skill）：Agent skill for collective-intelligence-coordinator - invoke with $agent-collective-intelligence-coordinator 激活提示：当用户任务与“agent-collective-intelligence-coordinator”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-collective-intelligence-coordinator/SKILL.md`
- **agent-consensus-coordinator**（skill）：Agent skill for consensus-coordinator - invoke with $agent-consensus-coordinator 激活提示：当用户任务与“agent-consensus-coordinator”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-consensus-coordinator/SKILL.md`
- **agent-coordination**（skill）： 激活提示：当用户任务与“agent-coordination”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-coordination/SKILL.md`
- **agent-coordinator-swarm-init**（skill）：Agent skill for coordinator-swarm-init - invoke with $agent-coordinator-swarm-init 激活提示：当用户任务与“agent-coordinator-swarm-init”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-coordinator-swarm-init/SKILL.md`
- **agent-crdt-synchronizer**（skill）：Agent skill for crdt-synchronizer - invoke with $agent-crdt-synchronizer 激活提示：当用户任务与“agent-crdt-synchronizer”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-crdt-synchronizer/SKILL.md`
- **agent-data-ml-model**（skill）：Agent skill for data-ml-model - invoke with $agent-data-ml-model 激活提示：当用户任务与“agent-data-ml-model”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-data-ml-model/SKILL.md`
- **agent-dev-backend-api**（skill）：Agent skill for dev-backend-api - invoke with $agent-dev-backend-api 激活提示：当用户任务与“agent-dev-backend-api”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-dev-backend-api/SKILL.md`
- **agent-docs-api-openapi**（skill）：Agent skill for docs-api-openapi - invoke with $agent-docs-api-openapi 激活提示：当用户任务与“agent-docs-api-openapi”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-docs-api-openapi/SKILL.md`
- **agent-github-modes**（skill）：Agent skill for github-modes - invoke with $agent-github-modes 激活提示：当用户任务与“agent-github-modes”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-github-modes/SKILL.md`
- **agent-github-pr-manager**（skill）：Agent skill for github-pr-manager - invoke with $agent-github-pr-manager 激活提示：当用户任务与“agent-github-pr-manager”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-github-pr-manager/SKILL.md`
- **agent-goal-planner**（skill）：Agent skill for goal-planner - invoke with $agent-goal-planner 激活提示：当用户任务与“agent-goal-planner”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-goal-planner/SKILL.md`
- **agent-gossip-coordinator**（skill）：Agent skill for gossip-coordinator - invoke with $agent-gossip-coordinator 激活提示：当用户任务与“agent-gossip-coordinator”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-gossip-coordinator/SKILL.md`
- **agent-hierarchical-coordinator**（skill）：Agent skill for hierarchical-coordinator - invoke with $agent-hierarchical-coordinator 激活提示：当用户任务与“agent-hierarchical-coordinator”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-hierarchical-coordinator/SKILL.md`
- **agent-implementer-sparc-coder**（skill）：Agent skill for implementer-sparc-coder - invoke with $agent-implementer-sparc-coder 激活提示：当用户任务与“agent-implementer-sparc-coder”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-implementer-sparc-coder/SKILL.md`
- **agent-issue-tracker**（skill）：Agent skill for issue-tracker - invoke with $agent-issue-tracker 激活提示：当用户任务与“agent-issue-tracker”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-issue-tracker/SKILL.md`
- **agent-load-balancer**（skill）：Agent skill for load-balancer - invoke with $agent-load-balancer 激活提示：当用户任务与“agent-load-balancer”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-load-balancer/SKILL.md`
- **agent-matrix-optimizer**（skill）：Agent skill for matrix-optimizer - invoke with $agent-matrix-optimizer 激活提示：当用户任务与“agent-matrix-optimizer”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-matrix-optimizer/SKILL.md`
- **agent-memory-coordinator**（skill）：Agent skill for memory-coordinator - invoke with $agent-memory-coordinator 激活提示：当用户任务与“agent-memory-coordinator”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-memory-coordinator/SKILL.md`
- **agent-mesh-coordinator**（skill）：Agent skill for mesh-coordinator - invoke with $agent-mesh-coordinator 激活提示：当用户任务与“agent-mesh-coordinator”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-mesh-coordinator/SKILL.md`
- **agent-migration-plan**（skill）：Agent skill for migration-plan - invoke with $agent-migration-plan 激活提示：当用户任务与“agent-migration-plan”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-migration-plan/SKILL.md`
- **agent-multi-repo-swarm**（skill）：Agent skill for multi-repo-swarm - invoke with $agent-multi-repo-swarm 激活提示：当用户任务与“agent-multi-repo-swarm”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-multi-repo-swarm/SKILL.md`
- **agent-neural-network**（skill）：Agent skill for neural-network - invoke with $agent-neural-network 激活提示：当用户任务与“agent-neural-network”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-neural-network/SKILL.md`
- **agent-ops-cicd-github**（skill）：Agent skill for ops-cicd-github - invoke with $agent-ops-cicd-github 激活提示：当用户任务与“agent-ops-cicd-github”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-ops-cicd-github/SKILL.md`
- **agent-orchestrator-task**（skill）：Agent skill for orchestrator-task - invoke with $agent-orchestrator-task 激活提示：当用户任务与“agent-orchestrator-task”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-orchestrator-task/SKILL.md`
- **agent-pagerank-analyzer**（skill）：Agent skill for pagerank-analyzer - invoke with $agent-pagerank-analyzer 激活提示：当用户任务与“agent-pagerank-analyzer”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-pagerank-analyzer/SKILL.md`
- **agent-payments**（skill）：Agent skill for payments - invoke with $agent-payments 激活提示：当用户任务与“agent-payments”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-payments/SKILL.md`
- **agent-performance-analyzer**（skill）：Agent skill for performance-analyzer - invoke with $agent-performance-analyzer 激活提示：当用户任务与“agent-performance-analyzer”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-performance-analyzer/SKILL.md`
- **agent-performance-benchmarker**（skill）：Agent skill for performance-benchmarker - invoke with $agent-performance-benchmarker 激活提示：当用户任务与“agent-performance-benchmarker”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-performance-benchmarker/SKILL.md`
- **agent-performance-monitor**（skill）：Agent skill for performance-monitor - invoke with $agent-performance-monitor 激活提示：当用户任务与“agent-performance-monitor”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-performance-monitor/SKILL.md`
- **agent-performance-optimizer**（skill）：Agent skill for performance-optimizer - invoke with $agent-performance-optimizer 激活提示：当用户任务与“agent-performance-optimizer”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-performance-optimizer/SKILL.md`
- **agent-planner**（skill）：Agent skill for planner - invoke with $agent-planner 激活提示：当用户任务与“agent-planner”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-planner/SKILL.md`
- **agent-pr-manager**（skill）：Agent skill for pr-manager - invoke with $agent-pr-manager 激活提示：当用户任务与“agent-pr-manager”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-pr-manager/SKILL.md`
- **agent-production-validator**（skill）：Agent skill for production-validator - invoke with $agent-production-validator 激活提示：当用户任务与“agent-production-validator”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-production-validator/SKILL.md`
- **agent-project-board-sync**（skill）：Agent skill for project-board-sync - invoke with $agent-project-board-sync 激活提示：当用户任务与“agent-project-board-sync”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-project-board-sync/SKILL.md`
- **agent-pseudocode**（skill）：Agent skill for pseudocode - invoke with $agent-pseudocode 激活提示：当用户任务与“agent-pseudocode”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-pseudocode/SKILL.md`
- **agent-queen-coordinator**（skill）：Agent skill for queen-coordinator - invoke with $agent-queen-coordinator 激活提示：当用户任务与“agent-queen-coordinator”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-queen-coordinator/SKILL.md`
- **agent-quorum-manager**（skill）：Agent skill for quorum-manager - invoke with $agent-quorum-manager 激活提示：当用户任务与“agent-quorum-manager”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-quorum-manager/SKILL.md`
- **agent-raft-manager**（skill）：Agent skill for raft-manager - invoke with $agent-raft-manager 激活提示：当用户任务与“agent-raft-manager”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-raft-manager/SKILL.md`
- **agent-refinement**（skill）：Agent skill for refinement - invoke with $agent-refinement 激活提示：当用户任务与“agent-refinement”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-refinement/SKILL.md`
- **agent-release-manager**（skill）：Agent skill for release-manager - invoke with $agent-release-manager 激活提示：当用户任务与“agent-release-manager”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-release-manager/SKILL.md`
- **agent-release-swarm**（skill）：Agent skill for release-swarm - invoke with $agent-release-swarm 激活提示：当用户任务与“agent-release-swarm”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-release-swarm/SKILL.md`
- **agent-repo-architect**（skill）：Agent skill for repo-architect - invoke with $agent-repo-architect 激活提示：当用户任务与“agent-repo-architect”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-repo-architect/SKILL.md`
- **agent-researcher**（skill）：Agent skill for researcher - invoke with $agent-researcher 激活提示：当用户任务与“agent-researcher”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-researcher/SKILL.md`
- **agent-resource-allocator**（skill）：Agent skill for resource-allocator - invoke with $agent-resource-allocator 激活提示：当用户任务与“agent-resource-allocator”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-resource-allocator/SKILL.md`
- **agent-reviewer**（skill）：Agent skill for reviewer - invoke with $agent-reviewer 激活提示：当用户任务与“agent-reviewer”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-reviewer/SKILL.md`
- **agent-safla-neural**（skill）：Agent skill for safla-neural - invoke with $agent-safla-neural 激活提示：当用户任务与“agent-safla-neural”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-safla-neural/SKILL.md`
- **agent-sandbox**（skill）：Agent skill for sandbox - invoke with $agent-sandbox 激活提示：当用户任务与“agent-sandbox”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-sandbox/SKILL.md`
- **agent-scout-explorer**（skill）：Agent skill for scout-explorer - invoke with $agent-scout-explorer 激活提示：当用户任务与“agent-scout-explorer”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-scout-explorer/SKILL.md`
- **agent-security-manager**（skill）：Agent skill for security-manager - invoke with $agent-security-manager 激活提示：当用户任务与“agent-security-manager”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-security-manager/SKILL.md`
- **agent-sona-learning-optimizer**（skill）：Agent skill for sona-learning-optimizer - invoke with $agent-sona-learning-optimizer 激活提示：当用户任务与“agent-sona-learning-optimizer”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-sona-learning-optimizer/SKILL.md`
- **agent-sparc-coordinator**（skill）：Agent skill for sparc-coordinator - invoke with $agent-sparc-coordinator 激活提示：当用户任务与“agent-sparc-coordinator”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-sparc-coordinator/SKILL.md`
- **agent-spec-mobile-react-native**（skill）：Agent skill for spec-mobile-react-native - invoke with $agent-spec-mobile-react-native 激活提示：当用户任务与“agent-spec-mobile-react-native”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-spec-mobile-react-native/SKILL.md`
- **agent-specification**（skill）：Agent skill for specification - invoke with $agent-specification 激活提示：当用户任务与“agent-specification”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-specification/SKILL.md`
- **agent-swarm-issue**（skill）：Agent skill for swarm-issue - invoke with $agent-swarm-issue 激活提示：当用户任务与“agent-swarm-issue”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-swarm-issue/SKILL.md`
- **agent-swarm-memory-manager**（skill）：Agent skill for swarm-memory-manager - invoke with $agent-swarm-memory-manager 激活提示：当用户任务与“agent-swarm-memory-manager”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-swarm-memory-manager/SKILL.md`
- **agent-swarm-pr**（skill）：Agent skill for swarm-pr - invoke with $agent-swarm-pr 激活提示：当用户任务与“agent-swarm-pr”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-swarm-pr/SKILL.md`
- **agent-swarm**（skill）：Agent skill for swarm - invoke with $agent-swarm 激活提示：当用户任务与“agent-swarm”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-swarm/SKILL.md`
- **agent-sync-coordinator**（skill）：Agent skill for sync-coordinator - invoke with $agent-sync-coordinator 激活提示：当用户任务与“agent-sync-coordinator”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-sync-coordinator/SKILL.md`
- **agent-tdd-london-swarm**（skill）：Agent skill for tdd-london-swarm - invoke with $agent-tdd-london-swarm 激活提示：当用户任务与“agent-tdd-london-swarm”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-tdd-london-swarm/SKILL.md`
- **agent-test-long-runner**（skill）：Agent skill for test-long-runner - invoke with $agent-test-long-runner 激活提示：当用户任务与“agent-test-long-runner”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-test-long-runner/SKILL.md`
- **agent-tester**（skill）：Agent skill for tester - invoke with $agent-tester 激活提示：当用户任务与“agent-tester”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-tester/SKILL.md`
- **agent-topology-optimizer**（skill）：Agent skill for topology-optimizer - invoke with $agent-topology-optimizer 激活提示：当用户任务与“agent-topology-optimizer”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-topology-optimizer/SKILL.md`
- **agent-trading-predictor**（skill）：Agent skill for trading-predictor - invoke with $agent-trading-predictor 激活提示：当用户任务与“agent-trading-predictor”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/agent-trading-predictor/SKILL.md`
- 其余 180 个条目见 `AI_CONTEXT_PACK.json`。

## 证据索引

- 共索引 180 条证据。

- **Ruflo Federation — User Guide**（documentation）：Cross-installation agent peering with built-in cost limits, circuit breaker, signed envelopes, and as of alpha.14 opt-in WireGuard mesh layer governed by federation trust. 证据：`docs/federation/README.md`
- **Validation System**（documentation）：Three-layer regression-protection stack used by ruflo's CI to catch the regression classes that traditional unit tests miss. Adopt the same stack in any project — the toolkit is project-agnostic and ships in plugins/ruflo-core/scripts/witness/ . 证据：`docs/validation/README.md`
- **Claude Flow V3 - Architecture Decision Records**（documentation）：Claude Flow V3 - Architecture Decision Records 证据：`v3/docs/adr/README.md`
- **Coherence Engine Domain**（documentation）：The Coherence Engine domain provides mathematical AI interpretability capabilities for Claude Flow V3 through the prime-radiant plugin. It enables rigorous coherence validation, spectral stability analysis, and causal reasoning using advanced mathematical frameworks including Sheaf Cohomology, Spectral Graph Theory, and Do-Calculus. 证据：`v3/docs/ddd/coherence-engine/README.md`
- **Quality Engineering Domain**（documentation）：The Quality Engineering QE domain provides comprehensive automated testing, quality assessment, and continuous validation capabilities for Claude Flow V3. It is implemented as the agentic-qe plugin with 51 specialized QE agents organized across 12 Domain-Driven Design bounded contexts. 证据：`v3/docs/ddd/quality-engineering/README.md`
- **Dossier Examples**（documentation）：Example outputs from the ruflo-goals plugin's dossier-collect skill ADR-099 . Each subdirectory contains: 证据：`v3/docs/examples/dossiers/README.md`
- **.agents Directory**（documentation）：This directory contains agent configuration and skills for OpenAI Codex CLI. 证据：`.agents/README.md`
- **🚀 Claude Flow Plugin - Complete Enterprise AI Agent Orchestration**（documentation）：🚀 Claude Flow Plugin - Complete Enterprise AI Agent Orchestration 证据：`.claude-plugin/README.md`
- **.harness/ — ruflo's MetaHarness lifecycle directory**（documentation）：.harness/ — ruflo's MetaHarness lifecycle directory 证据：`.harness/README.md`
- **Claude Flow V3 - Agent Guide**（documentation）：For OpenAI Codex CLI - Agentic AI Foundation standard Skills: $skill-name Config: .agents/config.toml 证据：`AGENTS.md`
- **Claude Code Configuration - Ruflo v3.5**（documentation）：Claude Code Configuration - Ruflo v3.5 证据：`CLAUDE.md`
- **Ruflo**（documentation）：! Ruflo Banner ruflo/assets/ruflo-small.jpeg https://cognitum.one/agentic-engineering 证据：`README.md`
- **Ruflo Plugins**（documentation）：32 Claude Code plugins for agent-powered development workflows. Load with --plugin-dir . 证据：`plugins/README.md`
- **Ruflo**（documentation）：! Ruflo Banner ruflo/assets/ruflo-small.jpeg https://cognitum.one/agentic-engineering 证据：`ruflo/README.md`
- **V3 Module Development**（documentation）：This directory contains the V3 monorepo packages. Root CLAUDE.md rules apply here. 证据：`v3/CLAUDE.md`
- **Claude Flow V3**（documentation）：Modular AI Agent Coordination System - A complete reimagining of Claude-Flow with 15-agent hierarchical mesh swarm coordination. 证据：`v3/README.md`
- **Ruflo Verification System**（documentation）：A cross-platform, cryptographically-signed regression-protection toolkit. Every documented fix in ruflo gets attested by a SHA-256 + marker substring + Ed25519 signature. Anyone with the same git commit can re-derive the public key and verify it independently. 证据：`verification/README.md`
- **Agents Commands**（documentation）：Commands for agents operations in Claude Flow. 证据：`.claude/commands/agents/README.md`
- **Analysis Commands**（documentation）：Commands for analysis operations in Claude Flow. 证据：`.claude/commands/analysis/README.md`
- **Automation Commands**（documentation）：Commands for automation operations in Claude Flow. 证据：`.claude/commands/automation/README.md`
- **Coordination Commands**（documentation）：Commands for coordination operations in Claude Flow. 证据：`.claude/commands/coordination/README.md`
- **Github Commands**（documentation）：Commands for github operations in Claude Flow. 证据：`.claude/commands/github/README.md`
- **Hive-mind Commands**（documentation）：Commands for hive-mind operations in Claude Flow. 证据：`.claude/commands/hive-mind/README.md`
- **Hooks Commands**（documentation）：Commands for hooks operations in Claude Flow. 证据：`.claude/commands/hooks/README.md`
- **Memory Commands**（documentation）：Commands for memory operations in Claude Flow. 证据：`.claude/commands/memory/README.md`
- **Monitoring Commands**（documentation）：Commands for monitoring operations in Claude Flow. 证据：`.claude/commands/monitoring/README.md`
- **List Active Patterns**（documentation）：🎯 Key Principle This tool coordinates Claude Code's actions. It does NOT write code or create content. 证据：`.claude/commands/monitoring/agents.md`
- **Optimization Commands**（documentation）：Commands for optimization operations in Claude Flow. 证据：`.claude/commands/optimization/README.md`
- **👥 Pair Programming Command**（documentation）：Collaborative development with real-time verification and AI assistance. 证据：`.claude/commands/pair/README.md`
- **Swarm Commands**（documentation）：Commands for swarm operations in Claude Flow. 证据：`.claude/commands/swarm/README.md`
- **Training Commands**（documentation）：Commands for training operations in Claude Flow. 证据：`.claude/commands/training/README.md`
- **Workflows Commands**（documentation）：Commands for workflows operations in Claude Flow. 证据：`.claude/commands/workflows/README.md`
- **RuFlo V3 Helpers**（documentation）：This directory contains helper scripts and utilities for V3 development. 证据：`.claude/helpers/README.md`
- **Dual-Mode Skills Claude Code + Codex**（documentation）：Dual-Mode Skills Claude Code + Codex 证据：`.claude/skills/dual-mode/README.md`
- **ruflo-adr**（documentation）：ADR lifecycle management -- create, index, supersede, and link Architecture Decision Records to code. 证据：`plugins/ruflo-adr/README.md`
- **ruflo-agent**（documentation）：Agent runtimes for ruflo — one mental model, two backends a third planned : 证据：`plugins/ruflo-agent/README.md`
- **ruflo-agentdb**（documentation）：The substrate plugin for Ruflo memory. Wraps three CLI MCP families — agentdb controller bridge, 15 tools , embeddings RuVector ONNX engine, 10 tools , and ruvllm hnsw WASM-backed pattern router, 3 tools — into discoverable skills and commands. Other plugins ruflo-browser , ruflo-rag-memory , ruflo-intelligence compose this substrate; this plugin owns the namespace convention and the smoke contract for the substrate as a whole. 证据：`plugins/ruflo-agentdb/README.md`
- **ruflo-aidefence**（documentation）：AI safety scanning, PII detection, prompt injection defense, and adaptive threat learning. 证据：`plugins/ruflo-aidefence/README.md`
- **ruflo-arena**（documentation）：Competitive ruliology for Ruflo swarms — arenas , tournaments , and adaptive co-evolution of program strategies. Implements the first executable slice of Ruflo ADR-147/148/150, following Stephen Wolfram's Games Between Programs: The Ruliology of Competition https://writings.stephenwolfram.com/2026/06/games-between-programs-the-ruliology-of-competition/ . 证据：`plugins/ruflo-arena/README.md`
- **ruflo-autopilot**（documentation）：Autonomous /loop-driven task completion with learning and prediction. 证据：`plugins/ruflo-autopilot/README.md`
- **ruflo-browser**（documentation）：Session-as-skill browser automation. Playwright-backed via 23 mcp claude-flow browser tools, with each session captured as a first-class RVF cognitive container holding manifest + trajectory + screenshots + sanitized cookies + findings, indexed in AgentDB and gated by AIDefence. 证据：`plugins/ruflo-browser/README.md`
- **ruflo-core**（documentation）：Foundation plugin. Registers the ruflo MCP server 300+ tools , provides three generalist agents coder , researcher , reviewer , three first-run helpers init-project , ruflo-doctor , discover-plugins , and a curated catalog covering all 30+ sibling plugins. 证据：`plugins/ruflo-core/README.md`
- **ruflo-cost-tracker**（documentation）：Token usage tracking, model cost attribution per agent, budget alerts, and optimization recommendations. 证据：`plugins/ruflo-cost-tracker/README.md`
- **ruflo-daa**（documentation）：Dynamic Agentic Architecture with cognitive patterns, knowledge sharing, and adaptive agents. 证据：`plugins/ruflo-daa/README.md`
- **ruflo-ddd**（documentation）：Domain-Driven Design scaffolding -- bounded contexts, aggregate roots, domain events, and anti-corruption layers. 证据：`plugins/ruflo-ddd/README.md`
- **ruflo-docs**（documentation）：Documentation generation, drift detection, and API docs automation. 证据：`plugins/ruflo-docs/README.md`
- **ruflo-federation**（documentation）：The comms layer for multi-agent AI. Cross-installation agent federation with zero-trust security, PII-gated data flow, and compliance-grade audit trails. 证据：`plugins/ruflo-federation/README.md`
- **ruflo-goals**（documentation）：Long-horizon goal planning, deep research orchestration, and adaptive replanning. 证据：`plugins/ruflo-goals/README.md`
- **ruflo-intelligence**（documentation）：User-facing surface for Ruflo's self-learning system. Wraps 29 intelligence-related MCP tools across four families into discoverable skills, commands, and the canonical 4-step pipeline RETRIEVE → JUDGE → DISTILL → CONSOLIDATE . Coordinates with ruflo-agentdb namespace convention , ruflo-ruvector trajectory recording substrate , and ruflo-browser consumes trajectory hooks for session replay . 证据：`plugins/ruflo-intelligence/README.md`
- **ruflo-iot-cognitum**（documentation）：IoT device lifecycle, telemetry anomaly detection, fleet management, and witness chain verification for Cognitum Seed hardware. 证据：`plugins/ruflo-iot-cognitum/README.md`
- **ruflo-jujutsu**（documentation）：Advanced git workflows with diff analysis, risk scoring, and reviewer recommendations. 证据：`plugins/ruflo-jujutsu/README.md`
- **ruflo-knowledge-graph**（documentation）：Knowledge graph construction -- entity extraction, relation mapping, and pathfinder graph traversal. 证据：`plugins/ruflo-knowledge-graph/README.md`
- **ruflo-loop-workers**（documentation）：Cache-aware /loop workers and CronCreate background automation. Substrate plugin for every recurring task in the ruflo family. 证据：`plugins/ruflo-loop-workers/README.md`
- **ruflo-market-data**（documentation）：Market data ingestion -- feed normalization, OHLCV vectorization, and HNSW-indexed pattern matching. 证据：`plugins/ruflo-market-data/README.md`
- **ruflo-metaharness**（documentation）：MetaHarness integration plugin for ruflo. Surfaces the upstream metaharness / harness CLIs through five ruflo skills, honoring ADR-150 ../../v3/docs/adr/ADR-150-metaharness-integration-surfaces.md 's architectural constraint that MetaHarness must remain a removable augmentation — never a required runtime dependency. 证据：`plugins/ruflo-metaharness/README.md`
- **ruflo-migrations**（documentation）：Schema migration management -- generate, validate, dry-run, and rollback database migrations. 证据：`plugins/ruflo-migrations/README.md`
- **ruflo-neural-trader**（documentation）：Neural trading strategies powered by neural-trader https://www.npmjs.com/package/neural-trader v2.7+ — self-learning LSTM/Transformer/N-BEATS models, Rust/NAPI backtesting 8-19x faster , 112+ MCP tools, swarm coordination, and portfolio optimization. 证据：`plugins/ruflo-neural-trader/README.md`
- **ruflo-observability**（documentation）：Structured logging, distributed tracing, and metrics -- correlate agent swarm activity with application telemetry. 证据：`plugins/ruflo-observability/README.md`
- **ruflo-plugin-creator**（documentation）：Scaffold, validate, and publish new Claude Code plugins with proper structure, MCP tool wiring, AND the canonical plugin contract ADR + smoke + Compatibility + namespace coordination . 证据：`plugins/ruflo-plugin-creator/README.md`
- **ruflo-rag-memory**（documentation）：Retrieval-Augmented Generation memory with HNSW vector search, AgentDB persistence, and Claude Code memory bridge. 证据：`plugins/ruflo-rag-memory/README.md`
- 其余 120 条证据见 `AI_CONTEXT_PACK.json` 或 `EVIDENCE_INDEX.json`。

## 宿主 AI 必须遵守的规则

- **把本资产当作开工前上下文，而不是运行环境。**：AI Context Pack 只包含证据化项目理解，不包含目标项目的可执行状态。 证据：`docs/federation/README.md`, `docs/validation/README.md`, `v3/docs/adr/README.md`
- **回答用户时区分可预览内容与必须安装后才能验证的内容。**：安装前体验的消费者价值来自降低误装和误判，而不是伪装成真实运行。 证据：`docs/federation/README.md`, `docs/validation/README.md`, `v3/docs/adr/README.md`

## 用户开工前应该回答的问题

- 你准备在哪个宿主 AI 或本地环境中使用它？
- 你只是想先体验工作流，还是准备真实安装？
- 你最在意的是安装成本、输出质量、还是和现有规则的冲突？

## 验收标准

- 所有能力声明都能回指到 evidence_refs 中的文件路径。
- AI_CONTEXT_PACK.md 没有把预览包装成真实运行。
- 用户能在 3 分钟内看懂适合谁、能做什么、如何开始和风险边界。

---

## Doramagic Context Augmentation

下面内容用于强化 Repomix/AI Context Pack 主体。Human Manual 只提供阅读骨架；踩坑日志会被转成宿主 AI 必须遵守的工作约束。

## Human Manual 骨架

使用规则：这里只是项目阅读路线和显著性信号，不是事实权威。具体事实仍必须回到 repo evidence / Claim Graph。

宿主 AI 硬性规则：
- 不得把页标题、章节顺序、摘要或 importance 当作项目事实证据。
- 解释 Human Manual 骨架时，必须明确说它只是阅读路线/显著性信号。
- 能力、安装、兼容性、运行状态和风险判断必须引用 repo evidence、source path 或 Claim Graph。

- **Overview and System Architecture**：importance `high`
  - source_paths: README.md, v3/README.md, v3/CLAUDE.md, v3/package.json, v3/@claude-flow/cli/package.json
- **Installation, Setup, Uninstallation, and Known Failure Modes**：importance `high`
  - source_paths: .claude-plugin/scripts/install.sh, .claude-plugin/scripts/uninstall.sh, .claude-plugin/docs/INSTALLATION.md, .claude-plugin/docs/QUICKSTART.md, scripts/install.sh
- **Core Features: Agents, Swarms, Memory, and Self-Learning**：importance `high`
  - source_paths: v3/@claude-flow/swarm/src/index.ts, v3/@claude-flow/swarm/src/queen-coordinator.ts, v3/@claude-flow/swarm/src/topology-manager.ts, v3/@claude-flow/memory/src/index.ts, v3/@claude-flow/memory/src/hnsw-index.ts
- **Plugin Marketplace, MCP Tools, and Extensibility**：importance `high`
  - source_paths: plugins/README.md, plugins/ruflo-core/.claude-plugin/plugin.json, plugins/ruflo-swarm/.claude-plugin/plugin.json, plugins/ruflo-federation/.claude-plugin/plugin.json, plugins/ruflo-agentdb/.claude-plugin/plugin.json

## Repo Inspection Evidence / 源码检查证据

- repo_clone_verified: true
- repo_inspection_verified: true
- repo_commit: `ec1a18799651130fa7c98361219a54c4672cfbdf`
- inspected_files: `README.md`, `package.json`, `pnpm-lock.yaml`, `docs/IMPROVEMENT-ROADMAP.md`, `docs/QUALITY-SWEEP.md`, `docs/STATUS.md`, `docs/TEAM-GATEWAY-CHECKLIST.md`, `docs/USERGUIDE.md`, `docs/_config.yml`, `docs/benchmarks/BEIR-MATRIX.md`, `docs/benchmarks/guidance-baseline.json`, `docs/benchmarks/guidance-phase-1.json`, `docs/benchmarks/guidance-quantization-m4.json`, `docs/benchmarks/guidance-retriever-scale-baseline-filtered.json`, `docs/benchmarks/guidance-retriever-scale-baseline.json`, `docs/benchmarks/guidance-retriever-scale-m4.json`, `docs/benchmarks/guidance-retriever-scale-phase-1.json`, `docs/benchmarks/guidance-retriever-scale-phase-3-m3.json`, `docs/benchmarks/guidance-retriever-scale-phase-3-m3v2-filtered.json`, `docs/benchmarks/guidance-retriever-scale-phase-3-m3v2.json`

宿主 AI 硬性规则：
- 没有 repo_clone_verified=true 时，不得声称已经读过源码。
- 没有 repo_inspection_verified=true 时，不得把 README/docs/package 文件判断写成事实。
- 没有 quick_start_verified=true 时，不得声称 Quick Start 已跑通。

## Doramagic Pitfall Constraints / 踩坑约束

这些规则来自 Doramagic 发现、验证或编译过程中的项目专属坑点。宿主 AI 必须把它们当作工作约束，而不是普通说明文字。

### Constraint 1: 失败模式：security_permissions: ADR-153 — Integrate @metaharness/darwin (Darwin Mode) into ruflo

- Trigger: Developers should check this security_permissions risk before relying on the project: ADR-153 — Integrate @metaharness/darwin (Darwin Mode) into ruflo
- Host AI rule: Before packaging this project, run the relevant install/config/quickstart check for: ADR-153 — Integrate @metaharness/darwin (Darwin Mode) into ruflo. Context: Observed when using node, macos
- Why it matters: Developers may expose sensitive permissions or credentials: ADR-153 — Integrate @metaharness/darwin (Darwin Mode) into ruflo
- Evidence: failure_mode_cluster:github_issue | https://github.com/ruvnet/ruflo/issues/2409 | ADR-153 — Integrate @metaharness/darwin (Darwin Mode) into ruflo
- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。

### Constraint 2: 失败模式：security_permissions: security cve subcommand is a stub — never returns CVE data (scan already does, via npm audit)

- Trigger: Developers should check this security_permissions risk before relying on the project: security cve subcommand is a stub — never returns CVE data (scan already does, via npm audit)
- Host AI rule: Before packaging this project, run the relevant install/config/quickstart check for: security cve subcommand is a stub — never returns CVE data (scan already does, via npm audit). Context: Observed when using node
- Why it matters: Developers may expose sensitive permissions or credentials: security cve subcommand is a stub — never returns CVE data (scan already does, via npm audit)
- Evidence: failure_mode_cluster:github_issue | https://github.com/ruvnet/ruflo/issues/2403 | security cve subcommand is a stub — never returns CVE data (scan already does, via npm audit)
- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。

### Constraint 3: 来源证据：[verification] HIGH: @claude-flow/cli@alpha --version hangs >60s on cold install (ONNX model download on every startup)

- Trigger: GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：[verification] HIGH: @claude-flow/cli@alpha --version hangs >60s on cold install (ONNX model download on every startup)
- Why it matters: 可能影响授权、密钥配置或安全边界。
- Evidence: community_evidence:github | https://github.com/ruvnet/ruflo/issues/2286 | 来源讨论提到 node 相关条件，需在安装/试用前复核。
- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。

### Constraint 4: 来源证据：[verification] HIGH: v3-ci.yml on main is FAILURE — supply-chain audit job failing

- Trigger: GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：[verification] HIGH: v3-ci.yml on main is FAILURE — supply-chain audit job failing
- Why it matters: 可能增加新用户试用和生产接入成本。
- Evidence: community_evidence:github | https://github.com/ruvnet/ruflo/issues/2412 | 来源讨论提到 node 相关条件，需在安装/试用前复核。
- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。

### Constraint 5: 来源证据：[verification] HIGH: witness manifests report missing=95 drift=2 on all three platforms

- Trigger: GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：[verification] HIGH: witness manifests report missing=95 drift=2 on all three platforms
- Why it matters: 可能增加新用户试用和生产接入成本。
- Evidence: community_evidence:github | https://github.com/ruvnet/ruflo/issues/2047 | 来源讨论提到 node 相关条件，需在安装/试用前复核。
- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。

### Constraint 6: 来源证据：[verification] MEDIUM: witness verify blocked — @noble/ed25519 not installed in source-only checkout

- Trigger: GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：[verification] MEDIUM: witness verify blocked — @noble/ed25519 not installed in source-only checkout
- Why it matters: 可能阻塞安装或首次运行。
- Evidence: community_evidence:github | https://github.com/ruvnet/ruflo/issues/2313 | 来源讨论提到 npm 相关条件，需在安装/试用前复核。
- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。

### Constraint 7: 失败模式：installation: [verification] HIGH: @claude-flow/cli@alpha --version hangs >60s on cold install (ONNX model...

- Trigger: Developers should check this installation risk before relying on the project: [verification] HIGH: @claude-flow/cli@alpha --version hangs >60s on cold install (ONNX model download on every startup)
- Host AI rule: Before packaging this project, run the relevant install/config/quickstart check for: [verification] HIGH: @claude-flow/cli@alpha --version hangs >60s on cold install (ONNX model download on every startup). Context: Observed when using node, python, linux
- Why it matters: Developers may fail before the first successful local run: [verification] HIGH: @claude-flow/cli@alpha --version hangs >60s on cold install (ONNX model download on every startup)
- Evidence: failure_mode_cluster:github_issue | https://github.com/ruvnet/ruflo/issues/2286 | [verification] HIGH: @claude-flow/cli@alpha --version hangs >60s on cold install (ONNX model download on every startup)
- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。

### Constraint 8: 失败模式：installation: [verification] HIGH: Witness manifests report 95–99 missing build artifacts (dist/ absent)

- Trigger: Developers should check this installation risk before relying on the project: [verification] HIGH: Witness manifests report 95–99 missing build artifacts (dist/ absent)
- Host AI rule: Before packaging this project, run the relevant install/config/quickstart check for: [verification] HIGH: Witness manifests report 95–99 missing build artifacts (dist/ absent). Context: Observed when using node, python, windows, macos
- Why it matters: Developers may fail before the first successful local run: [verification] HIGH: Witness manifests report 95–99 missing build artifacts (dist/ absent)
- Evidence: failure_mode_cluster:github_issue | https://github.com/ruvnet/ruflo/issues/2391 | [verification] HIGH: Witness manifests report 95–99 missing build artifacts (dist/ absent)
- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。

### Constraint 9: 失败模式：installation: [verification] HIGH: witness manifests report missing=95 drift=2 on all three platforms

- Trigger: Developers should check this installation risk before relying on the project: [verification] HIGH: witness manifests report missing=95 drift=2 on all three platforms
- Host AI rule: Before packaging this project, run the relevant install/config/quickstart check for: [verification] HIGH: witness manifests report missing=95 drift=2 on all three platforms. Context: Observed when using node, windows, macos, linux
- Why it matters: Developers may fail before the first successful local run: [verification] HIGH: witness manifests report missing=95 drift=2 on all three platforms
- Evidence: failure_mode_cluster:github_issue | https://github.com/ruvnet/ruflo/issues/2047 | [verification] HIGH: witness manifests report missing=95 drift=2 on all three platforms
- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。

### Constraint 10: 失败模式：installation: memory_store emits 128-dim mock embeddings — AgentDB vectorBackend controller never enables

- Trigger: Developers should check this installation risk before relying on the project: memory_store emits 128-dim mock embeddings — AgentDB vectorBackend controller never enables
- Host AI rule: Before packaging this project, run the relevant install/config/quickstart check for: memory_store emits 128-dim mock embeddings — AgentDB vectorBackend controller never enables. Context: Observed when using node, linux
- Why it matters: Developers may fail before the first successful local run: memory_store emits 128-dim mock embeddings — AgentDB vectorBackend controller never enables
- Evidence: failure_mode_cluster:github_issue | https://github.com/ruvnet/ruflo/issues/2395 | memory_store emits 128-dim mock embeddings — AgentDB vectorBackend controller never enables
- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。