docs(CLAUDE.md): 修掉目录速查 / 路由清单 / 计数三类失真，并标出 auto-dev 这个幽灵入口

逐条都对着 HEAD 核过（不含工作区里其它会话未提交的改动）： ① docs/ 那一行列的 5 个文件全是死链 —— 它们都搬进了 docs/done/。根因不是路径写错，是同一份文件清单被抄在两处：CLAUDE.md 一份、docs/README.md 一份，文档一搬家，抄的那份就烂。改成只描述「按状态分目录」的结构并指向 docs/README.md，并写明「别在本表里加文件名」，免得再抄一次。 ② 路由清单漏项 + 错项： - index.js 实挂 /api/okr 与 /api/graph-runs，表里都没有 - 表里写的 /api/goals 是 okr 的向后兼容别名，不是独立路由；标注清楚 - agent-server.js 子集同样漏了 /api/okr、/api/graph-runs （注：工作区里有另一个会话正在退役 /api/goals 别名，尚未提交。本次按 HEAD 的事实写，等那笔落地后这两行还要再改一次。） ③ 三个硬编码计数全部过期：routes 15→实际 17，services 26→38，views 10→15， agents「75 个」连测试建本体都会让它变。计数在这种表里只会烂，直接去掉； views 补上 GraphConsole 与 DevLoop 四页。 ④ auto-dev 是幽灵入口：server/src/cli/ 整个目录不存在，且 git 历史里从未有过 auto-dev.js。npm run example / example-bmi / bin.auto-dev 三处引用全是坏的（实测 MODULE_NOT_FOUND）。CLAUDE.md 里改成显式警告 —— 没删 package.json 的 scripts/bin，那是代码改动，留给人定「补文件还是删引用」。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

docs(CLAUDE.md): 修掉目录速查 / 路由清单 / 计数三类失真，并标出 auto-dev 这个幽灵入口
逐条都对着 HEAD 核过（不含工作区里其它会话未提交的改动）： ① docs/ 那一行列的 5 个文件全是死链 —— 它们都搬进了 docs/done/。根因不是路径写错，是同一份文件清单被抄在两处：CLAUDE.md 一份、docs/README.md 一份，文档一搬家，抄的那份就烂。改成只描述「按状态分目录」的结构并指向 docs/README.md，并写明「别在本表里加文件名」，免得再抄一次。 ② 路由清单漏项 + 错项： - index.js 实挂 /api/okr 与 /api/graph-runs，表里都没有 - 表里写的 /api/goals 是 okr 的向后兼容别名，不是独立路由；标注清楚 - agent-server.js 子集同样漏了 /api/okr、/api/graph-runs （注：工作区里有另一个会话正在退役 /api/goals 别名，尚未提交。本次按 HEAD 的事实写，等那笔落地后这两行还要再改一次。） ③ 三个硬编码计数全部过期：routes 15→实际 17，services 26→38，views 10→15， agents「75 个」连测试建本体都会让它变。计数在这种表里只会烂，直接去掉； views 补上 GraphConsole 与 DevLoop 四页。 ④ auto-dev 是幽灵入口：server/src/cli/ 整个目录不存在，且 git 历史里从未有过 auto-dev.js。npm run example / example-bmi / bin.auto-dev 三处引用全是坏的（实测 MODULE_NOT_FOUND）。CLAUDE.md 里改成显式警告 —— 没删 package.json 的 scripts/bin，那是代码改动，留给人定「补文件还是删引用」。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
yibo · 宜博
1 parent 7f24ef0a
Showing 1 changed file with 15 additions and 11 deletions
CLAUDE.md
@@ -48,11 +48,15 @@ npm run spec:extract              # 从 docs/prd/newfunction/*.html 重新生成
 npm run spec:check                # CI/pre-commit 用，校验 _spec/ 与 HTML 是否同步
  
 # CLI / 工具
-npm run example                   # 单次 auto-dev：实现斐波那契
-npm run example-bmi               # 单次 auto-dev：BMI 程序
 npm run logs / analyze / parse    # 查看 / 分析 / 解析 Agent 运行日志
 npm run skills:sync               # 同步 Skill 到 Claude CLI 配置目录
