create-yss-spec 3.3.0 → 3.3.3

package/template/docs/process/lifecycle-registry.yaml

@@ -1,24 +1,53 @@
 schema_version: 1
 registry_id: yss.lifecycle
-status: shadow
+status: active
 description: >-
-  YSS 生命周期结构化事实源。Phase 1 以 shadow/check 方式派生结构表并校验漂移，
-  不切换任何运行时状态 schema 或人工批准语义。
+  YSS 生命周期结构化事实源。聚合门禁与内部检查分别登记，运行时查询、批准核验和派生阅读视图共同消费本注册表。
 id_policy:
-  pattern: '^(stage|gate|artifact|work-unit|evidence)\.[a-z0-9][a-z0-9-]*$'
+  pattern: '^(stage|gate|check|artifact|work-unit|evidence)\.[a-z0-9][a-z0-9-]*$'
   published_ids_immutable: true
   baseline: docs/process/lifecycle-registry-baseline.json
-  deprecated_ids: [artifact.high-fidelity-html-prototype, work-unit.fresh-verification, work-unit.independent-review]
+  deprecated_ids:
+    - artifact.high-fidelity-html-prototype
+    - work-unit.fresh-verification
+    - work-unit.independent-review
+    - stage.discovery
+    - artifact.discovery-record
+    - work-unit.discovery-opportunity
+    - work-unit.discovery-requirements
+    - gate.frontend-delivery-inputs-verified
+    - gate.repository-identity-valid
+    - gate.domain-strategy-approved
+    - gate.stage-decision-package-approved
+    - gate.prototype-reviewed
+    - gate.prototype-verified
+    - gate.user-confirmation
+    - gate.openapi-draft-reviewed
+    - gate.design-reviewed
+    - gate.openapi-frozen
+    - gate.engineering-baseline-accepted
+    - gate.architecture-reviewed
+    - gate.implementation-repositories-ready
+    - gate.slice-ready-for-agent
+    - gate.frontend-implementation-verified
+    - gate.release-ready
 
 stages:
   - id: stage.entry-triage
     name: 入口分诊
     goal: 确认仓库身份、问题范围和影响面。
     exit_criteria: yss-project.yaml 合法，影响面和最近可信阶段可解释。
-  - id: stage.discovery
-    name: Discovery
-    goal: 澄清问题、用户、约束和机会。
-    exit_criteria: 问题边界、关键假设和待确认项已记录。
+  - id: stage.plan
+    name: Plan（战略规划）
+    goal: 确认目标、业务边界、关键规则、MVP / 非目标、优先级和交接责任，为 Spec 提供战略输入；按影响面探索并复用仍有效的结论。
+    exit_criteria: 命中的战略与阶段决策检查通过，用户统一批准当前 Plan；影响业务边界、关键规则或 MVP 的问题已解决，其他未决项有责任人和解决时点；下游可进入 Spec，不代表可实现。
+    spec_entry:
+      required_checks: [ goals, scope_and_priority, boundaries_and_rules, open_questions, handoff, context_reconciliation, grill_exit ]
+      gate_impacts:
+        gate.plan-approved: plan
+      check_impacts:
+        check.domain-strategy-approved: domain_strategy
+        check.stage-decision-package-approved: stage_decision
   - id: stage.spec-architecture
     name: Spec / 功能架构
     goal: 固化解决方案和功能边界。
@@ -118,101 +147,60 @@ evidence:
     description: 可追溯的变更边界、发布记录和恢复动作。
 
 gates:
