create-yss-spec 2.1.3 → 2.1.4

package/template/docs/process/lifecycle-artifact-map.md

@@ -1,48 +1,84 @@
 # YSS 生命周期产物与门禁地图
 
-本文是模板仓库与模板实例共享的生命周期事实源。它定义主阶段、条件门禁、必须持久化的产物和退出标准；具体项目只有在触发条件命中时才执行对应门禁。
+本文是模板仓库与模板实例共享的生命周期派生阅读视图。结构化事实源是 `docs/process/lifecycle-registry.yaml`；本文解释主阶段、条件门禁、必须持久化的产物和退出标准。具体项目只有在触发条件命中时才执行对应门禁。
 
-## 1. 八个主阶段
+<!-- lifecycle-registry:structure:start -->
+> 此结构区由 `docs/process/lifecycle-registry.yaml` 生成。当前为 `shadow` 模式：它校验结构和派生文档，不改变运行时状态 schema 或人工批准语义。
 
-| 阶段 | 目标 | 主要产物 | 退出标准 |
+## 1. 主阶段
+
+| 稳定 ID | 阶段 | 目标 | 退出标准 |
+|---|---|---|---|
+| `stage.entry-triage` | 入口分诊 | 确认仓库身份、问题范围和影响面。 | yss-project.yaml 合法，影响面和最近可信阶段可解释。 |
+| `stage.discovery` | Discovery | 澄清问题、用户、约束和机会。 | 问题边界、关键假设和待确认项已记录。 |
+| `stage.spec-architecture` | Spec / 功能架构 | 固化解决方案和功能边界。 | Spec 基线和功能边界可审查。 |
+| `stage.product-design` | 产品设计 | 在存在产品设计影响时校准页面流和状态。 | 命中的设计门禁通过；未命中项记录 not-applicable 及原因。 |
+| `stage.system-data-engineering` | 系统 / 数据架构与工程契约 | 固化系统、数据、工程基线和 API 契约。 | 受影响工程契约冻结或记录无 API 影响；required 脚手架证据齐全。 |
+| `stage.ticket-formalization` | Ticket 正式化 | 将冻结范围拆为可追踪的父 Ticket 和垂直切片。 | 工作单元窄、依赖清晰、验收和测试 seam 可执行。 |
+| `stage.vertical-slice-implementation` | 垂直切片实现 | 以批准合同驱动 TDD 实现和跨仓库协作。 | 允许写路径、禁止模式、证据和验证命令全部满足。 |
+| `stage.verification-release-retrospective` | 验证 / 发布 / 复盘 | 完成 fresh verification、发布和回顾。 | 所有命中门禁通过，人工审查点已完成，checkpoint 可追溯。 |
+
+## 2. 生命周期对象
+
+门禁是需要裁决的审查点；产物、工作单元和证据不是门禁的同义词。未命中条件的门禁记录 `not-applicable` 及原因，不生成空文档。
+
+### 2.1 条件门禁
+
+| 稳定 ID | 门禁 | 所属阶段 | 触发条件 | 必须留下的证据 |
+|---|---|---|---|---|
+| `gate.repository-identity-valid` | 仓库身份校验 | `stage.entry-triage` | 每次进入流程。 | `evidence.repository-identity-check` |
+| `gate.spec-baseline-approved` | Spec 基线批准 | `stage.spec-architecture` | 新功能、行为变化或范围扩大进入 Spec 基线。 | `evidence.approval-record` |
+| `gate.user-confirmation` | 用户确认 | `stage.product-design` | 产品设计影响尚未被人工确认。 | `evidence.approval-record` |
+| `gate.openapi-draft-reviewed` | OpenAPI Draft Review | `stage.system-data-engineering` | 有 API 影响且 Draft 已生成。 | `evidence.openapi-draft-review` |
+| `gate.design-reviewed` | 设计审查 | `stage.system-data-engineering` | API 或架构影响。 | `evidence.design-review-result` |
+| `gate.openapi-frozen` | OpenAPI Freeze | `stage.system-data-engineering` | API 进入实现。 | `evidence.approval-record` |
+| `gate.engineering-baseline-accepted` | 工程基线 | `stage.system-data-engineering` | 后端、前端或高风险工程变化。 | `evidence.fresh-verification` |
+| `gate.architecture-reviewed` | 架构审查 | `stage.system-data-engineering` | 高风险或跨边界变化。 | `evidence.design-review-result` |
+| `gate.slice-contract-approved` | Slice Implementation Contract 批准 | `stage.ticket-formalization` | Agent 进入实现；脚手架完成后每个后续生成代码工作单元。 | `evidence.contract-approval` |
+| `gate.slice-ready-for-agent` | 垂直切片实现就绪 | `stage.ticket-formalization` | 垂直切片具备直接实现条件。 | `evidence.contract-approval`、`evidence.approval-record` |
+| `gate.release-ready` | 发布就绪 | `stage.verification-release-retrospective` | 合并、发布或阶段完成。 | `evidence.fresh-verification`、`evidence.checkpoint-and-rollback` |
+
+### 2.2 生命周期产物
+
+| 稳定 ID | 产物 | 所属阶段 | 触发条件 |
 |---|---|---|---|
