architext 0.0.5 → 0.0.6

package/dist/templates/zh/docs/global/error_memory.json

@@ -0,0 +1,40 @@
+{
+  "errorPatterns": {
+    "_comment": "错误模式：{ id: 唯一标识, watchFor: [执行前需警惕的场景], matchWhen: [报错后匹配的关键词], cause: 根本原因, solution: 解决方案, lesson: 教训/原则 }。AI解决错误后在此追加",
+    "examples": [
+      {
+        "id": "build-vite-config-missing",
+        "watchFor": ["运行 npm run build", "修改 vite.config.ts"],
+        "matchWhen": ["ENOENT", "vite.config", "Cannot find module"],
+        "cause": "配置文件被误删或 node_modules 未安装",
+        "solution": "检查文件是否存在，运行 npm install 重装依赖",
+        "lesson": "修改配置前备份，定期确认 node_modules 完整"
+      },
+      {
+        "id": "type-import-assertion-deprecated",
+        "watchFor": ["导入 JSON 文件"],
+        "matchWhen": ["assert", "SyntaxError", "import", "type"],
+        "cause": "Node.js 18+ 废弃了 import assert 语法，改用 import attributes",
+        "solution": "assert { type: 'json' } 改为 with { type: 'json' }",
+        "lesson": "关注 Node.js 版本更新，import JSON 时确认语法版本"
+      }
+    ]
+  },
+  "checkpoints": {
+    "_comment": "检查点：{ before: 执行前匹配的操作描述, check: [要检查的 errorPatterns.id 列表] }。AI根据 watchFor 场景自动生成",
+    "examples": [
+      {
+        "before": "运行 npm run build",
+        "check": ["build-vite-config-missing"]
+      },
+      {
+        "before": "修改配置文件",
+        "check": ["build-vite-config-missing"]
+      },
+      {
+        "before": "导入 JSON 文件",
+        "check": ["type-import-assertion-deprecated"]
+      }
+    ]
+  }
+}

package/dist/templates/zh/docs/global/map.json

