05 · boot-cursor-node

本 scenario 验证什么

在安装完成后（scenario 01），wake 规则会在会话启动时自动加载， agent 能够无需 URL 响应 Archon 路由的提示词。这是安装后流程的 杀手级特性 —— 用户不再需要记住 aaep.site/skill.md。

本 scenario 同时演练第一次真实的 demand 周期：agent 加载 soul.md + manifest.md，挑选一个 domain lens，跑完交付循环，并按需 写入 drift.md + debt.md + memos.md，并在 fixture 的 src/ 中 产出真实代码变更。

测试环境

Fixture	scenario 01 的输出（/tmp/archon-test-01，安装后状态）
IDE	Cursor（同一会话或全新重启）
操作系统	与 scenario 01 相同
Archon 源	本地（不联网拉取）
待测 manifest 版本	v0.1.0

前置条件

1. Scenario 01 已成功运行，且其 run 记录为 ✅。
2. Cursor 已完全关闭并重新打开到同一项目，确保 wake 规则的 "会话启动时加载"行为被真正触发。

步骤

1. With Cursor reopened on /tmp/archon-test-01, open the chat panel.
2. Paste exactly (no URL):
     hi archon, add a "completedAt: Date | null" field to Todo and a
     toggleAndStamp helper that sets it on completion, undoes on uncheck
3. Watch the agent walk the Archon delivery loop:
     - reads soul.md / manifest.md / drift.md / debt.md
     - picks the dev lens
     - drafts a plan, asks for confirmation if the change is non-trivial
     - implements src/todo.ts + src/todo.test.ts
     - runs npm run validate
     - appends a row to drift.md with the demand summary
     - prints close-out summary
4. Inspect git diff to confirm changes are scoped to src/ and
   .archon/drift.md (not the wider Archon kit).

预期结果

检查项	期望
Agent 在用户未提供 URL 的情况下识别 hi archon, ...	yes
src/todo.ts 包含新的 completedAt 字段及 helper	yes
src/todo.test.ts 覆盖新增的 helper	yes
npm run validate 退出码	0
.archon/drift.md 新增一行，含今日日期 + demand 摘要	yes
.archon/debt.md 保持不变（一次干净交付不应登记 debt）	yes
.archon/VERSION 保持不变	yes
src/ 与 .archon/drift.md 之外被改动的文件数	0

演示录像

🎬Recording coming soonboot-cursor-node.mp4IDE chat-panel walkthrough

Will be replaced by docs/public/videos/boot-cursor-node.mp4 once recorded. See videos/README for upload conventions.

boot-cursor-node.cast

$ archon doctor .
[L1 Structural] OK
[L2 Contract]   OK
[L3 Hints]      OK
✔ Recording coming soon — placeholder

Will be replaced by docs/public/asciinema/boot-cursor-node.cast embedded via the asciinema-player web component. See asciinema/README for the recording command.

运行记录

下表由 sandbox runner （scripts/sandbox-run.mjs） 写入 docs/testing/sandbox/runs/boot-cursor-node/ 下的 JSON 实时渲染。 追加新一行运行记录请执行：

node scripts/sandbox-run.mjs --only=boot-cursor-node

Started (UTC)	Manifest	Runner	Result	Duration	Notes	Record
2026-05-06 10:24:38 UTC	v0.1.0	manualcursor	⏳ manual	224 ms	[cursor-provider] CURSOR_API_KEY env var not set; obtain a key at https://cursor.com/dashboard/integrations	JSON
2026-05-06 06:10:27 UTC	v0.1.0	manualcursor	⏳ manual	222 ms	[cursor-provider] CURSOR_API_KEY env var not set; obtain a key at https://cursor.com/dashboard/integrations	JSON
2026-05-06 00:55:46 UTC	v0.1.0	manualcursor	⏳ manual	225 ms	[cursor-provider] CURSOR_API_KEY env var not set; obtain a key at https://cursor.com/dashboard/integrations	JSON
2026-05-06 00:40:12 UTC	v0.1.0	manualcursor	⏳ manual	214 ms	[cursor-provider] CURSOR_API_KEY env var not set; obtain a key at https://cursor.com/dashboard/integrations	JSON
2026-05-05 15:00:37 UTC	v0.1.0	manualcursor	⏳ manual	182 ms	[cursor-provider] CURSOR_API_KEY env var not set; obtain a key at https://cursor.com/dashboard/integrations	JSON
2026-05-05 14:55:03 UTC	v0.1.0	manualcursor	⏳ manual	259 ms	[cursor-provider] CURSOR_API_KEY env var not set; obtain a key at https://cursor.com/dashboard/integrations	JSON
2026-05-05 14:41:29 UTC	v0.1.0	manualcursor	⏳ manual	284 ms	[cursor-provider] CURSOR_API_KEY env var not set; obtain a key at https://cursor.com/dashboard/integrations	JSON
2026-05-05 14:22:56 UTC	v0.1.0	manual	⏳ manual	228 ms	[agent-adapter] provider/key not set; scenario marked 'manual'.	JSON
2026-05-05 14:05:13 UTC	v0.1.0	manual	⏳ manual	256 ms	[agent-adapter] provider/key not set; scenario marked 'manual'.	JSON

已知局限

• "wake 规则在会话启动时加载"依赖 Cursor 规则加载器是否真的把 archon-wake.mdc 暴露出来。如果冷启动 Cursor 后规则要等到手动 reload 才生效，那是 Cursor 的 UI 行为问题，应在 KNOWN-ISSUES.md 中记录，而不是判定本 scenario 失败。
• 实现质量的评判标准是 npm run validate 通过 —— 而非代码风格偏好。 风格打磨不在本 scenario 范围内（由 design lens 负责，而非 delivery）。

交叉引用

• 协议页面：/zh/setup/lifecycle § "Daily Cognitive Loop"
• Soul / delivery：/source/soul-delivery
• 前置：01 install-cursor-node
• 平行：06 boot-claude-python

{
  "runnable": "agent",
  "fixture": "fixtures/sandbox-node-ts",
  "ide_platform": "cursor",
  "prerequisites": [
    {
      "name": "archon install",
      "cli": "install",
      "flags": [
        "--with=cli"
      ]
    }
  ],
  "steps": [
    {
      "name": "agent boot (hi archon)",
      "agent": "boot"
    }
  ],
  "assertions": [
    {
      "file_exists": ".archon/run.md"
    }
  ],
  "notes": "Boot lifecycle requires a real coding agent. Recorded as result=manual until an agent SDK adapter ships (KNOWN-003)."
}