create-yss-spec 2.1.11 → 2.1.14

package/template/wiki/.wiki-manifest.json

@@ -0,0 +1,390 @@
+{
+  "schemaVersion": 1,
+  "wikiRoot": "wiki",
+  "compiledAt": "2026-08-24T03:05:31.972Z",
+  "gitCommit": "de5a8f193f84d44c0b8c9b8dc5da501e60846e66",
+  "profile": "documents",
+  "sources": [
+    {
+      "id": "AGENTS.md",
+      "kind": "document",
+      "livePath": "AGENTS.md",
+      "rawPath": "raw/AGENTS.md",
+      "role": "copy",
+      "sha256": "7cfed91a8e530606f1140acf5156acae1b4c7b16ae13c3d960b8905a61fabd0d"
+    },
+    {
+      "id": "CONTEXT.md",
+      "kind": "document",
+      "livePath": "CONTEXT.md",
+      "rawPath": "raw/CONTEXT.md",
+      "role": "copy",
+      "sha256": "83c31282a9fcfa5ca22e391045fb482cba87d1fb8ae1f31bd93a6224add462d4"
+    },
+    {
+      "id": "README.md",
+      "kind": "document",
+      "livePath": "README.md",
+      "rawPath": "raw/README.md",
+      "role": "copy",
+      "sha256": "2a8e25ac4dc7798e2b7d1609644990518ece925aecff375160036eb8be611446"
+    },
+    {
+      "id": "yss-project.yaml",
+      "kind": "document",
+      "livePath": "yss-project.yaml",
+      "rawPath": "raw/yss-project.yaml",
+      "role": "copy",
+      "sha256": "dae2ddacbb024ba25b70a18830fc26ab7d3dcd8aaa361cc8b3767d68307f98af"
+    },
+    {
+      "id": "lifecycle-registry.yaml",
+      "kind": "document",
+      "livePath": "docs/process/lifecycle-registry.yaml",
+      "rawPath": "raw/lifecycle-registry.yaml",
+      "role": "copy",
+      "sha256": "051a51ea7e5ef3c6fecb5cb43137c5cdd157c646f468614022134e51a5bc5b06"
+    },
+    {
+      "id": "harness-process-tailoring.md",
+      "kind": "document",
+      "livePath": "docs/process/harness-process-tailoring.md",
+      "rawPath": "raw/harness-process-tailoring.md",
+      "role": "copy",
+      "sha256": "f11bb61f3034560c1607891654b0fb0b79dc82f8fb520f746585e5decf9bf41f"
+    },
+    {
+      "id": "maintenance-intensity.yaml",
+      "kind": "document",
+      "livePath": "docs/process/maintenance-intensity.yaml",
+      "rawPath": "raw/maintenance-intensity.yaml",
+      "role": "copy",
+      "sha256": "6338e218860416a2a2ca9c187b5589bc1140b967dbac5f3ecea906adfb588a0f"
+    },
+    {
+      "id": "implementation-repo-integration.md",
+      "kind": "document",
+      "livePath": "docs/process/implementation-repo-integration.md",
+      "rawPath": "raw/implementation-repo-integration.md",
+      "role": "copy",
+      "sha256": "7cd8106029c53773f9ee3e83bcd2d48d6575dbf83d511b0f7d93eeb56538e4e8"
+    },
+    {
+      "id": "skills-maintenance.md",
+      "kind": "document",
+      "livePath": "docs/agents/skills-maintenance.md",
+      "rawPath": "raw/skills-maintenance.md",
+      "role": "copy",
+      "sha256": "9c95176cc104224b515da9b3ad189d4fc6ea917f31877e60083f1416f342f378"
+    },
+    {
+      "id": "yss-skill-registry.yaml",
+      "kind": "document",
+      "livePath": "docs/agents/yss-skill-registry.yaml",
+      "rawPath": "raw/yss-skill-registry.yaml",
+      "role": "copy",
+      "sha256": "b265d25be9bc80166e289ca1702337457ac839aec50290d1ba078c7a100cd474"
+    },
+    {
+      "id": "issue-tracker.md",
+      "kind": "document",
+      "livePath": "docs/agents/issue-tracker.md",
+      "rawPath": "raw/issue-tracker.md",
+      "role": "copy",
+      "sha256": "260db9b67b39f8cba50fc1de7a7ae12abb9d246f3a4b85c0122a71f9fcf431f9"
+    },
+    {
+      "id": "triage-labels.md",
+      "kind": "document",
+      "livePath": "docs/agents/triage-labels.md",
+      "rawPath": "raw/triage-labels.md",
+      "role": "copy",
+      "sha256": "5877760bdbb9151a93736247c2dec77d67e969dd1a1b771acf5ff6dc590e5261"
+    },
+    {
+      "id": "adr-0002",
+      "kind": "document",
+      "livePath": "docs/adr/0002-yss-project-repository-mode.md",
+      "rawPath": "raw/adr-0002-repository-mode.md",
+      "role": "copy",
+      "sha256": "11d2a2b384491b4409e5a2c9b18f30d0566b6c80e1e270ef3c224d72fd264583"
+    },
+    {
+      "id": "create-yss-spec-repository-mode-contract",
+      "kind": "document",
+      "livePath": ".template-source/contracts/create-yss-spec-repository-mode-contract.md",
+      "rawPath": "raw/create-yss-spec-repository-mode-contract.md",
+      "role": "copy",
+      "sha256": "11abf661e07ae297995f4bc5fbbadff6df33ee66a8990df5ce5ea21e530c615a"
+    },
+    {
+      "id": "spec-template.md",
+      "kind": "document",
+      "livePath": "docs/templates/spec-template.md",
+      "rawPath": "raw/spec-template.md",
+      "role": "copy",
+      "sha256": "10d12f0d4c7c148afd74876d057afebdf0a97b65a21cdf2b67ca14a3ce804115"
+    },
+    {
+      "id": "vertical-slice-ticket-template.md",
+      "kind": "document",
+      "livePath": "docs/templates/vertical-slice-ticket-template.md",
+      "rawPath": "raw/vertical-slice-ticket-template.md",
+      "role": "copy",
+      "sha256": "49bec2cb6df81ab6d76d01920b52197274b39b6381c329baff360e34e64cc341"
+    },
+    {
+      "id": "skills-lock.json",
+      "kind": "derived",
+      "livePath": "skills-lock.json",
+      "rawPath": "raw/skills-lock-names.md",
+      "role": "extract",
+      "extract": {
+        "kind": "skill-names"
+      },
+      "sha256": "8b6df90beb87c526bc2e0a71de61a2ffd1f76b96cb47e6fe87172ebd849bb45b"
+    }
+  ],
+  "articles": [
+    {
+      "id": "模板总览",
+      "file": "wiki/模板总览.md",
+      "sourceIds": [
+        "README.md",
+        "AGENTS.md",
+        "CONTEXT.md",
+        "yss-project.yaml"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "仓库身份与路由",
+      "file": "wiki/仓库身份与路由.md",
+      "sourceIds": [
+        "yss-project.yaml",
+        "adr-0002",
+        "AGENTS.md",
+        "create-yss-spec-repository-mode-contract"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "Agent入口规则",
+      "file": "wiki/Agent入口规则.md",
+      "sourceIds": [
+        "AGENTS.md",
+        "CONTEXT.md"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "产品研发生命周期",
+      "file": "wiki/产品研发生命周期.md",
+      "sourceIds": [
+        "lifecycle-registry.yaml",
+        "AGENTS.md",
+        "harness-process-tailoring.md"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "条件强制门禁",
+      "file": "wiki/条件强制门禁.md",
+      "sourceIds": [
+        "lifecycle-registry.yaml",
+        "harness-process-tailoring.md",
+        "AGENTS.md"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "影响面分诊与流程裁剪",
+      "file": "wiki/影响面分诊与流程裁剪.md",
+      "sourceIds": [
+        "harness-process-tailoring.md",
+        "lifecycle-registry.yaml",
+        "AGENTS.md"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "模板维护流程",
+      "file": "wiki/模板维护流程.md",
+      "sourceIds": [
+        "harness-process-tailoring.md",
+        "maintenance-intensity.yaml",
+        "AGENTS.md"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "Spec基线",
+      "file": "wiki/Spec基线.md",
+      "sourceIds": [
+        "spec-template.md",
+        "CONTEXT.md",
+        "AGENTS.md",
+        "lifecycle-registry.yaml"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "SpecDelta",
+      "file": "wiki/SpecDelta.md",
+      "sourceIds": [
+        "CONTEXT.md",
+        "AGENTS.md",
+        "lifecycle-registry.yaml"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "OpenAPI契约",
+      "file": "wiki/OpenAPI契约.md",
+      "sourceIds": [
+        "AGENTS.md",
+        "CONTEXT.md",
+        "lifecycle-registry.yaml"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "产品设计影响与原型",
+      "file": "wiki/产品设计影响与原型.md",
+      "sourceIds": [
+        "CONTEXT.md",
+        "AGENTS.md",
+        "lifecycle-registry.yaml"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "垂直切片Ticket",
+      "file": "wiki/垂直切片Ticket.md",
+      "sourceIds": [
+        "vertical-slice-ticket-template.md",
+        "CONTEXT.md",
+        "AGENTS.md",
+        "issue-tracker.md",
+        "triage-labels.md",
+        "lifecycle-registry.yaml"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "切片实现合同",
+      "file": "wiki/切片实现合同.md",
+      "sourceIds": [
+        "CONTEXT.md",
+        "AGENTS.md",
+        "lifecycle-registry.yaml"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "YSS路由与合同编译",
+      "file": "wiki/YSS路由与合同编译.md",
+      "sourceIds": [
+        "AGENTS.md",
+        "CONTEXT.md"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "YSS工程技能体系",
+      "file": "wiki/YSS工程技能体系.md",
+      "sourceIds": [
+        "CONTEXT.md",
+        "skills-maintenance.md",
+        "yss-skill-registry.yaml",
+        "skills-lock.json"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "Matt技能体系",
+      "file": "wiki/Matt技能体系.md",
+      "sourceIds": [
+        "CONTEXT.md",
+        "skills-maintenance.md",
+        "AGENTS.md",
+        "skills-lock.json"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "技能投影与锁定",
+      "file": "wiki/技能投影与锁定.md",
+      "sourceIds": [
+        "skills-maintenance.md",
+        "skills-lock.json",
+        "AGENTS.md",
+        "yss-skill-registry.yaml"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "实现仓库与跨仓库契约",
+      "file": "wiki/实现仓库与跨仓库契约.md",
+      "sourceIds": [
+        "implementation-repo-integration.md",
+        "AGENTS.md"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "LLM Wiki",
+      "file": "wiki/LLM Wiki.md",
+      "sourceIds": [
+        "AGENTS.md",
+        "CONTEXT.md",
+        "yss-skill-registry.yaml",
+        "skills-maintenance.md"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "Ticket与流程状态",
+      "file": "wiki/Ticket与流程状态.md",
+      "sourceIds": [
+        "issue-tracker.md",
+        "triage-labels.md",
+        "CONTEXT.md",
+        "AGENTS.md"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "Fresh验证与独立审查",
+      "file": "wiki/Fresh验证与独立审查.md",
+      "sourceIds": [
+        "AGENTS.md",
+        "harness-process-tailoring.md",
+        "maintenance-intensity.yaml",
+        "CONTEXT.md"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "模板发布门禁与验证",
+      "file": "wiki/模板发布门禁与验证.md",
+      "sourceIds": [
+        "AGENTS.md",
+        "README.md",
+        "skills-maintenance.md",
+        "harness-process-tailoring.md"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "复盘与权威资产修订",
+      "file": "wiki/复盘与权威资产修订.md",
+      "sourceIds": [
+        "AGENTS.md",
+        "lifecycle-registry.yaml",
+        "CONTEXT.md"
+      ],
+      "humanOwned": false
+    }
+  ]
+}

package/template/wiki/raw/AGENTS.md

@@ -18,82 +18,59 @@
 | ----------------------- | ------------------------------------------- |
 | 领域与流程词汇                 | `CONTEXT.md`                                |
 | Agent 入口、硬门禁、禁止事项       | `AGENTS.md`                                 |
-| 主阶段、门禁、产物和退出标准          | `docs/process/lifecycle-artifact-map.md`    |
+| 主阶段、门禁、产物、工作单元、证据和稳定 ID | `docs/process/lifecycle-registry.yaml`；`docs/process/lifecycle-artifact-map.md` 为派生阅读视图 |
 | 影响面触发与 `not-applicable` | `docs/process/harness-process-tailoring.md` |
+| 模板维护强度触发与最低等级 | `docs/process/maintenance-intensity.yaml` |
 | 技能清单、来源、版本、哈希和投影目标      | `skills-lock.json`                          |
-|                         |                                             |
+| 技能分层、别名、默认可发现性和运行时入口 | `docs/agents/yss-skill-registry.yaml`（当前 `status: shadow`，不作为 Router / 生命周期运行时入口） |
 
-README、用户指南和其他说明文档只引用或解释上述事实，不重复定义同一规则。
+README、用户指南、根目录 `CLAUDE.md` 和其他说明文档只引用或解释上述事实，不重复定义同一规则。`CLAUDE.md` 是 Claude Code 入口指针，不是第二套 Agent 规则。
 
 ## 3. 标准文档语言与规范语汇
 
 - 所有面向业务、产品、架构、实施、审查、发布和复盘的落地文档，正文统一使用简体中文。
 - 英文专有名词、代码标识、API 路径、schema、类名、方法名、枚举值、错误码、命令、文件名和协议 metadata 保持原样。
 - 新流程统一使用 Spec、Ticket、`to-spec`、`to-tickets`。过时术语和技能名只能出现在迁移指南或明确标注的旧项目上下文。
-- 实施前读取 `CONTEXT.md`；与词汇或 ADR 冲突时立即指出并先解决冲突。
+- 实施前读取 `CONTEXT.md`。业务术语必须已有 PascalCase `英文标识`；代码类型 / 字段与契约 property 使用该词干按 `CONTEXT.md` 文首规则变形。改中文术语或英文标识都先回写 `CONTEXT.md`。与词汇或 ADR 冲突时立即指出并先解决冲突。
 
-## 4. `template-source` 模板维护流程
+## 4. `template-source` 模板维护路由
 
-```text
-影响面分析
-→ 修改对应单一事实来源
-→ 同步技能投影和派生文档
-→ 执行压力场景与 scripts/verify-template
-→ 独立审查和 Git checkpoint
-```
+按“影响面 → 单一事实来源 → 投影 / 派生资产 → 分级证据”维护。强度分级、最低证据和 checkpoint 合同见 `docs/process/harness-process-tailoring.md`。
 
-硬门禁：
-
-- 修改 skill、`AGENTS.md`、流程规则或模板时，必须使用 `writing-skills` 的 RED / GREEN / REFACTOR 思路，保留基线失败、压力场景和修订后验证证据。
-- `.agents/skills` 是跨 Agent 共享技能的权威内容；`.claude/skills`、`.codex/skills`、`.hermes/skills`、`.pi/skills`、`.qoder/skills`、`.trae/skills` 中的共享技能是生成投影，禁止分别手工修改。
+- 创建、修改或退役 skill 时使用 `maintaining-skills`，并先按 `docs/process/harness-process-tailoring.md` 判定 L1 / L2 / L3；只有 L3 必须保留完整基线失败、压力场景、修订后验证和正式独立审查证据。
+- `.agents/skills` 是跨 Agent 共享技能的权威内容；`.claude/skills`、`.codex/skills`、`.cursor/skills`、`.hermes/skills`、`.pi/skills`、`.qoder/skills`、`.trae/skills` 中的共享技能是生成投影，禁止分别手工修改。Cursor 的契约运行时入口是 `.cursor/skills`；不得把 canonical `.agents/skills` 与某个平台投影当作同权双入口。
 - `scripts/verify-template` 是模板发布阻断门禁。模板与外部 `create-yss-spec` 的跨仓库契约未完成集成验证时，不得声称可发布。
 
 ## 5. `project-instance` 产品研发路由
 
-任务开始时先根据 `docs/process/harness-process-tailoring.md` 判断小改动、中等变更或新模块 / 高风险变更，定位最近可信阶段。日常骨架为：
-
-```text
-入口分诊
-→ 机会与 Discovery
-→ 业务 / Spec / 功能架构
-→ 产品设计与需求冻结
-→ 系统 / 数据架构与工程契约设计审查
-→ 契约冻结与 Ticket 正式化
-→ 垂直切片与 TDD 实现
-→ 验证发布与复盘
-```
+先用 `docs/process/harness-process-tailoring.md` 判定变更类型、影响面和最近可信阶段，再按 `docs/process/lifecycle-registry.yaml` 执行命中的工作单元和条件门禁。
 
-执行原则：
-
-- 21 个门禁全部是条件强制门禁。命中触发条件时必须完成；未命中时只记录 `not-applicable` 及原因，不生成空文档。
-- 新功能或较大变更先用 `grill-with-docs` 澄清，再用 `to-spec` 形成 Spec。
-- 只要进入 Spec 基线，必须产出产品总体设计或功能架构；只有 UI 变化触及主流程、导航、权限体验、异常 / 恢复状态、状态流转或 API 反推时，才构成产品设计影响并强制低保真页面草图、状态矩阵、Ant Design v6 高保真 HTML 原型和用户确认。文案、token、颜色、间距和无行为变化的孤立视觉修复记录 `not-applicable`。
+- 生命周期注册表中的条件门禁全部按影响面强制。命中触发条件时必须完成；未命中时只记录 `not-applicable` 及原因，不生成空文档；不得把产物、工作单元或证据统称为门禁。
+- 安全 / 权限不设独立生命周期资料或专属门禁。日常功能不做额外登记、`not-applicable` 或推导校验；只有需求或冻结资产明确要求改变认证、授权、租户隔离、敏感数据或合规行为时，才把该行为写入普通 Spec、API、架构、验收和测试 seam，并仅按实际 UI、API、Backend、Data、High-risk 影响触发既有门禁。普通 action 注册、沿用既有认证中间件、未变化的 `401` / `403`、一般字段、SQL / DDL / 迁移和上传 / 下载本身不构成安全 / 权限专项。
+- `seam-deferred` 只能显式记录风险、责任人、后续 Ticket、验证计划和目标版本或发布日期。
+- 新功能或较大变更先进入 `yss-product-lifecycle` 的原生 Discovery / 需求分析工作单元；`grill-with-docs` 与 `to-spec` 仅作为用户显式兼容入口，Spec 基线和产品设计影响的完整判定以注册表和裁剪规则为准。
 - API 契约变更先形成 OpenAPI 3.1 Draft，经必要的工程基线、系统 / 数据架构和设计审查后 Freeze，再进入实现。
 - Spec Delta 只记录相对既有冻结 Spec 基线的高风险行为差异；全新产品、全新模块和低风险调整不生成 Spec Delta。
-- OpenAPI Freeze 或无 API 影响记录完成后，使用 `to-tickets` 拆成可独立验证的窄垂直切片，禁止只按 Adapter / Application / Domain / Infrastructure 横向拆分。
+- OpenAPI Freeze 或无 API 影响记录完成后，由生命周期原生 Ticket 正式化工作单元拆成可独立验证的窄垂直切片；用户显式 `to-tickets` 仅作为兼容入口，禁止只按 Adapter / Application / Domain / Infrastructure 横向拆分。
 
 ## 6. Ticket 与状态
 
 - 每个功能先建立功能父 Ticket，用于汇总 Spec、设计、审查、OpenAPI Freeze、阻塞项和阶段证据。
 - Spec 初稿、产品设计、原型、OpenAPI Draft 和待冻结资产使用 `ready-for-human`。
 - 只有通过必要门禁、阻塞边已清除并具备直接实现条件的垂直切片 Ticket，才能使用 `ready-for-agent`。
-- Ticket、Spec 和阶段证据必须按用户选择或当前主远程路由到 GitHub / GitLab；平台不可用时生成本地待发布草案，不自动改投其他平台。
-
-平台规则和五态标签见 `docs/agents/issue-tracker.md` 与 `docs/agents/triage-labels.md`。
+- Ticket、Spec 和阶段证据按 `docs/agents/issue-tracker.md` 选定的主 tracker 持久化；Git remote 不代表 tracker 选择，平台不可用时按该文档生成待发布草案。五态标签见 `docs/agents/triage-labels.md`。
 
 ## 7. 实现与 YSS 路由硬门禁
 
-进入实现前：
+进入实现时先读 `docs/process/implementation-repo-integration.md`，登记实现仓库、项目根、分支、CI、验证命令和回滚点；再使用 `yss-router` 编译最小 skill 集合与当前实现合同。
 
-1. 确认受影响的 frontend / backend 工程是 `existing`、`required` 还是 `initialized`，并登记实现仓库、分支、CI、验证命令和回滚点。
-2. 无可复用工程时，先确认外部目标仓库或输出目录，再分别使用 `yss-ddd-scaffold-generator` / `yss-frontend-scaffold-generator`；不因当前仓库缺少 frontend / backend 目录而绕过脚手架路由。
-3. 使用 `yss-router` 选择最小 YSS skill 集合。后端领域、Application、Repository / Gateway、Web / DTO 分别路由到对应 YSS skill；涉及 POJO 样板或对象转换时必须加载 `lombok`、`mapstruct` 和 `alibaba-java-code-style`。
-4. 所有正式垂直切片必须先由 `yss-router` 编译 Slice Implementation Contract 草案，再由生命周期编排器核验并持久化；合同至少包含 Common、Frontend、Backend、Contract、Cross-repo 子合同、工作单元、TDD 模式、允许写路径、禁止模式、证据和验证命令。Router 不得自行批准合同或设置 `ready-for-agent`。
-5. 后端切片必须在统一合同中补齐 Backend Slice Implementation Contract，至少包含 `required_skills`、`allowed_write_paths`、`forbidden_patterns`、`expected_evidence_files`、`seam_deferred`、`verification_commands`。
-6. 把系统 / 数据架构、ADR、工程基线、OpenAPI Freeze 和风险 / 回滚约束转译为 Build Architecture Checklist。
-7. 核心 YSS skills 必须消费批准合同并返回 YSS Skill Execution Result；路径越界、证据缺失、未执行验证、`drift`、`violation` 或 `new_impacts` 阻断继续实现或触发重路由。
+- 无可复用工程时，先确认外部目标仓库或输出目录，再使用 `yss-ddd-scaffold-generator` / `yss-frontend-scaffold-generator`；当前仓库缺少 frontend / backend 目录不改变此路由。
+- 脚手架只在 `scaffold_status=required` 且受控生成合同已持久化、获得生命周期批准后运行；它只产生机械骨架，业务行为回到 Router 并使用 `behavior-tdd`。
+- 正式垂直切片必须消费已批准、已持久化且版本当前的 Slice Implementation Contract。Router 只生成草案，不批准合同、不设置 `ready-for-agent`、不宣布完成。合同 schema、Backend 子合同和证据字段以 `yss-router` references 为准。
+- 前端测试、type-check 与构建优先使用 `pnpm`；后端校验、测试与编译优先使用项目根 `./mvnw`。不要默认 `npm` / `yarn` 或裸 `mvn`。既有仓库确实没有 pnpm 或 Maven Wrapper 时，必须记录受控例外和实际命令。登记字段见 `docs/process/implementation-repo-integration.md`。
+- 路径越界、证据缺失、未执行验证、`drift`、`violation` 或 `new_impacts` 时停止实现并重新路由。
 
-禁止绕过上述合同、检查清单或专项 skill，直接在 `AGENTS.md` 中自行发明细则。详细实现约束以 YSS skills、`docs/process/implementation-repo-integration.md` 和对应模板为准。
+实现细则由已批准合同、YSS skills 和实现接入文档定义；`AGENTS.md` 只保留入口与边界。
 
 ## 8. 专项任务的强制入口
 
@@ -101,41 +78,45 @@ README、用户指南和其他说明文档只引用或解释上述事实，不
 |---|---|
 | 技术事实、标准、第三方 API 或框架行为影响决策 | `research` 或等价的一手资料记录 |
 | 竞品、市场或用户口碑事实 | `competitive-intelligence` |
-| UI 设计、原型、组件或主题 | `yss-design-system` 后路由 `product-design:index`；产出前用 `antd` 查询 Ant Design v6 事实 |
+| UI 设计、原型、组件或主题 | `yss-design-system` 后使用 `yss-prototype-stage`；Codex 再路由 `product-design:index`，其他 Agent 交付等价合同资产；原型产出前后用 `yss-antd-design` 记录 Ant Design v6 事实与浏览器验证。前端代码落地改用 `yss-ui`，不要继续调用 `yss-antd-design` |
 | Bug、测试失败或性能回退 | `diagnosing-bugs` 建立可复现反馈，再用 `tdd` |
 | merge / rebase 冲突 | `resolving-merge-conflicts` |
 | 架构治理、难测模块或深模块设计 | `improve-codebase-architecture` / `codebase-design` |
 | 跨线程、跨仓库、上下文过长或原型结论回流 | `handoff` 或等价交接记录 |
+| 本地知识库 init / refresh / rebuild，或要把研究结果落成持久 wiki | `llm-wiki`（落成持久 wiki 用 `ingest`；已映射 live 源变了用 `refresh`） |
 
 业务行为默认按 `tdd` 使用已确认的公开 seam 逐切片实现。一次性生成、纯配置或流程文档不适用代码 TDD 时，必须记录例外理由和可执行验证方式。
 
 ## 9. 工作区与实现仓库边界
 
-当前仓库默认是研发管理仓库，前端、后端和其他运行时代码优先位于独立实现仓库。只有用户明确选择当前仓库承载实现代码时，才可按需创建：
+当前仓库默认是研发管理仓库，运行时代码优先位于已登记的独立实现仓库。只有用户明确选择当前仓库承载实现代码时，才使用唯一的 `apps/backend/<project>/` 或 `apps/frontend/<project>/` 项目根。
 
-```text
-apps/backend/
-apps/frontend/
-```
-
-不得自行新建其他顶层业务代码目录。
+`apps/backend/` 和 `apps/frontend/` 只是项目容器；`app/backend/`、`app/frontend/` 及其子路径禁止作为工程输出。完整登记字段和跨仓约束见 `docs/process/implementation-repo-integration.md`。
 
 ## 10. 独立审查、验证和追踪
 
-- 实现者不能审查自己的代码。模板发布、代码切片和高风险变更必须由其他 Agent 或人工独立审查；低风险文档变更可使用显式人工 checkpoint。
+- 实现者不能承担命中的独立审查。模板维护按 L1 / L2 / L3 分别使用 self-check / 人工 checkpoint、聚焦独立审查、正式独立审查；模板发布、代码切片和高风险变更仍必须由其他 Agent 或人工独立审查。
 - 任何“完成 / 可合并 / 可发布”结论必须基于 fresh verification，不接受“之前跑过”或实现者自述。
-- 连续自动推进期间累积各阶段和垂直切片的 Ticket 证据，在人工暂停、handoff、进入实现、合并或发布边界集中同步范围、验证证据、风险、人工审查点和下一步；阻塞、责任人变化或资产单独批准时立即同步。
-- Git checkpoint 与上述边界对齐，列出本轮覆盖阶段、变更产物和 Ticket 同步状态，排除无关脏文件；只有用户已授权时才按明确范围提交或推送。集中记录不得丢失各阶段因果关系。
+- 在人工暂停、handoff、进入实现、合并或发布边界集中同步范围、验证证据、风险、人工审查点、Ticket 状态和下一步；阻塞、责任人变化或资产单独批准时立即同步。
+- Git checkpoint 只包含本轮明确范围；获得用户授权后才提交或推送。
 - 发布后或阶段性完成后做复盘判断；出现架构返工、验证返工、IMPORTANT / CRITICAL review finding 或人工确认延期时，落简体中文复盘并修订权威资产。
 
 ## 11. Subagent 协同
 
-使用 subagent 前必须定义任务包：输入资产、输出产物、可写范围、禁止事项、验收标准和汇合方式。写入范围不得重叠，实现者不得同时担任审查者。
+使用 subagent 前按 `docs/process/subagent-collaboration.md` 定义任务包和不重叠的写入范围。实现者不担任独立审查者；仓库身份、需求 / 契约冻结、Ticket 最终状态、Git checkpoint 和完成结论仍由主控 Agent 或人工决定。
+
+## 12. 测试质量基线
 
-subagent 可收集证据、产出草案、实现局部切片和执行独立审查 / 验证，但不得替代主控 Agent 作出仓库身份判定、Spec baseline、需求冻结、OpenAPI Freeze、架构放行、Ticket 最终状态、Git checkpoint 范围或“完成 / 可合并 / 可发布”结论。
+模板推荐值为 Domain / Application `>= 90%`、API `>= 80%`、前端组件 `>= 75%`、已明确的关键流程 `100% E2E`。只有项目实例在测试策略中明确采纳或覆盖后才构成 CI 门禁；未定义关键流程清单时，不声称其 E2E 覆盖率达到 100%。
 
-详细规则见 `docs/process/subagent-collaboration.md`。
+## Cursor Cloud specific instructions
 
-## 12. 测试质量基线
+本仓库是 `template-source` Harness / 研发管理仓库，没有前端 / 后端运行时应用；可运行、可测试的表面只有 Node 工具链与治理校验脚本。
 
-模板推荐值为 Domain / Application `>= 90%`、API `>= 80%`、前端组件 `>= 75%`、已明确的关键流程 `100% E2E`。这些数字只是模板推荐；项目实例必须在测试策略中明确采纳或覆盖后，才构成 CI 门禁。未定义关键流程清单时，不得声称其 E2E 覆盖率达到 100%。
+- 依赖与工具链：Node `>=22 <27`（`.nvmrc` 固定 22）；`pnpm` 通过 `packageManager` 字段由 corepack 自动切换到 `10.15.0`，无需手工切换。Node 依赖只装在 `.template-source/tooling/node`，仓库根没有 `package.json`。
+- 测试：`pnpm --dir .template-source/tooling/node test`（`node --test`，共 15 个用例）。
+- 构建 / lint：`pnpm --dir .template-source/tooling/node build:vendor` 与 `check:vendor` 维护 `scripts/vendor/*.mjs`；顶层 lint 是 `verify-template` 内对所有脚本执行的 `node --check`。
+- 完整发布门禁（相当于"运行应用"）：`scripts/verify-template`，成功输出 `模板发布校验通过`。它串联证据索引、`pnpm test`、`check:vendor` 和全部 `scripts/verify-*` 场景校验。
+- 非显然的坑：`scripts/verify-lifecycle-registry`（及其对应测试 `Node lifecycle registry verifier ...`）会 shell out 到 `python3` 并 `import jsonschema` 做 JSON Schema 校验。缺少该 Python 模块时测试会以 `ModuleNotFoundError: No module named 'jsonschema'` 失败，而不是代码问题；update script 已负责 `pip3 install jsonschema`。
+- `pnpm install` 输出的 `Ignored build scripts: esbuild` 警告可忽略：esbuild 0.28.2 在本平台自带二进制，`build:vendor` / `check:vendor` 无需 `pnpm approve-builds`。
+- 常用只读入口：`scripts/repository-mode`（返回仓库身份）、`scripts/generate-lifecycle-artifacts`（从 `docs/process/lifecycle-registry.yaml` 派生产物，输出应无 diff）、`scripts/export-yss-skills --output <dir>`（导出公开技能）。