-auto-dev "<task>"                 # bin 入口 → server/src/cli/auto-dev.js
+
+# ⚠️ 下面三条目前是坏的，别照抄：入口 server/src/cli/auto-dev.js 不存在
+# （`server/src/cli/` 整个目录都没有，且 git 历史里从未有过这个文件），
+# 跑起来是 MODULE_NOT_FOUND。package.json 的 scripts.example / example-bmi
+# 和 bin.auto-dev 三处引用都还挂着，要么补文件要么删引用。
+#   npm run example / example-bmi
+#   auto-dev "<task>"
 ```
  
 ## 架构
@@ -67,8 +71,8 @@ auto-dev &quot;&lt;task&gt;&quot;                 # bin 入口 → server/src/cli/auto-dev.js
  
 | 入口 | 端口 | 启动方式 | 挂载路由 |
 |------|------|----------|----------|
-| `server/index.js` | 3010 | `npm run dev` / `npm run server` / `bash start.sh` | 全量：`/api/claude-chat` `/api/config` `/api/evolution` `/api/innovator` `/api/master` `/api/open` `/api/arena` `/api/auth` `/api/users` `/api/whatsapp` `/api/agent` `/api/goals` `/api/company` `/api/tasks` `/api/devloop`，WS `/ws/claude`，插件 / 心跳 / 中断任务恢复，`NODE_ENV=production` 时托管 `web/dist/` 静态文件 |
-| `server/agent-server.js` | 3010 | 仅手动 `node server/agent-server.js`（历史保留） | 子集：`/api/agent` `/api/company` `/api/goals` `/api/tasks` `/api/devloop` |
+| `server/index.js` | 3010 | `npm run dev` / `npm run server` / `bash start.sh` | 全量：`/api/claude-chat` `/api/config` `/api/evolution` `/api/innovator` `/api/master` `/api/open` `/api/arena` `/api/auth` `/api/users` `/api/whatsapp` `/api/agent` `/api/okr`（`/api/goals` 是它的向后兼容别名）`/api/company` `/api/graph-runs` `/api/tasks` `/api/devloop`，WS `/ws/claude`，插件 / 心跳 / 中断任务恢复，`NODE_ENV=production` 时托管 `web/dist/` 静态文件 |
+| `server/agent-server.js` | 3010 | 仅手动 `node server/agent-server.js`（历史保留） | 子集：`/api/agent` `/api/company` `/api/okr`（+ `/api/goals` 别名）`/api/graph-runs` `/api/tasks` `/api/devloop` |
  
 两者**不要同时启动**（端口冲突）。默认走 `index.js`（`start.sh` / `npm run dev` 都指向它）；`agent-server.js` 只在你想跑无依赖最小子集时手动启动。
  
@@ -78,8 +82,8 @@ auto-dev &quot;&lt;task&gt;&quot;                 # bin 入口 → server/src/cli/auto-dev.js
 |------|------|
 | `server/index.js` | 完整 ArenaSK 服务（API + WS + 插件 + 前端托管），`start.sh` / `npm run dev` 默认入口 |
 | `server/agent-server.js` | 历史保留的轻量子集入口（Agent / Company / Goals / Tasks / DevLoop），仅手动启动 |
-| `server/routes/` | 15 个 API 路由 |
-| `server/services/` | 26 个业务服务（skill-db, benchmark-runner, company-service, heartbeat, pipeline-service, retrain-pipeline, …） |
+| `server/routes/` | 各 API 路由（挂载点见上表两个入口，以入口文件为准） |
+| `server/services/` | 业务服务（skill-db, benchmark-runner, company-service, heartbeat-service, company-heartbeat-service, pipeline-service, retrain-pipeline, graph-engine, …） |
 | `server/src/core/` | Agent 引擎核心（orchestrator, master-session, agent-manager, scheduler, session-pool, prompt-builder, runtime-resolver, …） |
 | `server/src/engine/` | 进程层（command-queue, idle-timer, process-guard, run-registry, failover-error） |
 | `server/src/plugins/` | 插件系统（plugin-manager, agent-bridge, config-bridge, bootstrap） |
@@ -87,14 +91,14 @@ auto-dev &quot;&lt;task&gt;&quot;                 # bin 入口 → server/src/cli/auto-dev.js
 | `server/services/devloop/` | DevLoop 支撑服务：path-resolver, git-vault, unit-registry（FSM）, timeline-logger, bug-tracker, doc-store, changelog-writer, sse-broker |
 | `server/src/tools/devloop/` | DevLoop Agent 可调用工具（coder/tester/integrator/triager/doc/persistence-tools + tool-registry + sandbox） |
 | `server/routes/devloop.js` | DevLoop REST：`/api/devloop/projects` |
-| `system/agents/` | **全部 Agent 本体的唯一目录**（75 个）。`_base/` 是元 Agent 骨架，`_registry.json` 只用于按 id 补 `benchmark_score`（**目录才是数据源头**，`graph-seed-service.seedAgents()` 直接扫目录）。`_` 前缀为保留 id，扫描时跳过 |
+| `system/agents/` | **全部 Agent 本体的唯一目录**。`_base/` 是元 Agent 骨架，`_registry.json` 只用于按 id 补 `benchmark_score`（**目录才是数据源头**，`graph-seed-service.seedAgents()` 直接扫目录）。`_` 前缀为保留 id，扫描时跳过 |
 | `system/agents/devloop-*/` | 六个 DevLoop Agent（pm, architect, coder, tester, integrator, triager），每个含 `config.json` + `prompt.md` + 一份指路用的薄 `agent.md` |
 | `server/src/tools/` | Master Agent 可调用的工具（call-agent, marketplace, orchestrate, train-skill, …） |
-| `web/src/views/` | 10 个页面：AgentChat, AgentList, CompanyDashboard, JobsPanel, OkrDashboard, PipelineEditor, QuotaMonitor, SkillsMarket, TaskTimeline, TemplateAgents |
+| `web/src/views/` | 页面：AgentChat, AgentList, CompanyDashboard, GraphConsole, JobsPanel, OkrDashboard, PipelineEditor, QuotaMonitor, SkillsMarket, TaskTimeline, TemplateAgents + DevLoop 四页（Dashboard / Projects / NewRequirement / Ops） |
 | `packages/` | `acp-core`, `agent-core`, `evolution`, `plugin-bootstrap` |
 | `data/skills/` | Skill 仓库（代码外部目录，路径由 `config.skillsDataDir` 控制） |
 | `scripts/` | 运维脚本（含 `sync-skills.js`） |
-| `docs/` | 设计文档（`LEMONBOSS-SYSTEM-DESIGN.md`, `architecture-v5.md`, `open-api-manual.md`, `system-design/`, `user-guides/` …） |
+| `docs/` | 设计文档，**按状态分目录**：`done/`（已实现 / 长期参考手册，含 `system-design/` 01–26 章与 `user-guides/`）、`todo/`（当前主线，27/28 系列）、`todo/future/`（暂缓）、`_archive/`。另有 `prd/`（DevLoop 规格源，见上）。**索引在 [`docs/README.md`](docs/README.md)，逐条带状态说明 —— 找文档从那里进，别在本表里加文件名**（这一行曾经列了 5 个具体文件，文档移进 `done/` 之后全成了死链） |
  
 ### 关键 API 路由
  
@@ -105,7 +109,7 @@ auto-dev &quot;&lt;task&gt;&quot;                 # bin 入口 → server/src/cli/auto-dev.js
 | `/api/innovator/skills` | Skill 管理（Admin） |
 | `/api/master/chat` | Master Agent 对话（SSE） |
 | `/api/agent/*` | LemonBoss Agent Chat |
-| `/api/company/*` `/api/goals/*` `/api/tasks/*` | 公司 / OKR / Task 管理 |
+| `/api/company/*` `/api/okr/*` `/api/tasks/*` | 公司 / OKR / Task 管理（`/api/goals/*` 是 OKR 的向后兼容别名） |
 | `/api/auth/*` | JWT + GitHub OAuth |
 | `/ws/claude` | Claude 实时对话（仅 `index.js`） |
 | `/api/health` `/api/plugins` | 健康检查 / 插件状态 |