-  - id: gate.frontend-delivery-inputs-verified
-    name: 前端联合输入核验
-    stage: stage.system-data-engineering
-    trigger: 专职前端 profile 或显式 frontend_delivery 绑定的任务启动、恢复、合同编译、实现和验证；实际执行 scripts/verify-frontend-delivery，输入就绪不等于实现获批。
-    evidence: [evidence.fresh-verification]
-  - id: gate.repository-identity-valid
-    name: 仓库身份校验
-    stage: stage.entry-triage
-    trigger: 每次进入流程。
-    evidence: [evidence.repository-identity-check]
-  - id: gate.domain-strategy-approved
-    name: DDD 战略设计批准
-    stage: stage.discovery
-    trigger: 存在 DDD 战略设计影响或需要确定领域边界、统一语言和核心规则。
-    public_name: 业务边界与规则确认
-    public_trigger: 需要确定业务板块、业务责任区、统一业务词汇、协作关系或关键规则。
-    evidence: [evidence.domain-strategy-review, evidence.approval-record]
-  - id: gate.stage-decision-package-approved
-    name: 阶段决策包批准
-    stage: stage.discovery
-    trigger: Discovery 到 Spec 入口需要稳定的阶段决策合同。
-    evidence: [evidence.stage-decision-package, evidence.approval-record]
-    requires_gates: [gate.domain-strategy-approved]
+  - id: gate.plan-approved
+    name: Plan 批准
+    stage: stage.plan
+    trigger: Plan 结论进入 Spec；汇总战略检查后仅确认一次当前规划范围。
+    evidence:
+      - evidence.approval-record
+    requires_checks:
+      - check.domain-strategy-approved
+      - check.stage-decision-package-approved
   - id: gate.spec-baseline-approved
     name: Spec 基线批准
     stage: stage.spec-architecture
     trigger: 新功能、行为变化或范围扩大进入 Spec 基线。
-    evidence: [evidence.approval-record]
-  - id: gate.prototype-reviewed
-    name: 原型评审
+    evidence:
+      - evidence.approval-record
+    requires_checks: []
+  - id: gate.product-design-approved
+    name: 产品设计批准
     stage: stage.product-design
-    trigger: 命中产品设计影响，且低保真页面、流程、状态或 API 反推需要独立评审。
-    evidence: [evidence.prototype-review-result]
-  - id: gate.prototype-verified
-    name: 原型交付物验证
-    stage: stage.product-design
-    trigger: 产品设计影响需要通过 H1/H2 原型交付物进行视觉或流程校准；真实组件验证留到前端实现阶段。
-    evidence: [evidence.prototype-profile-decision, evidence.prototype-deliverable-verification]
-  - id: gate.user-confirmation
-    name: 用户确认
-    stage: stage.product-design
-    trigger: 产品设计影响尚未被人工确认。
-    evidence: [evidence.prototype-confirmation]
-  - id: gate.openapi-draft-reviewed
-    name: OpenAPI Draft Review
-    stage: stage.system-data-engineering
-    trigger: 有 API 影响且 Draft 已生成。
-    evidence: [evidence.openapi-draft-review]
-  - id: gate.design-reviewed
-    name: 设计审查
+    trigger: 存在产品设计影响；独立原型评审与交付物验证通过后确认最终原型。
+    evidence:
+      - evidence.prototype-confirmation
+    requires_checks:
+      - check.prototype-reviewed
+      - check.prototype-verified
+  - id: gate.engineering-contract-approved
+    name: 工程契约批准
     stage: stage.system-data-engineering
-    trigger: API 或架构影响。
-    evidence: [evidence.design-review-result]
-  - id: gate.openapi-frozen
-    name: OpenAPI Freeze
-    stage: stage.system-data-engineering
-    trigger: API 进入实现。
-    evidence: [evidence.approval-record]
-  - id: gate.engineering-baseline-accepted
-    name: 工程基线
-    stage: stage.system-data-engineering
-    trigger: 后端、前端或高风险工程变化。
-    evidence: [evidence.fresh-verification]
-  - id: gate.architecture-reviewed
-    name: 架构审查
-    stage: stage.system-data-engineering
-    trigger: 高风险或跨边界变化。
-    evidence: [evidence.design-review-result]
-  - id: gate.implementation-repositories-ready
-    name: 实现仓库准备就绪
-    stage: stage.system-data-engineering
-    trigger: 后端或前端交付面进入 Ticket 正式化；未命中的交付面须记录带原因的 not-applicable。
-    evidence: [evidence.implementation-repository-preparation, evidence.fresh-verification]
-    requires_gates: [gate.engineering-baseline-accepted]
+    trigger: 存在 API、架构或工程基线影响；完成适用专业审查后统一批准，有 API 影响时同时冻结当前 OpenAPI。
+    evidence:
+      - evidence.approval-record
+      - evidence.fresh-verification
+    requires_checks:
+      - check.openapi-draft-reviewed
+      - check.design-reviewed
+      - check.architecture-reviewed
+      - check.engineering-baseline-accepted
+      - check.openapi-frozen
   - id: gate.slice-contract-approved
-    name: Slice Implementation Contract 批准
-    stage: stage.ticket-formalization
-    trigger: Agent 进入实现；脚手架完成后每个后续生成代码工作单元。
-    evidence: [evidence.contract-approval]
-  - id: gate.slice-ready-for-agent
-    name: 垂直切片实现就绪
+    name: 切片合同批准
     stage: stage.ticket-formalization