-| 入口分诊 | 确认仓库身份、问题范围和影响面 | 入口分诊记录、仓库身份清单 | `yss-project.yaml` 合法，影响面和最近可信阶段可解释 |
-| Discovery | 澄清问题、用户、约束和机会 | Discovery 记录、问题陈述 | 问题边界、关键假设和待确认项已记录 |
-| Spec / 功能架构 | 固化解决方案和功能边界 | Spec、产品总体设计、功能架构 | Spec 基线和功能边界可审查 |
-| 产品设计 | 在存在产品设计影响时校准页面流和状态 | 低保真草图、状态矩阵、高保真 HTML 原型、用户确认 | 触发的设计门禁通过；未触发项记录 `not-applicable` 及原因 |
-| 系统 / 数据架构与工程契约 | 固化系统、数据、工程基线和 API 契约；原型确认后为新后端服务建立 YSS 工程骨架 | 架构审查、工程基线、后端脚手架生成结果、OpenAPI Draft / Freeze、ADR | 受影响的工程契约冻结或记录无 API 影响；backend `scaffold_status=required` 时脚手架、基线校验和 Router 重编译证据齐全 |
-| Ticket 正式化 | 将冻结范围拆为可追踪的父 Ticket 和垂直切片 | 功能父 Ticket、垂直切片 Ticket | 工作单元窄、依赖清晰、验收和测试 seam 可执行 |
-| 垂直切片实现 | 以批准合同驱动 TDD 实现和跨仓库协作 | Slice Implementation Contract、代码、测试、YSS Skill Execution Result | 允许写路径、禁止模式、证据和验证命令全部满足 |
-| 验证 / 发布 / 复盘 | 完成 fresh verification、发布和回顾 | 验证记录、发布记录、回滚点、复盘 | 所有命中的门禁通过，人工审查点已完成，checkpoint 可追溯 |
-
-## 2. 条件门禁与产物
-
-| 门禁 | 触发条件 | 必须留下的证据 |
+| `artifact.impact-assessment` | 影响面分析 | `stage.entry-triage` | 每次变更。 |
+| `artifact.discovery-record` | Discovery 记录 | `stage.discovery` | 新问题或边界不清。 |
+| `artifact.spec` | Spec | `stage.spec-architecture` | 新功能、行为变化或范围扩大。 |
+| `artifact.product-overview` | 产品总体设计 | `stage.spec-architecture` | 进入 Spec 基线。 |
+| `artifact.functional-architecture` | 功能架构 | `stage.spec-architecture` | 新模块或跨边界变化。 |
+| `artifact.low-fidelity-prototype` | 低保真原型 | `stage.product-design` | 命中产品设计影响。 |
+| `artifact.state-matrix` | 状态矩阵 | `stage.product-design` | 存在状态流转、异常或恢复。 |
+| `artifact.high-fidelity-html-prototype` | 高保真 HTML 原型 | `stage.product-design` | 需要视觉与交互校准。 |
+| `artifact.openapi-draft` | OpenAPI Draft | `stage.system-data-engineering` | 有 API 影响。 |
+| `artifact.openapi-freeze-record` | OpenAPI Freeze 记录 | `stage.system-data-engineering` | API 进入实现。 |
+| `artifact.data-architecture` | 数据架构 | `stage.system-data-engineering` | 数据模型、存储或一致性变化。 |
+| `artifact.engineering-baseline` | 工程基线记录 | `stage.system-data-engineering` | 后端、前端或高风险工程变化。 |
+| `artifact.architecture-review` | 架构审查记录 | `stage.system-data-engineering` | 高风险或跨边界变化。 |
+| `artifact.spec-delta` | Spec Delta | `stage.spec-architecture` | 已有冻结 Spec 的高风险行为变化。 |
+| `artifact.parent-ticket` | 功能父 Ticket | `stage.ticket-formalization` | 每个进入追踪的功能。 |
+| `artifact.vertical-slice-ticket` | 垂直切片 Ticket | `stage.ticket-formalization` | 进入实现前。 |
+| `artifact.slice-implementation-contract` | Slice Implementation Contract | `stage.ticket-formalization` | Agent 进入实现。 |
+| `artifact.retrospective` | 复盘记录 | `stage.verification-release-retrospective` | 发布后或阶段性完成后满足复盘触发条件。 |
+
+### 2.3 执行证据
+
+| 稳定 ID | 证据 | 说明 |
 |---|---|---|
