Arcrun

Leo/Arcrun

Fork 0

Commit Graph

Author	SHA1	Message	Date
Leo	c2a2f82ade	docs(arcrun): SDD llm-interface — AI 操盤手使用體驗 first-class 設計動機：3 天 mira dogfood 累積 14 個痛點，7 個純粹是 LI 缺失。 arcrun 過去設計集中在「人」（u6u-gui / docs），AI 對 arcrun 的可用性沒被當第一公民。 SDD 三件套（matrix/arcrun/.agents/specs/llm-interface/）： requirements.md - personas（Claude Code 主力 / 用戶私人 agent / SDK 使用者） - 範圍涵蓋 5 系統（cypher-executor / registry / u6u-mcp / u6u-gui / kbdb） - 10 個 FR：onboarding / CRUD 對等 / dry-run / 結構化 trace / 可程式化 error / feedback tool / implicit telemetry / skill blocks / examples / weekly closed loop - 5 個 NFR：相容 / 多 transport / error contract 穩定 / feedback exportable / coverage 量化 design.md - 5 層 LI 模型：AGENTS.md / arcrun-mcp / Skills / Examples / Telemetry - 25 個 MCP tool 完整清單分 5 類 - error_code enum v1 - coverage matrix（GUI 動作 vs MCP / 31 cypher-executor 路由 vs LI） - 完整 AGENTS.md 模板 - u6u-mcp → arcrun-mcp migration plan（90 天 deprecation） - weekly_review workflow YAML 範本 tasks.md - 5 個 milestone（M1 收 data / M2 gap-fill / M3 skill+examples / M4 closed loop / M5 rename） - 估算 23 個工作日 (~5 週) - M1 是硬前置（不收 data 改了也不知道對沒） Audit 基準（用 4 個並行 Explore agent 整理）： - cypher-executor: 31 HTTP 路由，9 個 AI-essential - u6u-mcp: 15 tool，缺 update/delete/history/validate/feedback - u6u-gui: 8 個人類動作可對等 LI / 3 個視覺類不需 - kbdb: 50 路由 13 group，LI 走 abstracted tool 不直接 expose 同步更新 .claude/rules/04-current-progress.md SDD 索引。 Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>	2026-05-16 14:58:21 +08:00
Leo	6ee6fee8b9	chore: remove duplicate credentials/ dir + add CLAUDE.md + .claude rules credentials/ was a leftover duplicate — all credential routes already live in cypher-executor/src/routes/credentials.ts. Adds the SDD protocol, tech-stack, forbidden-list, component-architecture, and progress rules that guide Phase 1-6 refactors. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>	2026-04-20 16:53:26 +08:00

Author

SHA1

Message

Date

Leo

c2a2f82ade

docs(arcrun): SDD llm-interface — AI 操盤手使用體驗 first-class

設計動機：3 天 mira dogfood 累積 14 個痛點，7 個純粹是 LI 缺失。
arcrun 過去設計集中在「人」（u6u-gui / docs），AI 對 arcrun 的可用性
沒被當第一公民。

SDD 三件套（matrix/arcrun/.agents/specs/llm-interface/）：

requirements.md
  - personas（Claude Code 主力 / 用戶私人 agent / SDK 使用者）
  - 範圍涵蓋 5 系統（cypher-executor / registry / u6u-mcp / u6u-gui / kbdb）
  - 10 個 FR：onboarding / CRUD 對等 / dry-run / 結構化 trace /
    可程式化 error / feedback tool / implicit telemetry /
    skill blocks / examples / weekly closed loop
  - 5 個 NFR：相容 / 多 transport / error contract 穩定 /
    feedback exportable / coverage 量化

design.md
  - 5 層 LI 模型：AGENTS.md / arcrun-mcp / Skills / Examples / Telemetry
  - 25 個 MCP tool 完整清單分 5 類
  - error_code enum v1
  - coverage matrix（GUI 動作 vs MCP / 31 cypher-executor 路由 vs LI）
  - 完整 AGENTS.md 模板
  - u6u-mcp → arcrun-mcp migration plan（90 天 deprecation）
  - weekly_review workflow YAML 範本

tasks.md
  - 5 個 milestone（M1 收 data / M2 gap-fill / M3 skill+examples /
    M4 closed loop / M5 rename）
  - 估算 23 個工作日 (~5 週)
  - M1 是硬前置（不收 data 改了也不知道對沒）

Audit 基準（用 4 個並行 Explore agent 整理）：
  - cypher-executor: 31 HTTP 路由，9 個 AI-essential
  - u6u-mcp: 15 tool，缺 update/delete/history/validate/feedback
  - u6u-gui: 8 個人類動作可對等 LI / 3 個視覺類不需
  - kbdb: 50 路由 13 group，LI 走 abstracted tool 不直接 expose

同步更新 .claude/rules/04-current-progress.md SDD 索引。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

2026-05-16 14:58:21 +08:00

Leo

6ee6fee8b9

chore: remove duplicate credentials/ dir + add CLAUDE.md + .claude rules

credentials/ was a leftover duplicate — all credential routes already live
in cypher-executor/src/routes/credentials.ts. Adds the SDD protocol,
tech-stack, forbidden-list, component-architecture, and progress rules
that guide Phase 1-6 refactors.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

2026-04-20 16:53:26 +08:00

2 Commits