From 85346352273e160b0c7ca2451fe3b03ae965675e Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Thu, 27 Aug 2026 08:10:08 +0000 Subject: [PATCH 1/2] docs: update hub/ layout in READMEs to match actual files Add missing hub files to tree diagrams: - incremental.py (committed-diff / --quick agent-group refresh) - host_runner.py (local CLI backend, no API key) - storage.py (generation dirs + current.json) - language_adapters/ (language-specific adapters) Update agents.py comment to include refresh swarm agents (ScanAnalyst/ArchitectureReviewer/ConventionWriter) alongside ask swarm agents (ContextCurator/DeepAnalyst/AnswerSynthesizer). Co-authored-by: JingWen Fan --- README.md | 8 ++++++-- README_CN.md | 8 ++++++-- README_ES.md | 8 ++++++-- 3 files changed, 18 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 13466707a..92153ddcd 100644 --- a/README.md +++ b/README.md @@ -508,17 +508,21 @@ repobrain/ ├── _cli_entry.py # rb-ask / rb-refresh / rb-mcp + python -m dispatch ├── config.py # Pydantic configuration ├── hub/ # ★ Core: multi-agent cluster - │ ├── agents.py # Router + ModuleAgent + GitAgent + │ ├── agents.py # Refresh/Ask Swarm agents (ScanAnalyst/ArchitectureReviewer/ConventionWriter + ContextCurator/DeepAnalyst/AnswerSynthesizer) │ ├── contracts.py # Pydantic models: claims, evidence, refresh status │ ├── ask_pipeline.py # agent.md + graph-enriched ask │ ├── refresh_pipeline.py # LLM-driven refresh → agents/*.md + map.md │ ├── ask_tools.py │ ├── scanner.py # multi-language project scanning │ ├── module_grouping.py # smart functional file grouping + │ ├── incremental.py # committed-diff / --quick agent-group refresh + │ ├── host_runner.py # local CLI backend, no API key + │ ├── storage.py # generation dirs + current.json │ ├── structure.py │ ├── knowledge_graph.py │ ├── retrieval_graph.py - │ └── mcp_server.py + │ ├── mcp_server.py + │ └── language_adapters/ # language-specific code adapters ├── mcp_client.py # MCP consumer (connects external tools) ├── memory.py # Persistent interaction memory ├── tools/ # MCP query tools + extensions diff --git a/README_CN.md b/README_CN.md index 8cab3789d..12553a493 100644 --- a/README_CN.md +++ b/README_CN.md @@ -278,14 +278,18 @@ repobrain/ ├── _cli_entry.py # rb-ask / rb-refresh 入口 ├── config.py # Pydantic 配置 ├── hub/ # ★ 核心：多智能体集群 - │ ├── agents.py # Router + ModuleAgent + GitAgent + │ ├── agents.py # Refresh/Ask Swarm agents (ScanAnalyst/ArchitectureReviewer/ConventionWriter + ContextCurator/DeepAnalyst/AnswerSynthesizer) │ ├── contracts.py # Pydantic 模型：claims、证据、刷新状态 │ ├── ask_pipeline.py # agent.md 路由问答 │ ├── refresh_pipeline.py # LLM 驱动刷新 → agents/*.md + map.md │ ├── ask_tools.py # 代码探索工具 │ ├── scanner.py # 多语言项目扫描 │ ├── module_grouping.py # 智能功能分组 - │ └── mcp_server.py# MCP 服务端 (rb-mcp) + │ ├── incremental.py # 增量刷新（--quick） + │ ├── host_runner.py # 本地 CLI 后端（无 API key） + │ ├── storage.py # 知识库存储（current.json） + │ ├── mcp_server.py# MCP 服务端 (rb-mcp) + │ └── language_adapters/ # 多语言适配器 ├── mcp_client.py # MCP 消费端（连接外部工具） ├── memory.py # 持久交互记忆 ├── tools/ # MCP 查询工具 + 扩展工具 diff --git a/README_ES.md b/README_ES.md index 6cb2ee0ca..b8c619896 100644 --- a/README_ES.md +++ b/README_ES.md @@ -261,14 +261,18 @@ repobrain/ ├── _cli_entry.py # rb-ask / rb-refresh puntos de entrada ├── config.py # Configuración Pydantic ├── hub/ # ★ Núcleo: clúster multi-agente - │ ├── agents.py # Router + ModuleAgent + GitAgent + │ ├── agents.py # Refresh/Ask Swarm agents (ScanAnalyst/ArchitectureReviewer/ConventionWriter + ContextCurator/DeepAnalyst/AnswerSynthesizer) │ ├── contracts.py # Modelos Pydantic: claims, evidencia, estado de refresh │ ├── ask_pipeline.py # facts estructurados + swarm legacy │ ├── refresh_pipeline.py # orquestación de refresh basado en evidencia │ ├── ask_tools.py # Exploración de código │ ├── scanner.py # Escaneo multi-lenguaje de proyecto │ ├── module_grouping.py # agrupación funcional inteligente - │ └── mcp_server.py# Servidor MCP (rb-mcp) + │ ├── incremental.py # committed-diff / --quick agent-group refresh + │ ├── host_runner.py # local CLI backend, no API key + │ ├── storage.py # generation dirs + current.json + │ ├── mcp_server.py# Servidor MCP (rb-mcp) + │ └── language_adapters/ # adaptadores específicos de lenguaje ├── mcp_client.py # Consumidor MCP (conecta herramientas externas) ├── memory.py # Memoria de interacción persistente ├── tools/ # Herramientas MCP + extensiones From ac710b30ec96ed014a755486f9847f9906c73b9b Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Thu, 27 Aug 2026 08:11:59 +0000 Subject: [PATCH 2/2] docs: fix agents.py comment to use actual Agent names MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Change from conceptual names (ContextCurator/DeepAnalyst/AnswerSynthesizer) to real Agent instances: - Refresh swarm: ScanAnalyst → ArchitectureReviewer → ConventionWriter - Ask swarm: Router / ModuleAgent / GitAgent ContextCurator/DeepAnalyst/AnswerSynthesizer appear only in the module docstring, not as actual Agent(name=...) instances. Co-authored-by: JingWen Fan --- README.md | 2 +- README_CN.md | 2 +- README_ES.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 92153ddcd..554ea562a 100644 --- a/README.md +++ b/README.md @@ -508,7 +508,7 @@ repobrain/ ├── _cli_entry.py # rb-ask / rb-refresh / rb-mcp + python -m dispatch ├── config.py # Pydantic configuration ├── hub/ # ★ Core: multi-agent cluster - │ ├── agents.py # Refresh/Ask Swarm agents (ScanAnalyst/ArchitectureReviewer/ConventionWriter + ContextCurator/DeepAnalyst/AnswerSynthesizer) + │ ├── agents.py # Refresh swarm (ScanAnalyst → ArchitectureReviewer → ConventionWriter) + Ask swarm (Router / ModuleAgent / GitAgent) │ ├── contracts.py # Pydantic models: claims, evidence, refresh status │ ├── ask_pipeline.py # agent.md + graph-enriched ask │ ├── refresh_pipeline.py # LLM-driven refresh → agents/*.md + map.md diff --git a/README_CN.md b/README_CN.md index 12553a493..4368168ac 100644 --- a/README_CN.md +++ b/README_CN.md @@ -278,7 +278,7 @@ repobrain/ ├── _cli_entry.py # rb-ask / rb-refresh 入口 ├── config.py # Pydantic 配置 ├── hub/ # ★ 核心：多智能体集群 - │ ├── agents.py # Refresh/Ask Swarm agents (ScanAnalyst/ArchitectureReviewer/ConventionWriter + ContextCurator/DeepAnalyst/AnswerSynthesizer) + │ ├── agents.py # Refresh swarm (ScanAnalyst → ArchitectureReviewer → ConventionWriter) + Ask swarm (Router / ModuleAgent / GitAgent) │ ├── contracts.py # Pydantic 模型：claims、证据、刷新状态 │ ├── ask_pipeline.py # agent.md 路由问答 │ ├── refresh_pipeline.py # LLM 驱动刷新 → agents/*.md + map.md diff --git a/README_ES.md b/README_ES.md index b8c619896..45bb8765a 100644 --- a/README_ES.md +++ b/README_ES.md @@ -261,7 +261,7 @@ repobrain/ ├── _cli_entry.py # rb-ask / rb-refresh puntos de entrada ├── config.py # Configuración Pydantic ├── hub/ # ★ Núcleo: clúster multi-agente - │ ├── agents.py # Refresh/Ask Swarm agents (ScanAnalyst/ArchitectureReviewer/ConventionWriter + ContextCurator/DeepAnalyst/AnswerSynthesizer) + │ ├── agents.py # Refresh swarm (ScanAnalyst → ArchitectureReviewer → ConventionWriter) + Ask swarm (Router / ModuleAgent / GitAgent) │ ├── contracts.py # Modelos Pydantic: claims, evidencia, estado de refresh │ ├── ask_pipeline.py # facts estructurados + swarm legacy │ ├── refresh_pipeline.py # orquestación de refresh basado en evidencia