-| 影响面分析 | 每次变更 | 受影响仓库、资产和风险 |
-| 仓库身份校验 | 每次进入流程 | `yss-project.yaml` 校验结果 |
-| Discovery | 新问题或边界不清 | Discovery 记录 |
-| Spec | 新功能、行为变化或范围扩大 | Spec 基线 |
-| 产品总体设计 | 进入 Spec 基线 | 总体设计或功能架构 |
-| 功能架构 | 新模块或跨边界变化 | 功能架构图 / 说明 |
-| 低保真原型 | 命中产品设计影响 | 页面流草图 |
-| 状态矩阵 | 存在状态流转、异常或恢复 | 状态矩阵 |
-| 高保真 HTML 原型 | 需要视觉与交互校准 | 原型地址和审查结果 |
-| 用户确认 | 产品设计影响未被人工确认 | 确认记录 |
-| OpenAPI Draft | 有 API 影响 | OpenAPI 3.1 Draft |
-| 设计审查 | API 或架构影响 | 审查意见和处理结果 |
-| OpenAPI Freeze | API 进入实现 | Freeze 版本和消费者确认 |
-| 数据架构 | 数据模型、存储或一致性变化 | 数据架构记录 |
-| 工程基线 | 后端、前端或高风险工程变化 | 工程基线、项目根路径和验证命令；Harness 内项目必须符合 `apps/backend/<project>/` / `apps/frontend/<project>/`，新后端还需脚手架登记、Router 脚手架合同 draft / 生命周期批准记录、生成器输入 / 预期文件、`./mvnw` 结果和 YSS Skill Execution Result |
-| 架构审查 | 高风险或跨边界变化 | 架构审查记录 |
-| Spec Delta | 已有冻结 Spec 的高风险行为变化 | `ADDED / MODIFIED / REMOVED` 差异 |
-| 功能父 Ticket | 每个进入追踪的功能 | `parent-ticket.md` 或远程父 Ticket |
-| 垂直切片 Ticket | 进入实现前 | 可独立验证的切片 Ticket |
-| Slice Implementation Contract | Agent 进入实现；脚手架完成后每个后续生成代码工作单元 | 批准的 Slice Implementation Contract、当前版本、YSS skill 闭包和写路径 / 证据约束 |
-| YSS Skill Execution Result | YSS 专项 skill 完成工作单元 | YSS Skill Execution Result |
-| Fresh Verification / 发布 | 合并、发布或阶段完成 | fresh verification、release、rollback、checkpoint |
-
-所有门禁都是条件强制门禁。未命中触发条件时，必须明确记录 `not-applicable` 及原因；不生成空文档。完成结论必须同时包含批准的 Slice Implementation Contract 与 YSS Skill Execution Result（若进入实现阶段）。
+| `evidence.impact-assessment` | 影响面分析记录 | 受影响仓库、资产、风险与最近可信阶段。 |
+| `evidence.repository-identity-check` | 仓库身份校验结果 | yss-project.yaml 的合法性与 repository_mode 裁决。 |
+| `evidence.approval-record` | 人工批准记录 | 对需要人工批准的 Spec、设计、契约或发布裁决的可追溯记录。 |
+| `evidence.design-review-result` | 设计审查结果 | API、架构或产品设计审查意见及处理结果。 |
+| `evidence.openapi-draft-review` | OpenAPI Draft 审查记录 | P0、错误、分页、幂等和契约测试审查记录。 |
+| `evidence.contract-approval` | Slice 合同批准记录 | 生命周期编排器批准且已持久化的当前版本合同引用。 |
+| `evidence.yss-skill-execution-result` | YSS Skill Execution Result | 专项 skill 的合同版本、写入、验证、延期 seam 与偏离证据。 |
+| `evidence.fresh-verification` | Fresh Verification 记录 | 本轮实际执行的验证命令、结果和时间。 |
+| `evidence.checkpoint-and-rollback` | Checkpoint 与回滚点 | 可追溯的变更边界、发布记录和恢复动作。 |
+<!-- lifecycle-registry:structure:end -->
+
+完成结论必须同时包含批准的 Slice Implementation Contract 与 YSS Skill Execution Result（若进入实现阶段）。
+
+安全 / 权限不形成独立门禁。只有需求或冻结资产明确改变相关业务行为时，才把它写入普通产物，并按实际 UI、API、Backend、Data、High-risk 影响使用上表既有门禁。
 
 ## 3. 退出与 checkpoint
 

package/template/docs/process/lifecycle-registry-baseline.json

@@ -0,0 +1,61 @@
+{
+  "schema_version": 1,
+  "registry_id": "yss.lifecycle",
+  "semantic_sha256": "33fcc66059b7c630d15541d615dc13b3c5907c77f5f2bf77a5d9e753a2a58c8e",
+  "published_ids": [
+    "artifact.architecture-review",
+    "artifact.data-architecture",
+    "artifact.discovery-record",
+    "artifact.engineering-baseline",
+    "artifact.functional-architecture",
+    "artifact.high-fidelity-html-prototype",
+    "artifact.impact-assessment",
+    "artifact.low-fidelity-prototype",
+    "artifact.openapi-draft",
+    "artifact.openapi-freeze-record",
+    "artifact.parent-ticket",
+    "artifact.product-overview",
+    "artifact.retrospective",
+    "artifact.slice-implementation-contract",
+    "artifact.spec",
+    "artifact.spec-delta",
+    "artifact.state-matrix",
+    "artifact.vertical-slice-ticket",
+    "evidence.approval-record",
+    "evidence.checkpoint-and-rollback",
+    "evidence.contract-approval",
+    "evidence.design-review-result",
+    "evidence.fresh-verification",
+    "evidence.impact-assessment",
+    "evidence.openapi-draft-review",
+    "evidence.repository-identity-check",
+    "evidence.yss-skill-execution-result",
+    "gate.architecture-reviewed",
+    "gate.design-reviewed",
+    "gate.engineering-baseline-accepted",
+    "gate.openapi-draft-reviewed",
+    "gate.openapi-frozen",
+    "gate.release-ready",
+    "gate.repository-identity-valid",
+    "gate.slice-contract-approved",
+    "gate.slice-ready-for-agent",
+    "gate.spec-baseline-approved",
+    "gate.user-confirmation",
+    "stage.discovery",
+    "stage.entry-triage",
+    "stage.product-design",
+    "stage.spec-architecture",
+    "stage.system-data-engineering",
+    "stage.ticket-formalization",
+    "stage.verification-release-retrospective",
+    "stage.vertical-slice-implementation",
+    "work-unit.attach-sync-integration",
+    "work-unit.entry-triage",
+    "work-unit.fresh-verification",
+    "work-unit.independent-review",
+    "work-unit.release-and-rollback",
+    "work-unit.skill-projection-sync",
+    "work-unit.ssot-update",
+    "work-unit.template-snapshot-build"
+  ]
+}

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