-    trigger: 垂直切片具备直接实现条件。
-    evidence: [evidence.contract-approval, evidence.approval-record]
-  - id: gate.frontend-implementation-verified
-    name: 前端实现还原验证
-    stage: stage.verification-release-retrospective
-    trigger: UI 影响切片完成实现并准备合并、发布或阶段完成。
-    evidence: [evidence.frontend-implementation-verification]
-  - id: gate.release-ready
-    name: 发布就绪
+    trigger: 主控在已授权范围内批准已持久化且当前的垂直切片合同；不代替就绪计算。
+    evidence:
+      - evidence.contract-approval
+    requires_checks: []
+  - id: gate.delivery-accepted
+    name: 交付验收
     stage: stage.verification-release-retrospective
-    trigger: 合并、发布或阶段完成。
-    evidence: [evidence.fresh-verification, evidence.checkpoint-and-rollback]
-    requires_gates: [gate.frontend-implementation-verified]
+    trigger: 实现交付验收；汇总独立审查、Fresh Verification 和回滚证据，不授予合并或发布权限。
+    evidence:
+      - evidence.fresh-verification
+      - evidence.checkpoint-and-rollback
+    requires_checks:
+      - check.frontend-implementation-verified
 
 artifacts:
   - id: artifact.impact-assessment
@@ -221,18 +209,18 @@ artifacts:
     trigger: 每次变更。
   - id: artifact.domain-strategy
     name: DDD 战略设计
-    stage: stage.discovery
+    stage: stage.plan
     trigger: 新产品/模块、跨上下文功能、统一语言冲突、服务边界或核心规则变化。
     public_name: 业务边界与规则设计
     public_trigger: 新产品/模块、跨责任区协作、业务词汇冲突、责任边界或关键规则变化。
   - id: artifact.stage-decision-package
     name: 阶段决策包
-    stage: stage.discovery
-    trigger: Discovery 到 Spec 入口需要结构化上游决策。
+    stage: stage.plan
+    trigger: Plan 到 Spec 入口需要结构化上游决策。
     public_name: 方案决策包
-  - id: artifact.discovery-record
-    name: Discovery 记录
-    stage: stage.discovery
+  - id: artifact.plan-record
+    name: Plan 记录
+    stage: stage.plan
     trigger: 新问题或边界不清。
   - id: artifact.spec
     name: Spec
@@ -384,13 +372,13 @@ work_units:
     input: 已审查 commit。
     output: release note、观察信号、回滚点。
     completion: 两仓库顺序和恢复动作明确。
-  - id: work-unit.discovery-opportunity
+  - id: work-unit.plan-opportunity
     name: 机会调研
     scope: project-instance
     input: 用户问题、市场/竞品事实需求和现有上下文。
-    output: Discovery 机会结论、证据、替代方案和关键假设。
+    output: Plan 机会结论、证据、替代方案和关键假设。
     completion: 机会继续/停止建议可审查；事实已 research 或记录为假设。
-  - id: work-unit.discovery-requirements
+  - id: work-unit.plan-requirements
     name: 需求分析
     scope: project-instance
     input: 机会结论、用户反馈和领域词汇。
@@ -408,16 +396,16 @@ work_units:
   - id: work-unit.stage-decision
     name: 阶段决策包综合
     scope: project-instance
-    input: Discovery、DDD 战略设计以及产品经理负责的商业约束输入。
+    input: Plan、DDD 战略设计以及产品经理负责的商业约束输入。
     output: 带版本、digest、证据和下游映射的阶段决策包。
     completion: 必填字段、引用、影响面和下游消费验证通过；批准门禁完成。
     public_name: 方案决策包综合
-    public_input: Discovery、业务边界与规则设计以及产品经理负责的商业约束输入。
+    public_input: Plan、业务边界与规则设计以及产品经理负责的商业约束输入。
     public_output: 带版本、digest、证据和下游映射的方案决策包。
   - id: work-unit.spec-synthesis
     name: Spec 综合
     scope: project-instance
-    input: 已确认的 Discovery 记录和测试 seam。
+    input: 已确认的 Plan 记录和测试 seam。
     output: Spec、产品总体设计和功能架构。
     completion: Spec 内容完整并进入 ready-for-human；下游推进仍需 gate.spec-baseline-approved。
   - id: work-unit.prototype-design
