qr-planner (规划器)
              / \
    [冲刺合同协商] [方案终审]
    / \
qr-builder (生成器) ──产出工件──→ qr-evaluator (评估器)
      │ │
      │ qr-curator (经验策展) │
      └──────── 注入/捕获 ──────────┘
                    │
            qr-dispatcher (调度器)
                    │
            qr-lead (人机接口)

PLAN → CONTRACT → BUILD → EVALUATE → EVOLVE
  ↑ │
  └────────── (fix_task 回路) ←────────┘

EVALUATE: FAIL
    → Dispatcher 检测
    → retry < 1?
        → 是: fix_task 重试 → BUILD (第二轮) → EVALUATE
        → 否 (retry ≥ 1): ESCALATE → qr-planner 拆分 → N 个子 Card → 重新进入 PLAN

stateDiagram-v2
    [*] --> DRAFTING : 新任务创建

    DRAFTING --> NEGOTIATING : qr-planner\nspec_ready: true
    NEGOTIATING --> ACCEPTED : qr-dispatcher\n双标志确认
    ACCEPTED --> DISPATCHED : qr-dispatcher\n创建 Workflow Run
    DISPATCHED --> BUILT : qr-builder\n6项自检通过
    BUILT --> EVALUATED : qr-evaluator\n独立验证 PASS
    EVALUATED --> DONE : qr-curator\n经验捕获

    BUILT --> FAILED : qr-evaluator\n独立验证 FAIL
    FAILED --> FIX_QUEUED : qr-dispatcher\nretry < 1
    FIX_QUEUED --> DISPATCHED : fix_task 回路\n携带失败上下文

    FAILED --> ESCALATED : qr-dispatcher\nretry ≥ 1
    ESCALATED --> DRAFTING : qr-planner 拆分\nN 个子 Card

    DONE --> [*]