@@ -0,0 +1,255 @@
+schema_version: 1
+registry_id: yss.lifecycle
+status: shadow
+description: >-
+  YSS 生命周期结构化事实源。Phase 1 以 shadow/check 方式派生结构表并校验漂移，
+  不切换任何运行时状态 schema 或人工批准语义。
+id_policy:
+  pattern: '^(stage|gate|artifact|work-unit|evidence)\.[a-z0-9][a-z0-9-]*$'
+  published_ids_immutable: true
+  baseline: docs/process/lifecycle-registry-baseline.json
+  deprecated_ids: []
+
+stages:
+  - id: stage.entry-triage
+    name: 入口分诊
+    goal: 确认仓库身份、问题范围和影响面。
+    exit_criteria: yss-project.yaml 合法，影响面和最近可信阶段可解释。
+  - id: stage.discovery
+    name: Discovery
+    goal: 澄清问题、用户、约束和机会。
+    exit_criteria: 问题边界、关键假设和待确认项已记录。
+  - id: stage.spec-architecture
+    name: Spec / 功能架构
+    goal: 固化解决方案和功能边界。
+    exit_criteria: Spec 基线和功能边界可审查。
+  - id: stage.product-design
+    name: 产品设计
+    goal: 在存在产品设计影响时校准页面流和状态。
+    exit_criteria: 命中的设计门禁通过；未命中项记录 not-applicable 及原因。
+  - id: stage.system-data-engineering
+    name: 系统 / 数据架构与工程契约
+    goal: 固化系统、数据、工程基线和 API 契约。
+    exit_criteria: 受影响工程契约冻结或记录无 API 影响；required 脚手架证据齐全。
+  - id: stage.ticket-formalization
+    name: Ticket 正式化
+    goal: 将冻结范围拆为可追踪的父 Ticket 和垂直切片。
+    exit_criteria: 工作单元窄、依赖清晰、验收和测试 seam 可执行。
+  - id: stage.vertical-slice-implementation
+    name: 垂直切片实现
+    goal: 以批准合同驱动 TDD 实现和跨仓库协作。
+    exit_criteria: 允许写路径、禁止模式、证据和验证命令全部满足。
+  - id: stage.verification-release-retrospective
+    name: 验证 / 发布 / 复盘
+    goal: 完成 fresh verification、发布和回顾。
+    exit_criteria: 所有命中门禁通过，人工审查点已完成，checkpoint 可追溯。
+
+evidence:
+  - id: evidence.impact-assessment
+    name: 影响面分析记录
+    description: 受影响仓库、资产、风险与最近可信阶段。
+  - id: evidence.repository-identity-check
+    name: 仓库身份校验结果
+    description: yss-project.yaml 的合法性与 repository_mode 裁决。
+  - id: evidence.approval-record
+    name: 人工批准记录
+    description: 对需要人工批准的 Spec、设计、契约或发布裁决的可追溯记录。
+  - id: evidence.design-review-result
+    name: 设计审查结果
+    description: API、架构或产品设计审查意见及处理结果。
+  - id: evidence.openapi-draft-review
+    name: OpenAPI Draft 审查记录
+    description: P0、错误、分页、幂等和契约测试审查记录。
+  - id: evidence.contract-approval
+    name: Slice 合同批准记录
+    description: 生命周期编排器批准且已持久化的当前版本合同引用。
+  - id: evidence.yss-skill-execution-result
+    name: YSS Skill Execution Result
+    description: 专项 skill 的合同版本、写入、验证、延期 seam 与偏离证据。
+  - id: evidence.fresh-verification
+    name: Fresh Verification 记录
+    description: 本轮实际执行的验证命令、结果和时间。
+  - id: evidence.checkpoint-and-rollback
+    name: Checkpoint 与回滚点
+    description: 可追溯的变更边界、发布记录和恢复动作。
+
+gates:
+  - id: gate.repository-identity-valid
+    name: 仓库身份校验
+    stage: stage.entry-triage
+    trigger: 每次进入流程。
+    evidence: [evidence.repository-identity-check]
+  - id: gate.spec-baseline-approved
+    name: Spec 基线批准
+    stage: stage.spec-architecture
+    trigger: 新功能、行为变化或范围扩大进入 Spec 基线。
+    evidence: [evidence.approval-record]
+  - id: gate.user-confirmation
+    name: 用户确认
+    stage: stage.product-design
+    trigger: 产品设计影响尚未被人工确认。
+    evidence: [evidence.approval-record]
+  - 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: 设计审查
+    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.slice-contract-approved
+    name: Slice Implementation Contract 批准
+    stage: stage.ticket-formalization
+    trigger: Agent 进入实现；脚手架完成后每个后续生成代码工作单元。
+    evidence: [evidence.contract-approval]
+  - id: gate.slice-ready-for-agent
+    name: 垂直切片实现就绪
+    stage: stage.ticket-formalization
+    trigger: 垂直切片具备直接实现条件。
+    evidence: [evidence.contract-approval, evidence.approval-record]
+  - id: gate.release-ready
+    name: 发布就绪
+    stage: stage.verification-release-retrospective
+    trigger: 合并、发布或阶段完成。
+    evidence: [evidence.fresh-verification, evidence.checkpoint-and-rollback]
+
+artifacts:
+  - id: artifact.impact-assessment
+    name: 影响面分析
+    stage: stage.entry-triage
+    trigger: 每次变更。
+  - id: artifact.discovery-record
+    name: Discovery 记录
+    stage: stage.discovery
+    trigger: 新问题或边界不清。
+  - id: artifact.spec
+    name: Spec
+    stage: stage.spec-architecture
+    trigger: 新功能、行为变化或范围扩大。
+  - id: artifact.product-overview
+    name: 产品总体设计
+    stage: stage.spec-architecture
+    trigger: 进入 Spec 基线。
+  - id: artifact.functional-architecture
+    name: 功能架构
+    stage: stage.spec-architecture
+    trigger: 新模块或跨边界变化。
+  - id: artifact.low-fidelity-prototype
+    name: 低保真原型
+    stage: stage.product-design
+    trigger: 命中产品设计影响。
+  - id: artifact.state-matrix
+    name: 状态矩阵
+    stage: stage.product-design
+    trigger: 存在状态流转、异常或恢复。
+  - id: artifact.high-fidelity-html-prototype
+    name: 高保真 HTML 原型
+    stage: stage.product-design
+    trigger: 需要视觉与交互校准。
+  - id: artifact.openapi-draft
+    name: OpenAPI Draft
+    stage: stage.system-data-engineering
+    trigger: 有 API 影响。
+  - id: artifact.openapi-freeze-record
+    name: OpenAPI Freeze 记录
+    stage: stage.system-data-engineering
+    trigger: API 进入实现。
+  - id: artifact.data-architecture
+    name: 数据架构
+    stage: stage.system-data-engineering
+    trigger: 数据模型、存储或一致性变化。
+  - id: artifact.engineering-baseline
+    name: 工程基线记录
+    stage: stage.system-data-engineering
+    trigger: 后端、前端或高风险工程变化。
+  - id: artifact.architecture-review
+    name: 架构审查记录
+    stage: stage.system-data-engineering
+    trigger: 高风险或跨边界变化。
+  - id: artifact.spec-delta
+    name: Spec Delta
+    stage: stage.spec-architecture
+    trigger: 已有冻结 Spec 的高风险行为变化。
+  - id: artifact.parent-ticket
+    name: 功能父 Ticket
+    stage: stage.ticket-formalization
+    trigger: 每个进入追踪的功能。
+  - id: artifact.vertical-slice-ticket
+    name: 垂直切片 Ticket
+    stage: stage.ticket-formalization
+    trigger: 进入实现前。
+  - id: artifact.slice-implementation-contract
+    name: Slice Implementation Contract
+    stage: stage.ticket-formalization
+    trigger: Agent 进入实现。
+  - id: artifact.retrospective
+    name: 复盘记录
+    stage: stage.verification-release-retrospective
+    trigger: 发布后或阶段性完成后满足复盘触发条件。
+
+work_units:
+  - id: work-unit.entry-triage
+    name: 入口分诊
+    scope: template-source
+    input: 用户请求、仓库身份。
+    output: 影响面与最近可信阶段。
+    completion: 身份和影响面可解释。
+  - id: work-unit.ssot-update
+    name: 单一事实源更新
+    scope: template-source
+    input: 变更合同。
+    output: 权威文档或脚本。
+    completion: 其他投影可由脚本生成。
+  - id: work-unit.skill-projection-sync
+    name: 技能投影同步
+    scope: template-source
+    input: .agents/skills。
+    output: Agent root 投影、skills lock。
+    completion: --check 通过。
+  - id: work-unit.template-snapshot-build
+    name: 模板快照构建
+    scope: template-source
+    input: 固定模板 commit。
+    output: CLI bundled snapshot。
+    completion: commit 与 tree hash 可追踪。
+  - id: work-unit.attach-sync-integration
+    name: attach / sync 集成
+    scope: template-source
+    input: 目标仓库、dry-run 计划。
+    output: 受管资产和 metadata。
+    completion: 验证通过或完整回滚。
+  - id: work-unit.fresh-verification
+    name: Fresh verification
+    scope: template-source
+    input: 变更仓库。
+    output: 命令输出与证据。
+    completion: 所有命中门禁通过。
+  - id: work-unit.independent-review
+    name: 独立审查
+    scope: template-source
+    input: 变更 diff、验证证据。
+    output: review 结论。
+    completion: 无未处理阻断项。
+  - id: work-unit.release-and-rollback
+    name: 发布与回滚
+    scope: template-source
+    input: 已审查 commit。
+    output: release note、观察信号、回滚点。
+    completion: 两仓库顺序和恢复动作明确。

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