@@ -1,119 +1,49 @@
 {
-  "governance": {
-    "coreRules": [
+  "directoryMapping": {
+    "_comment": "代码目录 ↔ 模块映射：{ path: 目录路径, module: 模块名, responsibility: 职责描述 }",
+    "examples": [
       {
-        "file": "00_system.md",
-        "role": "System Role",
-        "when": "每次对话开始时 (身份设定, 核心原则)"
+        "path": "src/features/auth",
+        "module": "auth",
+        "responsibility": "用户认证、登录、注册"
       },
       {
-        "file": "01_workflow.md",
-        "role": "SOP",
-        "when": "决定当前任务流程 (Task vs Fix) 与验收标准"
-      },
-      {
-        "file": "02_tech_stack.md",
-        "role": "Tech Stack",
-        "when": "技术选型、代码规范、工程治理标准"
-      },
-      {
-        "file": "03_data_governance.md",
-        "role": "Data Governance",
-        "when": "读写全局 JSON 数据文件时"
-      },
-      {
-        "file": "04_cli_tools.md",
-        "role": "CLI Reference",
-        "when": "执行 Terminal Gate 命令时 (npx archi task/plan/render 语法速查)"
-      },
-      {
-        "file": "99_context_glue.md",
-        "role": "Context Bridge",
-        "when": "触碰代码时，自动关联上下文文档"
+        "path": "src/features/todos",
+        "module": "todo",
+        "responsibility": "待办事项 CRUD"
       }
-    ],
-    "globalReference": [
-      {
-        "file": "roadmap.json",
-        "role": "Roadmap",
-        "content": "进度追踪、里程碑、技术债管理"
-      },
-      {
-        "file": "vision.md",
-        "role": "Vision",
-        "content": "愿景、北极星指标、设计哲学"
-      },
-      {
-        "file": "map.json",
-        "role": "Map (本文件)",
-        "content": "目录结构、文件索引、逻辑拓扑"
-      },
-      {
-        "file": "dictionary.json",
-        "role": "Dictionary",
-        "content": "业务术语、公共组件注册表"
-      },
-      {
-        "file": "design_tokens.json",
-        "role": "Visuals （仅ui项目）",
-        "content": "颜色、字体、间距变量"
-      },
-      {
-        "file": "data_snapshot.json",
-        "role": "Data （仅data项目）",
-        "content": "数据库 Schema 镜像"
-      },
-      {
-        "file": "error_codes.json",
-        "role": "Errors",
-        "content": "业务错误码注册表"
-      },
-      {
-        "file": "api_snapshot.json",
-        "role": "API （仅api项目）",
-        "content": "HTTP 端点注册表与协议映射"
-      },
-      {
-        "file": "env_registry.json",
-        "role": "Env （仅api项目）",
-        "content": "运行时环境变量清单"
-      },
-      {
-        "file": "command_api.json",
-        "role": "Commands （仅cli项目）",
-        "content": "CLI 命令签名注册表"
-      },
+    ]
+  },
+  "logicalTopology": {
+    "_comment": "逻辑拓扑：{ module: 模块名, layer: 层(layer/domain/interface/infrastructure), depends: [依赖模块] }",
+    "examples": [
+      { "module": "auth", "layer": "domain", "depends": ["user-repo"] },
+      { "module": "todo", "layer": "domain", "depends": ["auth", "todo-repo"] }
+    ]
+  },
+  "criticalUserJourneys": {
+    "_comment": "关键用户旅程：{ journey: 旅程名, steps: [步骤], owner: 归属任务ID }",
+    "examples": [
       {
-        "file": "public_api.json",
-        "role": "Exports （仅lib项目）",
-        "content": "库 / SDK 公共导出 API 注册表"
+        "journey": "用户注册登录",
+        "steps": ["访问首页", "点击注册", "填写表单", "提交验证", "登录成功"],
+        "owner": "FEAT-AUTH"
       }
     ]
   },
-  "featureDocs": [
-    {
-      "file": "spec.md",
-      "category": "Specification",
-      "purpose": "业务逻辑、算法、验收标准 (Logic)"
-    },
-    {
-      "file": "ui.md",
-      "category": "UI/UX",
-      "purpose": "任务级 UI 范围声明 — 引用 ui_context.md 中的屏幕 ID，指定本任务涵盖的屏幕/组件范围"
-    },
-    {
-      "file": "design.md",
-      "category": "Technical Design",
-      "purpose": "仅Complex任务: 技术方案设计 — 核心机制的状态机/流水线/协议定义、参数表与不变量"
-    },
-    {
-      "file": "plan.json",
-      "category": "Plan",
-      "purpose": "详细步骤拆解与测试用例 (Execution)"
-    }
-  ],
-  "directoryMapping": [],
-  "logicalTopology": [],
-  "criticalUserJourneys": [],
-  "featureRelations": []
+  "featureRelations": {
+    "_comment": "影响关联关系，以网状结构组织：{ group: 网名, members: [成员文件], rule: 变更规则 }",
+    "examples": [
+      {
+        "group": "UI 协议",
+        "members": [
+          "prompts/ui.md",
+          "skills/archi-ui-wireframe/SKILL.md",
+          "prompts/start.md",
+          "prompts/inherit.md"
+        ],
+        "rule": "UI 协议与 Skill 强关联，变更需互相检查"
+      }
+    ]
+  }
 }

package/dist/templates/zh/{rules/04_cli_tools.md → docs/global/references/cli_reference.md}

@@ -1,10 +1,3 @@
----
-description: CLI Reference Manual. Working directory rule and command syntax for npx archi task/plan/render.
-globs: **/*
-applyTo: **/*
-alwaysApply: true
----
-
 # CLI Reference
 
 > **Role**: 命令速查手册。提供 `npx archi` 系列命令的语法与参数，供 Terminal Gate 执行时查阅。

package/dist/templates/zh/{rules/02_tech_stack.md → docs/global/tech_stack.md}

@@ -1,10 +1,3 @@
----
-description: Technical Standards & Technology Stack. Contains language versions, framework choices, coding conventions, naming rules, and forbidden patterns. Consult when writing code.
-globs: **/*
-applyTo: **/*
-alwaysApply: true
----
-
 # Tech Stack & Engineering Standards: [项目名称]
 
 > **Role:** The "Law" of the codebase. Defines tools, structure, and engineering workflows.
@@ -15,7 +8,7 @@ alwaysApply: true
 ## 1. Global Mandates (全局红线)
 * **No Hardcoding:** 所有的密钥、API地址必须使用环境变量，严禁硬编码。
 * **No Dead Code:** 提交的代码必须是干净的，严禁保留注释掉的代码块或无用的 `TODO`。
-* **Comments for Why:** 注释解释“为什么这么做”（业务背景），而不仅仅是“做了什么”。
+* **Comments for Why:** 注释解释"为什么这么做"（业务背景），而不仅仅是"做了什么"。
 
 ---
 
@@ -51,23 +44,19 @@ alwaysApply: true
 ---
 
 <!-- ═══════ 以下为固定协议（禁修改） ═══════ -->
-## 4. UI Protocol: ITP v3.0 (Dual-Artifact) [可选 - 仅适用于有 UI 的项目]
+## 4. UI Protocol: ITP v3.0 (Tri-Artifact) [可选 - 仅适用于有 UI 的项目]
 <!-- 核心 UI 描述协议 -->
 > **Note:** 如果项目没有 UI（如 CLI、Backend API、Library），可以删除此章节。
 
-### 4.1 Dual-Artifact Strategy (双制品策略)
-
-UI 制品层级：
+### 4.1 Tri-Artifact Strategy (三制品策略)
 
 | 制品 | 格式 | 读者 | 职责 |
 |:---|:---|:---|:---|
-| `ui_concept.html` | 单文件 HTML | 人类 (浏览器) | **全局视觉真相源** — 所有屏幕的线框图/着色稿 |
-| `ui_context.md` | 结构化 Markdown | AI (plan/code/audit/edit) | **AI 屏幕索引** — 屏幕 ID/路由/状态/导航关系/共享组件轻量清单 |
-| `ui.md` | ITP v3.0 DSL | AI (code/audit) | 任务级 UI 范围声明 — 指定本任务涵盖的屏幕/组件 |
-- `ui_concept.html` 由 `archi-ui-wireframe` Skill 生成，覆盖项目所有用户可见屏幕；仅供人类在浏览器预览
-- `ui_context.md` 由同一 Skill 同步生成，是 AI 命令读取 UI 结构信息的唯一入口；禁手动修改
-- `ui.md` 仅声明"本任务负责 ui_context.md 中的哪些屏幕/状态"，禁重定义全局布局
-- code 阶段以 `ui.md`（任务设计）+ `ui_context.md`（结构/导航）+ `design_tokens.json`（视觉约束）为准；同时以 `ui_concept.html` 为**只读视觉参考**校准布局，用**项目自身技术栈**实现等价视觉效果
+| `screens/` | 多文件 HTML (`index.html` + `S-XX.html` + `_shared.css`) | 人类 (浏览器) | **全局视觉真相源** — `/archi.ui` 触发 Skill 生成；每个屏幕独立预览 |
+| `ui_context.md` | 结构化 Markdown | AI (plan/code/audit/edit) | **AI 屏幕索引** — AI 读取 UI 结构的唯一入口；由同一 Skill 同步生成；禁手动修改 |
+| `ui.md` | ITP v3.0 DSL | AI (code/audit) | 任务级 UI 范围声明 — 仅声明本任务负责的屏幕/状态，禁重定义全局布局 |
+
+- code 阶段以 `ui.md` + `ui_context.md` + `design_tokens.json` 为准；`screens/S-XX.html` 为**只读视觉参考**，用**项目自身技术栈**实现等价效果
 
 ### 4.2 Naming (PrefixFunction)
 组件命名须遵循 `前缀+功能` 格式：
@@ -190,4 +179,4 @@ UI 制品层级：
 
 ### Auth & Access (认证与权限) （仅ui或api项目）
 * **Mechanism:** [例如：JWT + RBAC / Session + Owner Only / API Key]
-* **Rationale:** [例如：多角色后台管理系统，需细粒度权限控制]
+* **Rationale:** [例如：多角色后台管理系统，需细粒度权限控制]

package/dist/templates/zh/docs/global/vision.md

@@ -77,6 +77,6 @@ description: Project Constitution: Vision, Personas, Principles & Boundaries.
 **Trigger**: 仅在项目初始化 (`/archi.start`) 或重大战略转型 (`/archi.revise`) 时修改。
 
 **Action**:
-1.  **Alignment**: 确保 Section 3 (Principles) 与 `02_tech_stack.md` 中的技术选型不冲突。
+1.  **Alignment**: 确保 Section 3 (Principles) 与 `tech_stack.md` 中的技术选型不冲突。
 2.  **Completeness**: 必须填满所有 `[ ]` 占位符，严禁保留 "Example" 字样。
 3.  **Consistency**: 所有的 Task Spec (`.spec.md`) 都必须引用此文件的 Vision 以确保不跑题。

package/dist/templates/zh/docs/prompts/audit.md

@@ -33,10 +33,10 @@
         | `pending` | 拒绝 — 无代码可审查 |
         | `blocked` | 拒绝 — 前置依赖未完成 |
 
-    3.  **Load**: vision.md（方向基准）+ task docs (spec/plan/ui) + 前次 audit.md（对比用）+ project context (tech_stack/design_tokens/data_snapshot/ui_context/ui_concept)。读取该任务对应的所有代码文件。
+    3.  **Load**: vision.md（方向基准）+ task docs (spec/plan/ui) + 前次 audit.md（对比用）+ project context (tech_stack/design_tokens/data_snapshot/ui_context/screens/)。读取该任务对应的所有代码文件。
 
     **项目级 — Load Overview**:
-    1.  读取 vision.md、roadmap.json、map.json、02_tech_stack.md。
+    1.  读取项目上下文（vision、roadmap、tech_stack、map），详见 00_system.md 数据治理规则。
     2.  扫描 tasks/ 目录结构。
     3.  读取项目代码入口文件与关键模块。
 
@@ -57,15 +57,15 @@
     | 4 | **逻辑正确性** | 业务逻辑错误、矛盾、遗漏分支、状态机缺陷 |
     | 5 | **Bug 猎杀** | 空值/undefined、竞态、资源泄漏、死循环、off-by-one |
     | 6 | **错误处理** | 吞错、静默失败、错误传播链完整性、用户可见反馈 |
-    | 7 | **Tech Stack 合规** | 对照 `02_tech_stack.md`：违禁模式、过时 API、硬编码 |
+    | 7 | **Tech Stack 合规** | 对照 `tech_stack.md`：违禁模式、过时 API、硬编码 |
     | 8 | **安全性** | 敏感信息泄露、输入未校验、注入风险、权限检查 |
     | 9 | **性能** | 不必要全量导入/大循环/无用计算/内存泄漏/N+1 查询 |
-    | 10 | （本任务涉及ui时） **Design 合规** | Token 使用；无硬编码魔法值；与 `ui_concept.html` 视觉一致 |
+    | 10 | （本任务涉及ui时） **Design 合规** | Token 使用；无硬编码魔法值；与 `screens/S-XX.html` 视觉一致 |
     | 11 | （本任务涉及data时） **数据一致性** | 字段名/类型与 `data_snapshot.json` 一致 |
     | 12 | （仅i18n项目） **I18n 合规** | 无硬编码字符串；须用 Key/字典引用 |
     | 13 | **Orphan .gitkeep** | 目录已有其他文件时仍存在 `.gitkeep` — 须删除 |
     | 14 | **Spec-Code 漂移** | 接口/类型/行为与 `spec.md` 一致；手动变更已同步文档 |
-    | 15 | （本任务涉及ui时） **UI 引用完整性** | `ui.md` 中 `ref: ui_concept.html#S-XX` 指针是否仍有效 |
+    | 15 | （本任务涉及ui时） **UI 引用完整性** | `ui.md` 中 `ref: screens/S-XX.html` 指针是否仍有效 |
 
     **Output**: 按维度分组的发现列表，每项含级别、位置、描述。进入 step_3_report。
 </step_2a_task>

package/dist/templates/zh/docs/prompts/code.md

@@ -1,6 +1,6 @@
 <protocol_code>
   **Trigger**: `/archi.code <id>` | 自然语言触发时由 Workflow Dispatch 自动加载
-  **Goal**: 基于 `tasks/<id>_<Slug>/plan.json` 任务清单，完成功能开发；遵循 `02_tech_stack.md`（仅ui项目: 同时遵循 `design_tokens.json`）；通过构建、类型、Lint、格式化、测试与审计。
+  **Goal**: 基于 `tasks/<id>_<Slug>/plan.json` 任务清单，完成功能开发；遵循 `tech_stack.md`（仅ui项目: 同时遵循 `design_tokens.json`）；通过构建、类型、Lint、格式化、测试与审计。
 
 <meta>
     <style>Deterministic, Type-Safe, SOTA-First</style>
@@ -29,7 +29,7 @@
         | `blocked` | 拒绝 — 前置依赖未完成 |
         | `done` | 拒绝 — 已完成，如需修改用 `/archi.edit <ID>` |
 
-    3.  **Load**: task docs (spec/ui/design/plan) + project context (tech_stack/design_tokens/data_snapshot/ui_context/ui_concept) + refs（按 tags 匹配，仅读命中文件）。
+    3.  **Load**: task docs (spec/ui/design/plan) + project context (tech_stack/design_tokens/data_snapshot/ui_context/screens/) + refs（按 tags 匹配，仅读命中文件）。
 
     **Output**: 待实施任务的原子清单，标注依赖与顺序。
 </step_1_resolve>
@@ -49,10 +49,10 @@
 <step_3_implement>
     **Protocol**:
     - **Read First**: 修改前须读取目标文件；遵循项目现有代码风格。
-    - **Use Existing Stack**: 仅用 `02_tech_stack.md` 声明的技术与库。
-    - （本任务涉及ui时） **Design Tokens Only**: 样式严格使用 Token/Preset；禁硬编码魔法值。
+    - **Use Existing Stack**: 仅用 `tech_stack.md` 声明的技术与库。
+    - （本任务涉及ui时）[[INCLUDE: shared/ui-redlines.md]]
     - **Type-Safe**: 补齐类型定义；用项目技术栈的类型系统守护边界。
-    - **Code Organization**: 遵循 `02_tech_stack.md` 架构模式与文件归位策略。
+    - **Code Organization**: 遵循 `tech_stack.md` 架构模式与文件归位策略。
     - **Comments**: 解释 Why 而非 What。
     - **Naming**: 自解释命名；拒绝无意义名。
     - 仅Complex任务: **Design Adherence**: 存在 `design.md` 时，实现须严格遵循其状态机/流水线/协议；参数引用 § 3 的值；须满足 § 4 所有 Invariants。
@@ -68,9 +68,13 @@
 </step_3_implement>
 
 <step_4_validate>
-    **Action** (失败须修复后重跑；命令以 `02_tech_stack.md` Section 5 为准):
+    **Action** (失败须修复后重跑；命令以 `tech_stack.md` Section 5 为准):
 
-    **Automated Check**: 运行 `[[__DOCS_DIR__]]/scripts/validate`（如存在）；否则按以下清单逐项执行。
+    **Automated Check**: 检查 `scripts/validate`：
+    - **存在** → 必须运行，结果以脚本输出为准
+    - **不存在** → 按以下清单逐项执行
+
+    > **Scripts Check**: 如 `scripts/` 目录不存在 → 建议先运行 `/archi.script` 生成自动化脚本。
 
     | Phase | 检查项 | 要求 |
     |:---|:---|:---|
@@ -111,7 +115,7 @@
     [[SUBAGENT: archi-feature-relations|mode: check, context: 将本次实现的功能与 featureRelations sources 做语义对比]][[NO-SKILL: （Skill 未安装：请阅读 `[[__DOCS_DIR__]]/skills/archi-feature-relations/SKILL.md`，按 mode: check 的逻辑执行）]]
 
     **5C. 数据治理同步**:
-    [[SUBAGENT: archi-data-sync|context: 扫描本次实现引入的新业务实体/错误码/Schema，按 03_data_governance.md 规则增量同步]][[NO-SKILL: （Skill 未安装：请阅读 `[[__DOCS_DIR__]]/skills/archi-data-sync/SKILL.md`，按其执行协议操作）]]
+    [[SUBAGENT: archi-data-sync|context: 扫描本次实现引入的新业务实体/错误码/Schema，按 00_system.md 规则增量同步]][[NO-SKILL: （Skill 未安装：请阅读 `[[__DOCS_DIR__]]/skills/archi-data-sync/SKILL.md`，按其执行协议操作）]]
 
     [[INCLUDE: shared/verify-result-handling.md]]
 </step_5_verify>
@@ -128,7 +132,7 @@
     1.  确认 `plan.json` 各 task `done` 标记已全部更新。
     2.  **Drift Warning**: 对比代码变更与 `spec.md` 关键点位。发现超出 spec 覆盖范围 → 标注 `⚠️ Spec 漂移`，建议 `/archi.edit <ID>`。
     3.  输出完成任务清单与补丁链接。
-    4.  提供下一步建议与 Git Commit Suggestion（Conventional Commits）。
+    4.  提供下一步建议。
 
     **Pre-signoff Checklist** (Output 前须逐项确认):
     □ plan.json — 每个 task done 标记已实时更新（非 signoff 时批量操作）
@@ -136,13 +140,21 @@
     □ Step 4 — 每种项目类型的 Task Verification 已执行并附 Evidence
     □ Step 5A Silent Audit — 已执行，所有 CRITICAL 问题已修复
     □ Step 5B featureRelations 联动检查 — 已执行
+      - 涉及修改的文件是否影响其他关联文件
     □ Step 5C 数据治理同步 — 已执行
+      - dictionary.json + error_codes.json + env_registry.json — 必检
+      - （仅ui项目）design_tokens.json + ui_context.md
+      - （仅data项目）data_snapshot.json
+      - （仅api项目）api_snapshot.json
+      - （仅cli项目）command_api.json
+      - （仅lib项目）public_api.json
     □ Terminal Gate — npx archi plan <ID> 全部完成（仅豁免项除外）
 
-    **Output**: 完成摘要，含已完成任务、豁免项(如有)、Git Commit 建议、Next Steps：
+    **Output**: 完成摘要，含已完成任务、豁免项(如有)、Next Steps：
 
     | 优先级 | 动作 | 说明 |
     |:---|:---|:---|
+    | （如无 scripts/） | `/archi.script` | 生成自动化验证脚本（validate/dev-up/dev-reset） |
     | 推荐 | `/archi.audit <ID>` | 对实现做独立审查 |
     | （有 Spec 漂移时） | `/archi.edit <ID>` | 先更新文档再继续 |
     | （有后续 pending 任务时） | `/archi.plan <下一个 pending ID>` | 规划下一个任务 |

package/dist/templates/zh/docs/prompts/edit.md

@@ -41,14 +41,14 @@
 <step_2_refine_docs>
     **Action**:
     - 根据 `[context]` 修改 spec.md 和 ui.md。
-    - （ui有修改） [[SKILL: archi-ui-wireframe|按 skill 的协议同步更新 `ui_concept.html` + `ui_context.md`]][[NO-SKILL: （Skill 未安装：请阅读 `[[__DOCS_DIR__]]/skills/archi-ui-wireframe/SKILL.md`）]]：
+    - （ui有修改） [[SKILL: archi-ui-wireframe|按 skill 的协议同步更新 `screens/S-XX.html` + `ui_context.md`]][[NO-SKILL: （Skill 未安装：请阅读 `[[__DOCS_DIR__]]/skills/archi-ui-wireframe/SKILL.md`）]]：
 
       | 变更类型 | 判定标准 | 处理方式 |
       |:---|:---|:---|
       | 无屏幕影响 | 仅逻辑/数据变更 | 仅改 spec.md |
-      | 轻微 UI 调整 | 新增/修改状态、弹窗、局部区域 | 调用 skill 更新，输出 `MODIFIED: S-XX` |
+      | 轻微 UI 调整 | 新增/修改状态、弹窗、局部区域 | 调用 skill 更新，输出 `MODIFIED: screens/S-XX.html` |
       | 屏幕结构变更 | 布局重构、新增屏幕、导航变化 | 调用 skill 更新 |
-      | 功能缩减 | 屏幕/区域整体移除 | 调用 skill 删除，输出 `REMOVED: S-XX` |
+      | 功能缩减 | 屏幕/区域整体移除 | 调用 skill 删除，输出 `REMOVED: screens/S-XX.html` |
 
     - 需求模糊时向用户提问确认。
 
@@ -68,6 +68,12 @@
     **Output**: 追加了新任务的 plan.json；若执行状态转换，输出 `MODIFIED: roadmap.json <ID>.status done→active`。进入 step_4_verify。
 </step_3_update_plan>
 
+<step_4_data_sync>
+    **数据治理同步**:
+
+    [[SUBAGENT: archi-data-sync|context: 扫描需求变更引入的新业务实体/错误码/Schema/端点/命令/导出，按 00_system.md 规则增量同步]][[NO-SKILL: （Skill 未安装：请阅读 `[[__DOCS_DIR__]]/skills/archi-data-sync/SKILL.md`，按其执行协议操作）]]
+</step_4_data_sync>
+
 <step_4_verify>
     **Role**: 独立审查官
 
@@ -76,17 +82,25 @@
     [[INCLUDE: shared/verify-result-handling.md]]
 </step_4_verify>
 
-<step_5_summary>
+<step_6_summary>
     **Pre-signoff Checklist** (输出前须逐项确认):
     □ spec.md — 已按 context 更新，变更已追踪
-    □ （ui有修改）ui.md + ui_concept.html + ui_context.md — 已同步更新
+    □ （仅ui项目，ui有修改）ui.md + screens/S-XX.html + ui_context.md — 已同步更新
     □ plan.json — 新 Phase 已追加（历史任务完整保留）
     □ （原 status=done）roadmap.json — status 已重置为 active
+    □ 全局文件 — 变更涉及的相关 JSON 已同步更新
+      - dictionary.json + error_codes.json + env_registry.json — 必检
+      - （仅ui项目）design_tokens.json + ui_context.md
+      - （仅data项目）data_snapshot.json
+      - （仅api项目）api_snapshot.json
+      - （仅cli项目）command_api.json
+      - （仅lib项目）public_api.json
+    □ Step 4 Data Sync — archi-data-sync 已执行
     □ Step 4 Silent Audit — 已执行，所有 CRITICAL 问题已修复
     □ Terminal Gate — task --check 无 ERROR（step_3 中已执行）
 
     **Action** (Gate 须在 step_3 完成):
     **Output**: Task 更新摘要，含 Spec/UI/Plan 变更概要和 Next Steps 表格。推荐运行 `/archi.code <ID>`。
-</step_5_summary>
+</step_6_summary>
 
 </protocol_edit>

package/dist/templates/zh/docs/prompts/fix.md

@@ -23,7 +23,7 @@
         - 无 `<id>`: 分析 `[context]` 搜索最相关模块。
           唯一匹配 → 自动锁定 | 多个匹配 → 列出候选询问 | 无法定位 → 报错请求指定 ID。
     2.  读取目标目录下所有文档与相关代码。
-    3.  读取 02_tech_stack.md（技术红线）和 vision.md（方向基准）。
+    3.  读取项目上下文（tech_stack、vision），详见 00_system.md 数据治理规则。
     4.  分析 `[context]`，结合代码逻辑定位潜在故障点。
     5.  **Hypothesis**: 提出 1-3 个根因假设。
 
@@ -50,6 +50,7 @@
     **Terminal Gate** (禁止跳过):
     | 步骤 | 命令 | 通过条件 |
     |:---|:---|:---|
+    | 0 | 检查 `scripts/validate` | 存在则必须运行，以其结果为准 |
     | 1 | 运行构建命令 | 构建成功 |
     | 2 | 运行类型检查 | 零类型错误 |
     | 3 | 运行 Lint/Format | 通过 |
@@ -63,6 +64,12 @@
     [[INCLUDE: shared/verify-result-handling.md]]
 </step_4_verify>
 
+<step_4_5_data_sync>
+    **数据治理同步**:
+
+    [[SUBAGENT: archi-data-sync|context: 扫描 Bug 修复引入的新业务实体/错误码/Schema，按 00_system.md 规则增量同步]][[NO-SKILL: （Skill 未安装：请阅读 `[[__DOCS_DIR__]]/skills/archi-data-sync/SKILL.md`，按其执行协议操作）]]
+</step_4_5_data_sync>
+
 <step_5_plan_update>
     **Action**:
     1. 更新 plan.json Bugfix Phase 中已完成 tasks 的 `done: true`。
@@ -78,6 +85,7 @@
     □ plan.json — Bugfix Phase 已追加（step_2）
     □ 复现测试已创建并验证（Red → Green）
     □ 代码修复仅针对 Bug，无借机重构
+    □ Step 4.5 Data Sync — archi-data-sync 已执行
     □ Step 4 Terminal Gate — 构建/类型检查/Lint/测试全部通过
     □ Step 4 Silent Audit — 已执行，所有 CRITICAL 问题已修复
     □ plan.json Bugfix Phase — done 标记已更新（step_5）
@@ -86,6 +94,7 @@
 
     | 优先级 | 动作 | 说明 |
     |:---|:---|:---|
+    | （如无 scripts/） | `/archi.script` | 生成自动化验证脚本 |
     | 推荐 | `/archi.audit <ID>` | 重新审查，确认修复完整 |
     | 可选 | `/archi.code <ID>` | 如有未完成项，继续实现 |
 </step_6_summary>

package/dist/templates/zh/docs/prompts/inherit.md

@@ -101,13 +101,13 @@
 
     ### 信息路由规则
 
-    > 规则文件（`02_tech_stack`、`90_custom_rules` 等）已由 IDE 注入当前上下文，AI 已知其路径，直接写入即可。
+    > 规则文件（`tech_stack`、`90_custom_rules` 等）已由 IDE 注入当前上下文，AI 已知其路径，直接写入即可。
 
     **有 Brief 时**（Brief → 目标文件）:
     | Brief 内容 | 目标文件 |
     |:---|:---|
     | 项目身份、目标用户、成功指标、参考灵感 | `[[__DOCS_DIR__]]/global/vision.md` |
-    | 技术栈、部署目标、第三方库/服务 | 规则文件 `02_tech_stack` |
+    | 技术栈、部署目标、第三方库/服务 | 规则文件 `tech_stack` |
     | 核心任务列表 | `[[__DOCS_DIR__]]/global/roadmap.json`（phase-1/2，调用 archi-decompose-roadmap） |
     | 补充说明中的规则/约定/偏好 | 规则文件 `90_custom_rules` |
     | 风格调性（仅ui） | `design_tokens.json` aestheticDirection 等 |
@@ -116,7 +116,7 @@
     | 信息来源 | 目标文件 |
     |:---|:---|
     | README 描述/特性 | vision.md |
-    | 依赖/配置/代码模式 | 02_tech_stack |
+    | 依赖/配置/代码模式 | tech_stack |
     | 目录结构/模块依赖/用户旅程 | map.json |
     | 领域术语/命名约定 | dictionary.json |
     | eslint/prettier 等规范 | 90_custom_rules |
@@ -129,7 +129,7 @@
     - **无 Brief**：从 README + 项目配置推导，无法推导的项标注 `(AI 补全 — 建议用户审查)`
     - 禁保留模板占位符
 
-    ### 3.2 Tech Stack (规则文件 `02_tech_stack`)
+    ### 3.2 Tech Stack (规则文件 `tech_stack`)
     - **有 Brief**：Brief 确定的 → 直接写入；留空/推荐的 → AI 推荐；代码依赖作补充
     - **无 Brief**：已有依赖/配置 → 直接写入；可见规范 → 写入 Coding Standards
     - 须填充完整 Section 1-8
@@ -210,14 +210,13 @@
     - `dictionary.json`: 从代码提取领域术语
     - （仅ui项目） `design_tokens.json`: 从 CSS 变量/主题提取
     - （仅data项目） `data_snapshot.json`: 从 schema/migration 提取
+    - （仅api项目） `api_snapshot.json`: 从现有 API 路由/控制器代码提取端点
+    - `env_registry.json`: 从代码中 `process.env` 引用提取环境变量
+    - （仅cli项目） `command_api.json`: 从现有 CLI 入口代码提取命令
+    - （仅lib项目） `public_api.json`: 从 package.json exports 或入口文件提取导出
     - `error_codes.json`: 从代码中的错误定义提取
 
-    仅ui项目: **UI 概念设计（Adopt 模式）**: [[SKILL: archi-ui-wireframe|调用 skill（adopt 模式），从代码逆向生成 UI 概念设计。]][[NO-SKILL: （Skill 未安装：请阅读 `[[__DOCS_DIR__]]/skills/archi-ui-wireframe/SKILL.md` 并遵循其 Adopt 协议执行）]]
-    - 读取代码中的路由定义、页面组件、布局文件
-    - 读取 step_3 写入的 design_tokens.json（含代码提取的 CSS 变量/theme）
-    - tokens 不完整时触发 skill 内置引导流程
-    - 写入 `ui_concept.html` + `ui_context.md`
-    - 输出 UI 概念设计摘要，等待用户确认或反馈调整
+    仅ui项目: **UI 概念设计**: 跳过 — 由 `/archi.ui` 独立完成。仅确保 `design_tokens.json` 已从 CSS 变量/主题提取填充。
 
     **Output**: 写入所有文件，运行 `npx archi render`。进入 step_4_verify。
 </step_3_constitution>
@@ -234,12 +233,16 @@
 
     **Pre-signoff Checklist** (Gate 通过后、输出前须逐项确认):
     □ vision.md — 已填充（无 Brief 时: 推导内容标注了 `(AI 补全 — 建议用户审查)`）
-    □ 02_tech_stack.md — Section 1-8 完整填充
+    □ tech_stack.md — Section 1-8 完整填充
     □ roadmap.json — 每个功能模块对应一条 LEG-xx（status: done, tag: Legacy）
     □ tasks/LEG-xx_<Slug>/spec.md — 每条 LEG 均有对应 Stub spec（含关联文件列表）
     □ map.json — directoryMapping + logicalTopology + criticalUserJourneys + featureRelations 均已填充
-    □ dictionary.json + error_codes.json — 从代码提取完毕
-    □ （仅ui项目）design_tokens.json + ui_concept.html + ui_context.md — Adopt 模式已执行
+    □ dictionary.json + error_codes.json + env_registry.json — 从代码提取完毕
+    □ （仅ui项目）design_tokens.json — Adopt 模式已从 CSS 提取
+    □ （仅data项目）data_snapshot.json — 初始实体骨架已写入
+    □ （仅api项目）api_snapshot.json — 初始 API 端点已注册
+    □ （仅cli项目）command_api.json — 初始 CLI 命令已注册
+    □ （仅lib项目）public_api.json — 初始库导出已注册
     □ Step 4 Silent Audit — 已执行，所有 CRITICAL 问题已修复
 
     **Action** (Checklist 全部确认后):
@@ -256,6 +259,8 @@
     | 优先级 | 动作 | 说明 |
     |:---|:---|:---|
     | 1 | 审查 vision.md | 确认 AI 补全的愿景描述是否准确 |
+    | （仅ui项目） 推荐 | `/archi.ui` | 生成 UI 概念设计（`screens/` 多文件结构，Adopt 模式） |
+    | （有基建后） | `/archi.script` | 生成 AI 自动化脚本（validate/dev-up/dev-reset） |
     | 2 | `/archi.edit LEG-xx` | 对核心模块补全完整 spec（自动触发 Enrich 流程） |
     | 3 | `/archi.scope [file_path]` | 规划新功能/大模块 |
     | 4 | `/archi.plan <任务ID>` | 对单个任务做深度规划 |

package/dist/templates/zh/docs/prompts/map.md

@@ -8,7 +8,7 @@
     <principles>
       1.  **Scan vs Map**: 以实际文件系统为 Ground Truth，map.json 为旧快照。
       2.  **Smart Granularity**: 默认目录级；单文件承载多职责时须细化到文件级。
-      3.  **Architecture Inference**: 新条目的层级归类须参考现有 map 模式 + `02_tech_stack.md`。
+      3.  **Architecture Inference**: 新条目的层级归类须参考现有 map 模式 + `tech_stack.md`。
       4.  **Batch Confirm**: 所有变更一次性展示，用户批量确认。
       5.  **IDE-Native First**: 利用 IDE 原生能力驱动执行节奏，本协议定义质量标准和检查点，不对抗 IDE 的规划/执行机制。
     </principles>
@@ -16,8 +16,8 @@
 
 <step_1_scan>
     **Action**:
-    1.  **Read Map**: 读取 `[[__DOCS_DIR__]]/global/map.json` — 当前架构地图。
-    2.  **Read Tech Stack**: 读取 `02_tech_stack.md` — 目录结构约定、架构模式。
+    1.  **Read Map**: 读取 map.json — 当前架构地图。
+    2.  **Read Tech Stack**: 读取 tech_stack — 目录结构约定、架构模式。
     3.  **Scan Directory Tree**: 扫描项目目录结构。
         - **排除**: `.git/`, `node_modules/`, `dist/`, `build/`, `[[__DOCS_DIR__]]/`, 及 `.gitignore` 中声明的路径。
         - **深度**: 跟随 map.json 现有条目的粒度模式。
@@ -48,7 +48,7 @@
     ### 归类策略
 
     1.  **模式匹配**: 参考 map.json 同层级已有条目的归类。
-    2.  **Tech Stack 约定**: `02_tech_stack.md` 中的目录结构规则。
+    2.  **Tech Stack 约定**: `tech_stack.md` 中的目录结构规则。
     3.  **内容推断**: 读取文件内容（import 关系、导出类型）。
     4.  **无法确定**: 标记为 `[?]`，交由用户指定。
 
@@ -100,6 +100,7 @@
     □ 过期条目已从 directoryMapping 移除
     □ 新增条目已正确归类（path + layer + description 均已填写）
     □ 疑似重命名已明确处理（非静默忽略）
+    □ featureRelations — 目录变更若影响关联关系，已同步更新
     □ lastUpdated 已更新
     □ Terminal Gate — task --check + render 通过