@@ -474,3 +462,99 @@ work_units:
     input: 已审查候选、发布窗口和回滚点。
     output: 发布/回滚证据和复盘记录。
     completion: 人工发布裁决、fresh verification 和治理回流均完成。
+checks:
+  - id: check.frontend-delivery-inputs-verified
+    name: 前端联合输入核验
+    stage: stage.system-data-engineering
+    trigger: 专职前端 profile 或显式 frontend_delivery 绑定的任务启动、恢复、合同编译、实现和验证；实际执行 scripts/verify-frontend-delivery，输入就绪不等于实现获批。
+    evidence:
+      - evidence.fresh-verification
+  - id: check.repository-identity-valid
+    name: 仓库身份校验
+    stage: stage.entry-triage
+    trigger: 每次进入流程。
+    evidence:
+      - evidence.repository-identity-check
+  - id: check.domain-strategy-approved
+    name: 业务边界与规则评审
+    stage: stage.plan
+    trigger: 存在 DDD 战略设计影响或需要确定领域边界、统一语言和核心规则。
+    public_name: 业务边界与规则评审
+    public_trigger: 需要确定业务板块、业务责任区、统一业务词汇、协作关系或关键规则。
+    evidence:
+      - evidence.domain-strategy-review
+      - evidence.approval-record
+  - id: check.stage-decision-package-approved
+    name: 阶段决策包评审
+    stage: stage.plan
+    trigger: Plan 到 Spec 入口需要稳定的阶段决策合同。
+    evidence:
+      - evidence.stage-decision-package
+      - evidence.approval-record
+    requires_checks:
+      - check.domain-strategy-approved
+  - id: check.prototype-reviewed
+    name: 原型评审
+    stage: stage.product-design
+    trigger: 命中产品设计影响，且低保真页面、流程、状态或 API 反推需要独立评审。
+    evidence:
+      - evidence.prototype-review-result
+  - id: check.prototype-verified
+    name: 原型交付物验证
+    stage: stage.product-design
+    trigger: 产品设计影响需要通过 H1/H2 原型交付物进行视觉或流程校准；真实组件验证留到前端实现阶段。
+    evidence:
+      - evidence.prototype-profile-decision
+      - evidence.prototype-deliverable-verification
+  - id: check.openapi-draft-reviewed
+    name: OpenAPI Draft Review
+    stage: stage.system-data-engineering
+    trigger: 有 API 影响且 Draft 已生成。
+    evidence:
+      - evidence.openapi-draft-review
+  - id: check.design-reviewed
+    name: 设计审查
+    stage: stage.system-data-engineering
+    trigger: API 或架构影响。
+    evidence:
+      - evidence.design-review-result
+  - id: check.openapi-frozen
+    name: OpenAPI 冻结准备
+    stage: stage.system-data-engineering
+    trigger: 有 API 影响；确认待冻结版本、Draft 审查和契约绑定，工程契约批准后原子冻结同一版本。
+    evidence:
+      - evidence.openapi-draft-review
+  - id: check.engineering-baseline-accepted
+    name: 工程基线
+    stage: stage.system-data-engineering
+    trigger: 后端、前端或高风险工程变化。
+    evidence:
+      - evidence.fresh-verification
+  - id: check.architecture-reviewed
+    name: 架构审查
+    stage: stage.system-data-engineering
+    trigger: 高风险或跨边界变化。
+    evidence:
+      - evidence.design-review-result
+  - id: check.implementation-repositories-ready
+    name: 实现仓库准备就绪
+    stage: stage.system-data-engineering
+    trigger: 后端或前端交付面进入 Ticket 正式化；未命中的交付面须记录带原因的 not-applicable。
+    evidence:
+      - evidence.implementation-repository-preparation
+      - evidence.fresh-verification
+    requires_checks:
+      - check.engineering-baseline-accepted
+  - id: check.slice-ready-for-agent
+    name: 垂直切片实现就绪
+    stage: stage.ticket-formalization
+    trigger: 垂直切片具备直接实现条件。
+    evidence:
+      - evidence.contract-approval
+      - evidence.fresh-verification
+  - id: check.frontend-implementation-verified
+    name: 前端实现还原验证
+    stage: stage.verification-release-retrospective
+    trigger: UI 影响切片完成实现并准备合并、发布或阶段完成。
+    evidence:
+      - evidence.frontend-implementation-verification

package/template/docs/process/plan-migration.md