┌──────────────────────────────────────────────────────────────────────────┐
│ Step 1: qr-planner │
│ 创建 Card + 编写 Spec + 验收标准 │
│ → 写入 YAML 基础字段、Task Overview、Spec（目标/涉及文件/技术约束/接口） │
│ → 写入验收标准（H1/H2 工程健康 + B1/B2 行为标准） │
│ → 设置 spec_ready: true │
│ → Card 状态: NEGOTIATING │
├──────────────────────────────────────────────────────────────────────────┤
│ Step 2: qr-dispatcher │
│ 扫描 NEGOTIATING 卡片 │
│ → 扫描 cards/*.md,发现 status: NEGOTIATING 且 spec_ready: true │
│ → 检查 negotiating_at TTL（30 分钟）防止并发 │
│ → 调用 Curator 进行经验注入 │
├──────────────────────────────────────────────────────────────────────────┤
│ Step 3: qr-curator │
│ 注入经验上下文 │
│ → 读取 Spec,搜索经验库（P### / A### / L###） │
│ → 匹配 track / task / tech / files 关键词 │
│ → 写入 Experience Context 到 Card │
│ → 设置 experience_ready: true │
├──────────────────────────────────────────────────────────────────────────┤
│ Step 4: qr-dispatcher │
│ 双向标志确认 │
│ → 验证 spec_ready: true 且 experience_ready: true │
│ → 确认 Card 三个区域均已填写 │
│ → 设置 status: ACCEPTED │
├──────────────────────────────────────────────────────────────────────────┤
│ Step 5: qr-dispatcher │
│ 创建 Box0 DAG Workflow Run │
│ → 创建 Run（模板: qr-build-eval-evolve） │
│ → 传入 card_file=plans/active/cards/T-{id}.md │
│ → 设置 status: DISPATCHED,记录 workflow_run_id │
│ → DAG 自动推进: builder → evaluator → curator │
├──────────────────────────────────────────────────────────────────────────┤
│ Step 6: qr-builder │
│ 读取 Card + 实现 + 自检 │
│ → 只读 Card 文件（Spec + AC + Experience） │
│ → 先读 Experience Context（模式应用 / 反模式规避） │
│ → 实现代码 + 测试 + 配置 + Docker │
│ → 6 项自检通过 │
│ → 填写 Build Result + 经验应用表 │
│ → Card 状态: BUILT │
└──────────────────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────┐
│ YAML Frontmatter [qr-planner + dispatcher] │
│ task_id, group_id, wave, depends_on, status, │
│ spec_ready, experience_ready, workflow_run_id, │
│ retry_count, negotiating_at │
├─────────────────────────────────────────────────────┤
│ 规格局 [qr-planner]  │
│ • 目标（一句话） │
│ • 涉及文件 │
│ • 技术约束（框架/API 限制） │
│ • 接口（输入输出类型、函数签名） │
├─────────────────────────────────────────────────────┤
│ 验收标准 [qr-planner]  │
│ • 工程健康类: pytest 通过, ruff check 零告警 │
│ • 行为类: 具体可测试标准（每条为二元 PASS/FAIL） │
├─────────────────────────────────────────────────────┤
│ 经验上下文 [qr-curator]  │
│ • P###: 模式 — 摘要（Builder 应用的模式） │
│ • A###: 反模式 — 警告（Builder 必须规避的陷阱） │
│ • L###: 教训 — 具体约束或变通方案 │
├─────────────────────────────────────────────────────┤
│ Build Result [qr-builder]  │
│ • 实现产出、经验应用表、修复历史 │
├─────────────────────────────────────────────────────┤
│ Evaluation Result [qr-evaluator]  │
│ • verdict + evidence + complexity + timing │
├─────────────────────────────────────────────────────┤
│ Dispatch History [qr-dispatcher] │
│ • 每次调度记录: 时间, Run ID, 结果, 耗时 │
└─────────────────────────────────────────────────────┘

触点 1: 注入 (INJECT) 触点 2: 交叉引用 触点 3: 捕获 (CAPTURE)
  CONTRACT 阶段 (CROSS-REFERENCE) EVOLVE 阶段
  qr-curator → Card EVALUATE 阶段 qr-curator
                                 qr-evaluator

Curator 读取 Spec Evaluator 审核时 PASS → 提取成功模式 → P###
搜索经验库 将失败现象与已知 FAIL → 提取根因 → A### / L###
匹配关键词 反模式交叉比对 ESCALATE → 规划教训 → planning/P###
嵌入 Experience Context 标注对应 A### ID
Builder 第一眼看到经验

┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ EVALUATE 结果 │ ──→ │ Curator 捕获  │ ──→ │ 写入 P/A/L │ ──→ │ 更新 index.md│
└──────────────┘ └──────────────┘ └──────────────┘ └──────────────┘
                                                                      │
┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ Card (注入) │ ←── │ 写入 Exp Ctx │ ←── │ 检索匹配 │ ←──────────┘
└──────────────┘ └──────────────┘ └──────────────┘
       │
       ▼
  Builder 读 Card 时消费

{track, task, tech, files, failure_context}

{
  "state": "dispatching",
  "active_tasks": {},
  "max_parallel": 10,
  "lock_ttl_minutes": 25,
  "dispatch_timeout_s": 600
}

EVALUATED → FAILED → Dispatcher 检测 → retry_count < 1?
  → 是: FIX_QUEUED → 重新 DISPATCHED → BUILD (携带失败上下文)
  → 否: ESCALATED → qr-escalate workflow → Planner 拆分为 N 个子 Card

P0: P0A → P0B → P0C → P0D → P0E ← 5 阶段串行链
                         │
          ┌──────────────┼──────────────┐
          ▼ ▼ ▼
    W7-Web (8 tasks)  P2A (Feishu) P3A (Calibration)
    P2B (Weekly) P2C (Integration)  P3B (E2E Tests)
         │ │ │
         └──── P2D ◄───────┘ │
         (依赖 P2B + P2C) │
                                              ▼
                                         P3C (Gate)
                                      (依赖 P3A + P3B)