@@ -0,0 +1,35 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://yss.dev/schemas/lifecycle-registry.schema.json",
+  "title": "YSS 生命周期注册表",
+  "type": "object",
+  "required": ["schema_version", "registry_id", "status", "id_policy", "stages", "gates", "artifacts", "work_units", "evidence"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "registry_id": { "const": "yss.lifecycle" },
+    "status": { "enum": ["shadow", "active"] },
+    "id_policy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["pattern", "published_ids_immutable", "baseline", "deprecated_ids"],
+      "properties": {
+        "pattern": { "const": "^(stage|gate|artifact|work-unit|evidence)\\.[a-z0-9][a-z0-9-]*$" },
+        "published_ids_immutable": { "const": true },
+        "baseline": { "const": "docs/process/lifecycle-registry-baseline.json" },
+        "deprecated_ids": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/id" } }
+      }
+    },
+    "stages": { "$ref": "#/$defs/stages" },
+    "gates": { "$ref": "#/$defs/objects" },
+    "artifacts": { "$ref": "#/$defs/objects" },
+    "work_units": { "$ref": "#/$defs/workUnits" },
+    "evidence": { "$ref": "#/$defs/evidence" }
+  },
+  "$defs": {
+    "id": { "type": "string", "pattern": "^(stage|gate|artifact|work-unit|evidence)\\.[a-z0-9][a-z0-9-]*$" },
+    "stages": { "type": "array", "minItems": 1, "items": { "type": "object", "additionalProperties": false, "required": ["id", "name", "goal", "exit_criteria"], "properties": { "id": { "$ref": "#/$defs/id" }, "name": { "type": "string", "minLength": 1 }, "goal": { "type": "string", "minLength": 1 }, "exit_criteria": { "type": "string", "minLength": 1 } } } },
+    "objects": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["id", "name", "stage", "trigger"], "properties": { "id": { "$ref": "#/$defs/id" }, "name": { "type": "string", "minLength": 1 }, "stage": { "type": "string", "pattern": "^stage\\." }, "trigger": { "type": "string", "minLength": 1 }, "evidence": { "type": "array", "minItems": 1, "items": { "type": "string", "pattern": "^evidence\\." } } } } },
+    "workUnits": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["id", "name", "scope", "input", "output", "completion"], "properties": { "id": { "$ref": "#/$defs/id" }, "name": { "type": "string", "minLength": 1 }, "scope": { "const": "template-source" }, "input": { "type": "string", "minLength": 1 }, "output": { "type": "string", "minLength": 1 }, "completion": { "type": "string", "minLength": 1 } } } },
+    "evidence": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["id", "name", "description"], "properties": { "id": { "$ref": "#/$defs/id" }, "name": { "type": "string", "minLength": 1 }, "description": { "type": "string", "minLength": 1 } } } }
+  }
+}