@@ -0,0 +1,13 @@
+# Plan 阶段切换说明
+
+新流程仅使用 `stage.plan`、`artifact.plan-record`、`work-unit.plan-opportunity` 和 `work-unit.plan-requirements`。不提供 Discovery 阶段别名、旧标识解析或兼容入口；旧 ID 在注册表中仅作为弃用清单保留，以防重新分配，不可执行。
+
+新工作从 `docs/plan/templates/plan-template.md` 起草，工作目录为 `docs/.scratch/<feature>/plan/`。问题、机会和事实探索是 Plan 内按影响面执行的活动。
+
+历史冻结文档、批准记录和摘要保持原字节。旧状态不能直接恢复执行；如需继续，按当前 Plan 模板重新整理输入并核查当前退出条件，不把旧批准自动视为新流程批准。已有事实和结论可引用，但须记录当前版本、适用范围和复用理由。
+
+综合模板和战略设计模板共同采用 Plan。它为 Spec 提供战略输入；后续 Spec、页面原型、契约、Ticket 及交接边界仍由各自 profile 和生命周期注册表定义。Plan 不等同于实现合同中的 Context Plan。
+
+影响业务边界、关键规则或 MVP 的未决项必须在进入 Spec 前解决；其他细节须经用户确认延期，并具备不影响当前决定的依据、责任人、解决时点和接收方。既有 runnable blocker 不得降为普通延期项。
+
+Plan 是借鉴 AI-DLC 前置规划职责的本地名称，不宣称是 AWS 官方阶段名称或完整 Inception。

package/template/docs/process/schemas/digital-human-task-package.schema.json

@@ -6,6 +6,8 @@
   "additionalProperties": false,
   "required": ["schema_version", "task_id", "work_unit_id", "actor_id", "role_id", "runtime_id", "execution_state", "workflow_status", "skill_source", "contract", "inputs", "objective", "allowed_write_paths", "forbidden_actions", "expected_outputs", "expected_evidence_files", "verification_commands", "verification_results", "downstream_consumers", "convergence"],
   "properties": {
+    "plan_review_ref": { "type": "string", "minLength": 1 },
+    "plan_user_decision_ref": { "type": "string", "minLength": 1 },
     "schema_version": { "const": 1 },
     "frontend_delivery": {
       "type": "object", "additionalProperties": false, "required": ["acceptance_ref"],

package/template/docs/process/schemas/lifecycle-checkpoint.schema.json

@@ -4,25 +4,106 @@
   "title": "YSS 生命周期 Checkpoint",
   "type": "object",
   "additionalProperties": false,
-  "required": ["schema_version", "repository_mode", "mode", "status", "stage", "artifacts", "gates", "context_reconciliation", "next_work_unit", "ticket_sync", "verification", "human_review", "git_checkpoint", "blockers", "rollback"],
+  "required": [
+    "schema_version",
+    "repository_mode",
+    "mode",
+    "status",
+    "stage",
+    "artifacts",
+    "gates",
+    "context_reconciliation",
+    "next_work_unit",
+    "ticket_sync",
+    "verification",
+    "human_review",
+    "git_checkpoint",
+    "blockers",
+    "rollback"
+  ],
   "properties": {
-    "schema_version": { "const": 1 },
-    "repository_mode": { "enum": ["template-source", "project-instance"] },
-    "mode": { "enum": ["route", "orchestrate", "resume", "audit"] },
-    "status": { "enum": ["routing", "running", "paused-human-gate", "blocked", "completed"] },
-    "stage": { "type": "string", "pattern": "^stage\\.[a-z0-9][a-z0-9-]*$" },
+    "plan_review_ref": {
+      "type": "string",
+      "minLength": 1
+    },
+    "plan_user_decision_ref": {
+      "type": "string",
+      "minLength": 1
+    },
+    "feature_id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "schema_version": {
+      "const": 1
+    },
+    "repository_mode": {
+      "enum": [
+        "template-source",
+        "project-instance"
+      ]
+    },
+    "mode": {
+      "enum": [
+        "route",
+        "orchestrate",
+        "resume",
+        "audit"
+      ]
+    },
+    "status": {
+      "enum": [
+        "routing",
+        "running",
+        "paused-human-gate",
+        "blocked",
+        "completed"
+      ]
+    },
+    "stage": {
+      "type": "string",
+      "pattern": "^stage\\.[a-z0-9][a-z0-9-]*$"
+    },
     "artifacts": {
       "type": "object",
       "patternProperties": {
         "^artifact\\.[a-z0-9][a-z0-9-]*$": {
           "type": "object",
           "additionalProperties": false,
-          "required": ["status", "ref", "evidence_refs"],
+          "required": [
+            "status",
+            "ref",
+            "evidence_refs"
+          ],
           "properties": {
-            "status": { "enum": ["missing", "draft", "ready-for-human", "approved", "stale", "not-applicable"] },
-            "ref": { "type": ["string", "null"] },
-            "evidence_refs": { "type": "array", "items": { "type": "string" } },
-            "stale_by": { "type": "array", "items": { "type": "string" } }
+            "status": {
+              "enum": [
+                "missing",
+                "draft",
+                "ready-for-human",
+                "approved",
+                "stale",
+                "not-applicable"
+              ]
+            },
+            "ref": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "evidence_refs": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "stale_by": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
           }
         }
       },
@@ -34,14 +115,59 @@
         "^gate\\.[a-z0-9][a-z0-9-]*$": {
           "type": "object",
           "additionalProperties": false,
-          "required": ["status", "reason", "evidence_refs"],
+          "required": [
+            "status",
+            "reason",
+            "evidence_refs"
+          ],
           "properties": {
-            "status": { "enum": ["not-evaluated", "blocked", "ready-for-human", "approved", "stale", "not-applicable"] },
-            "reason": { "type": "string" },
-            "evidence_refs": { "type": "array", "items": { "type": "string" } },
-            "approval_ref": { "type": ["string", "null"] },
-            "subject_ref": { "type": "string", "minLength": 1 },
-            "approval_scope": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } }
+            "status": {
+              "enum": [
+                "not-evaluated",
+                "blocked",
+                "ready-for-human",
+                "approved",
+                "stale",
+                "not-applicable"
+              ]
+            },
+            "reason": {
+              "type": "string"
+            },
+            "evidence_refs": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "approval_ref": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "subject_ref": {
+              "type": "string",
+              "minLength": 1
+            },
+            "approval_scope": {
+              "type": "array",
+              "minItems": 1,
+              "uniqueItems": true,
+              "items": {
+                "type": "string",
+                "minLength": 1
+              }
+            },
+            "evidence": {
+              "type": "object"
+            },
+            "basis": {
+              "type": "array"
+            },
+            "checks": {
+              "type": "object"
+            }
           }
         }
       },
@@ -50,22 +176,76 @@
     "context_reconciliation": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["status", "ref", "evidence_refs"],
+      "required": [
+        "status",
+        "ref",
+        "evidence_refs"
+      ],
       "properties": {
-        "status": { "enum": ["pending", "reconciled", "not-applicable", "blocked"] },
-        "ref": { "type": ["string", "null"] },
-        "reason": { "type": "string" },
-        "evidence_refs": { "type": "array", "items": { "type": "string" } }
+        "status": {
+          "enum": [
+            "pending",
+            "reconciled",
+            "not-applicable",
+            "blocked"
+          ]
+        },
+        "ref": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "reason": {
+          "type": "string"
+        },
+        "evidence_refs": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
       }
     },
-    "next_work_unit": { "type": ["string", "null"], "pattern": "^work-unit\\.[a-z0-9][a-z0-9-]*$" },
-    "phase_boundary": { "type": "object" },
-    "stage_trace": { "type": "object" },
-    "ticket_sync": { "type": "object" },
-    "verification": { "type": "object" },
-    "human_review": { "type": "object" },
-    "git_checkpoint": { "type": "object" },
-    "blockers": { "type": "array" },
-    "rollback": { "type": "array" }
+    "next_work_unit": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "pattern": "^work-unit\\.[a-z0-9][a-z0-9-]*$"
+    },
+    "phase_boundary": {
+      "type": "object"
+    },
+    "stage_trace": {
+      "type": "object"
+    },
+    "ticket_sync": {
+      "type": "object"
+    },
+    "verification": {
+      "type": "object"
+    },
+    "human_review": {
+      "type": "object"
+    },
+    "git_checkpoint": {
+      "type": "object"
+    },
+    "blockers": {
+      "type": "array"
+    },
+    "rollback": {
+      "type": "array"
+    },
+    "checks": {
+      "type": "object",
+      "patternProperties": {
+        "^check\\.[a-z0-9][a-z0-9-]*$": {
+          "type": "object"
+        }
+      },
+      "additionalProperties": false
+    }
   }
 }