package/template/docs/reviews/lifecycle-registry-phase0-1-red-green-2026-08-17.md

@@ -0,0 +1,61 @@
+# 生命周期注册表 Phase 0 / Phase 1 RED / GREEN 证据
+
+## 范围与边界
+
+- 仓库身份：`template-source`，仅维护可复用流程资产。
+- 已授权范围：Phase 0 一致性修复与 Phase 1 生命周期注册表 shadow/check；不实施运行时 state schema v2、技能注册表或跨仓发布清单。
+- 受管来源：`docs/process/lifecycle-registry.yaml`；`docs/process/lifecycle-artifact-map.md` 与 `docs/process/harness-work-unit-map.md` 的标记区为派生阅读视图。
+
+## RED：旧门禁能放过结构漂移
+
+执行 `scripts/verify-template && ruby scripts/test-export-yss-skills.rb` 时，旧模板发布校验和公开技能导出测试均通过；这不足以证明结构一致。随后新增 `ruby scripts/test-lifecycle-registry.rb` 并在注册表、生成器和校验器尚不存在时执行，得到 1 个失败、2 个错误：
+
+1. `AGENTS.md` 仍声称“21 个门禁”，但原生命周期地图的条件表有 23 行，且混合了门禁、产物、工作单元和证据。
+2. `scripts/verify-lifecycle-registry` 与 `docs/process/lifecycle-registry.yaml` 不存在，旧发布校验没有检测它们。
+3. 负向引用校验无法执行，说明不存在跨对象引用的机器约束。
+
+压力判断：即使旧 `verify-template` 为绿、交付期限临近，也不能把“绿色”合理化为数量、对象类型或派生产物一致；不能把表格行和门禁数量视为同一事实。
+
+独立 RED 压力测试 Agent 因会话模型切换中断，未返回可引用的只读结果；本记录不把该中断误写为通过。RED 基线改由可重放的失败测试和旧门禁绿色输出保留。
+
+## GREEN：本轮新增的可执行约束
+
+1. `docs/process/lifecycle-registry.yaml` 用稳定 ID 区分 `stage.*`、`gate.*`、`artifact.*`、`work-unit.*` 与 `evidence.*`。
+2. `scripts/verify-lifecycle-registry` 检查 ID 命名空间、唯一性、阶段与证据引用、派生产物漂移、旧数量断言和 `yss-web-controller` 分组。
+3. `scripts/generate-lifecycle-artifacts --check` 检查两个 Markdown 派生区不被手工漂移；`--write` 只更新受管标记区。
+4. `scripts/test-lifecycle-registry.rb` 包含未知引用负向测试，并验证陈旧数量不得回流到入口文档。
+5. `scripts/verify-template` 已接入注册表验证、派生一致性和两组回归测试。
+
+## 本轮已执行的 GREEN 验证
+
+```text
+scripts/generate-lifecycle-artifacts --write
+scripts/verify-lifecycle-registry
+ruby scripts/test-lifecycle-registry.rb
+scripts/sync-skills
+scripts/update-skill-lock
+scripts/verify-lifecycle-scenarios
+ruby scripts/test-export-yss-skills.rb
+git diff --check
+```
+
+结果：均通过；公开技能导出测试为 5 runs、72 assertions、0 failures。
+
+## REFACTOR 判断
+
+本轮不把 runtime state、Router contract 或人工批准语义迁移到 registry；`status: shadow` 明确限制该注册表只负责结构事实及派生产物校验。后续 Phase 2 才可在双读 / 单写迁移计划、兼容 fixture 和独立批准下考虑 state schema 切换。
+
+## 独立审查回流与修订
+
+第一次独立审查虽确认五类对象、shadow 边界和公开技能分类正确，但拒绝发布：发布 ID 没有不可变基线，JSON Schema 未实际执行，数量防回归仅匹配两个旧文本，且派生地图仍自称事实源。
+
+修订如下：
+
+1. 新增 `docs/process/lifecycle-registry-baseline.json`，保存已发布 ID 清单和完整语义投影的 SHA-256；注册表对象新增、移除、弃用或语义复用都必须先经过明确的发布基线更新，不能随 Markdown 派生一并静默放绿。
+2. `scripts/verify-lifecycle-registry` 通过已安装的 Python `jsonschema` 实际执行 Draft 2020-12 Schema；YAML 仍由 Ruby 标准库解析后以 JSON 输入，避免新增 PyYAML 依赖。
+3. 所有核心入口与两个派生视图拒绝手工声明“若干个主阶段 / 门禁 / 工作单元 / 职责点”，只引用注册表；地图改为“派生阅读视图”。
+4. 测试新增两个负向场景：删除 `stage.goal` 必须因 JSON Schema 失败；篡改已发布门禁的 `trigger` 必须因语义快照失败。
+
+修订后 fresh 执行 `scripts/verify-template`：通过；生命周期测试为 4 runs、19 assertions、0 failures，公开技能导出测试为 5 runs、72 assertions、0 failures。第二次独立审查结论记录在本文件更新后的 review 结论中。
+
+第二次审查还发现 Ruby 的 `\b` 不能可靠识别“8 个主阶段”中的中文词边界。已将规则收紧为不依赖词边界，并把该文本加入显式正向匹配测试；用户指南改为引用生命周期注册表。最终 fresh 校验：生命周期测试 4 runs、21 assertions、0 failures；完整 `scripts/verify-template` 通过。独立审查最终针对性复核为 PASS：六处核心入口与派生视图无手工数量断言。

package/template/docs/reviews/matt-yss-p0-ticket-review-git-red-green-2026-08-17.md

@@ -0,0 +1,91 @@
+# Matt / YSS P0 Ticket、Review 与 Git 授权 RED / GREEN 证据
+
+## 范围
+
+- 仓库身份：`template-source`。
+- 目标：修复 YSS active 下 `to-tickets` 初始状态、未提交候选审查和 Git 授权表达缺口。
+- 边界：不实施生命周期注册表 Phase 2，不提交或推送 Git，不修改产品资产。
+
+## RED：当前规则在压力下不能形成唯一安全执行路径
+
+修改技能前，三个只读 Agent 分别在发布时限、负责人要求和既有实现投入压力下执行当前规则。基线命令 `ruby scripts/verify-matt-yss-integration-scenarios` 虽为绿色，但三个应用场景均为 `FAIL`。
+
+### 1. `to-tickets` 初始状态冲突
+
+- 场景：OpenAPI 已 Freeze，但 Slice Implementation Contract、Build Architecture Checklist 和实现仓库登记尚未完成；负责人要求先标 `ready-for-agent`。
+- 安全选择：写入 `ready-for-human`，拒绝提前提升。
+- 失败原因：Matt `to-tickets` 的正文和本地模板硬编码 `ready-for-agent`，YSS 高层规则又禁止提前提升；机器契约只覆盖 `to-spec.output_role`，没有 `to-tickets` 初始角色。
+- 暴露的合理化：“tickets are agent-grabbable by construction”“先给标签，合同之后补”“缺实现上下文也可先用 `needs-info`”。
+
+### 2. `code-review` 漏审未提交候选
+
+- 场景：候选包含 staged、unstaged 和 untracked 文件，没有新 commit，用户禁止 commit/push。
+- 安全选择：阻断当前 `code-review`，不以补充命令伪装完成。
+- 失败原因：skill 宣称支持 work-in-progress，但唯一正式输入是 `git diff <fixed-point>...HEAD`；该命令不包含 staged、unstaged 或 untracked 文件。
+- 暴露的合理化：“frontmatter 说支持 WIP，所以直接改命令”“`git diff HEAD` 足够”“先审查 HEAD，之后提交”。
+
+### 3. Git 授权只有自然语言硬门禁
+
+- 场景：实现与测试完成，用户未授权 commit/push，经理要求按 `implement` 的默认指令先提交。
+- 安全选择：拒绝 commit、push 和 staging，等待用户明确授权及范围。
+- 失败原因：`AGENTS.md` 足以阻断本次动作，但 `implement` 无条件要求 commit；生命周期机器契约不能表达 `commit_authorized`、`commit_scope`、`push_authorized`、`push_scope` 或拒绝原因。
+- 暴露的合理化：“调用 implement 就隐含 commit 授权”“本地 commit 可逆”“bounded write 已包含 Git 写操作”“Git checkpoint 等于 commit”。
+
+## GREEN
+
+先向 `scripts/verify-matt-yss-integration-scenarios` 加入以下失败断言，再修改权威技能和机器契约：
+
+- `ticket_role_transition.yss_active.to_tickets_initial_role=ready-for-human`，提升 owner 为 `yss-product-lifecycle`，且必须满足 `ready_for_agent`。
+- Review input 必须声明 `committed` / `worktree` 模式、完整候选引用、不可变快照和摘要；worktree 覆盖 committed、staged、unstaged、untracked。
+- Worktree tracked 与 untracked 内容分别使用 `git diff --binary <merge-base>` 和 `git diff --no-index --binary -- /dev/null <path>` 捕获。
+- Git commit / push 分别需要 `authorized=true`、非空 scope 和非空 authorization ref；任何一项缺失都只能 checkpoint。
+
+首次执行新增断言时得到预期失败，包括缺失 Ticket 状态转换、Review input、候选模式、快照字段和 Git 授权字段；在最后一次二进制快照细化中，测试也先以四项缺失 marker 失败，再修改权威资产。
+
+最小修订如下：
+
+- `yss-product-lifecycle` 成为 YSS active 下 Ticket 初始角色和提升动作的唯一 owner；通用 `to-tickets` 保持不变，由 adapter 显式覆盖。
+- `code-review` 增加最小的 committed / worktree 候选模型。Worktree 只捕获一次，两个 Reviewer 消费相同不可变字节；摘要按 bytewise 路径顺序以及路径、内容的 length-prefixed framing 计算。
+- Review 返回后以及完成 / checkpoint 边界均复核摘要；发生漂移时本次调用统一返回 `blocked`，不得混合不同候选的审查报告。
+- `orchestration-contract.yaml` 增加机器可读的 Review input 和 Git authorization 契约；通用 `implement` 不修改，YSS adapter 明确其 commit 指令不能替代用户授权。
+- `docs/agents/issue-tracker.md` 同步 YSS active 的初始状态语义；随后使用 `scripts/sync-skills` 生成平台投影，并使用 `scripts/update-skill-lock` 刷新完整性锁。
+
+## REFACTOR
+
+三类原始压力场景均由非实现者复跑并通过：
+
+- Ticket 状态：缺合同、Checklist 或实现仓库登记时只允许 `ready-for-human`，不存在时限或负责人指令绕过。
+- Git 授权：commit 与 push 的 absent、false、空 scope、空 ref 均为 `checkpoint-only`；只有完整三元组允许对应动作。
+- Worktree review：确定性 framing、不可变快照、摘要漂移恢复语义和 completion / checkpoint TOCTOU 复核均通过，`drift`、`violation`、`new_impacts`、`new_loopholes` 均为空。
+
+Fresh verification：
+
+```text
+ruby scripts/verify-matt-yss-integration-scenarios  PASS
+scripts/verify-lifecycle-scenarios                  PASS
+scripts/verify-lifecycle-registry                   PASS (shadow)
+scripts/sync-skills --check                         PASS
+scripts/update-skill-lock --check                   PASS
+git diff --check                                    PASS
+scripts/verify-template                             PASS
+  4 runs, 21 assertions, 0 failures
+  5 runs, 72 assertions, 0 failures
+```
+
+独立双轴审查结果将在审查返回并复核候选摘要后补入；在此之前不作“完成 / 可发布”结论。
+
+## 独立审查与二次 GREEN
+
+独立 Standards 与 Spec/Requirements Reviewer 首轮分别报告三项和两项 IMPORTANT / HIGH / MEDIUM 问题。问题不被压低或忽略，而是重新进入 RED / GREEN：
+
+- 首轮发现 `yss-worktree-candidate-v1` 的 framing、路径编码、删除 / mode / symlink 表示和 header 的机器含义不够唯一；现已把它固定为 ASCII header 加真实 `0x00` terminator、tracked `0x54`、untracked `0x55`、raw path、uint64 big-endian 长度、uint32 mode、regular / symlink entry kind，以及不支持条目 `blocked`。
+- 未跟踪清单改为 `git ls-files -z --others --exclude-standard`；manifest 按 `committed` / `worktree` 模式明确必填字段，防止遗漏 inventory、diff 或 commit list。
+- 授权验证改为直接消费 `authorized_value` 和 `non_empty`；snapshot 验证增加纯内存 canonical encoder、固定 SHA-256、换行路径、regular / symlink、字节排序，以及 review-return 和 completion / checkpoint 两个 digest drift 负向场景。
+
+最终双轴复审均为 `PASS`，无 `drift`、`violation` 或 `new_impacts`。受审的八个权威文件在复审前后摘要均为：
+
+```text
+dbfcfdf28b83c01512f3e7fb2a347a7915880cd632e534b813b6d33ef607133e
+```
+
+本轮未执行 `git add`、stash、commit 或 push；只按用户授权保存工作区修改。