architext 0.0.4 → 0.0.6

package/dist/templates/en/rules/03_data_governance.md

@@ -1,102 +0,0 @@
----
-description: AI collaboration governance rules for JSON data files. Defines read/write specs, update timing & format constraints for global data files.
-globs: "**/*.json"
-applyTo: "**/*.json"
-alwaysApply: true
----
-
-# Data Governance Protocol
-
-> **Role**: Data Steward. Ensure consistency, integrity & traceability of global JSON data files.
-
-## 1. Data File Registry
-
-| File | Type | Read When | Write When |
-|:---|:---|:---|:---|
-| `roadmap.json` | Roadmap | `/archi.plan`, `/archi.code` start | `/archi.start` creates; AI direct edit or `npx archi task` updates status |
-| `map.json` | Architecture Map | When touching code (via context_glue) | `/archi.plan` Step 3 (global sync); `/archi.inherit` Step 3.6; `/archi.map` |
-| `dictionary.json` | Glossary | When generating variable names | `/archi.plan` Step 3; step_5 auto-appends after code/fix |
-| `design_tokens.json` | Design Tokens [?UI] | When generating UI code | `/archi.start` creates; update on design changes |
-| `data_snapshot.json` | Data Snapshot [?Data] | `/archi.plan` Q1 design; `/archi.code` implementation | Plan phase designs Schema; Code phase syncs actual changes |
-| `error_codes.json` | Error Contracts | When writing error handling | `/archi.plan` Step 3; step_5 auto-appends after code/fix |
-
----
-
-## 2. General Rules
-
-### 2.1 Format Constraints
-
-- **JSON Only**: The single source of truth for global data is `.json` files. `.md` views are auto-generated by `npx archi render`; prohibited from editing `.md` views directly.
-- **Schema Stability**: Managed in two tiers:
-  - **Tier 1 (Strict)**: `roadmap.json`, `plan.json` — CLI rendering/commands depend on these directly; structure is validated by Zod Schema; prohibited from changing fields arbitrarily.
-  - **Tier 2 (Flexible)**: `dictionary.json`, `error_codes.json`, `data_snapshot.json`, `design_tokens.json`, `map.json` — Only top-level keys are validated. If existing fields cannot adequately describe what needs to be recorded, you may freely extend fields (add new keys or new properties in array items) without modifying the CLI.
-- **Valid JSON**: Must ensure valid JSON after writing (no trailing commas, no comments).
-
-### 2.2 Read/Write Discipline
-
-| Scenario | Rule |
-|:---|:---|
-| Need to consult data | Read `.json` file; prohibited from reading `.md` view (may be stale) |
-| Need to update Roadmap task status | Prefer `npx archi task <ID> --status <s>`; batch updates may edit JSON directly |
-| Need to update other data files | AI directly edits `.json` file |
-| After updates | Run `npx archi render` to regenerate `.md` views |
-
----
-
-## 3. File-Specific Rules
-
-### `roadmap.json`
-
-- **Structure**: `phases[] → tasks[]`, each task must have `id`, `title`, `status`, `deps`.
-- **Status values**: `pending` | `active` | `done` | `blocked`.
-- **Dependency integrity**: IDs in `deps` must exist in tasks.
-- **Slug rule**: `slug` is used for tasks folder naming, format `Snake_Case`.
-
-### `map.json`
-
-- **Directory Mapping**: Must reflect the real physical file tree.
-- **Logical Topology**: Must register each Task Module's responsibility.
-- **Feature Relations** (field `featureRelations`): Records linkage relationships between aggregator tasks and their sources. Each entry: `{ aggregator, sources, evidence, checkNote }`. Written by AI during `/archi.plan` (when planning an aggregator task) or `/archi.inherit` (during reverse scanning); no manual maintenance needed.
-- **Self-Correction**: If code references violate the hierarchy defined in topology, must report error and stop generation.
-- **Extensible**: If existing fields cannot adequately describe the project architecture, you may add fields to items (e.g. `tags`, `owner`) or add new top-level keys.
-
-### `dictionary.json`
-
-- **Naming Authority**: This file is the supreme law of naming.
-- **Boundary**: Only register **project business domain** content. Architext framework concepts (scripts, scaffold, roadmap, plan, etc.) are prohibited from registration.
-- **entities**: Must consult `entities[].codeName` before generating variable names; prohibited from using words in `forbiddenSynonyms`.
-- **verbs**: Business action naming must consult `verbs[].codeName` for project-wide verb consistency.
-- **utilities**: Shared tools (e.g. logger, AppError, fetchClient) must be registered; AI must use registered utilities instead of raw APIs (refer to `replaces` field).
-- **components** [?UI]: Must search existing components before creating new ones; prioritize reuse.
-- **Extensible**: If existing fields cannot adequately describe a term/tool, you may add fields to array items (e.g. `tags`, `scope`, `deprecated`) or add new top-level arrays (e.g. `enums`, `constants`).
-
-### `design_tokens.json` [?UI]
-
-- **Token Only**: Styles must strictly use Tokens; prohibited from hardcoding Hex/px/rem.
-- **Dark Mode**: Must define both `light` and `dark` values.
-- **Extensible**: If existing Token structure cannot cover project needs (e.g. `motion`, `breakpoints`, `z-index`), you may add new properties freely.
-
-### `data_snapshot.json` [?Data]
-
-- **Structure**: `models[]` (name, fields, types, constraints) + `relationships[]` (inter-model relations: 1:1/1:N/M:N/self-ref).
-- **Design First**: Plan phase must define model structure and field types; prohibited from writing "TBD"; must be precise to field names and types.
-- **Sync Back**: After Code phase completion, must sync actual changes back to this file.
-- **Extensible**: If existing fields cannot adequately describe data models (e.g. need to record `indexes`, `triggers`, `seedData`), you may add fields to model items or at the top level.
-
-### `error_codes.json`
-
-- **Boundary**: Only register **project business domain** errors. Framework infrastructure errors (scripts/validate, dev-up, dev-reset, etc.) are handled by scripts themselves via exit code + stderr; prohibited from registration here.
-- **Structure**: `protocolMapping [?API]` (status code → behavior mapping) + `businessErrors` (business error registry).
-- **Code Format**: `ERR_[MODULE]_[REASON]` (e.g. `ERR_AUTH_INVALID_TOKEN`).
-- **statusCode**: Fill per project type (HTTP status / Exit code / leave empty).
-- **Design Before Code**: Must register error codes here before writing error handling code, including `message` and `recovery`.
-- **Extensible**: If existing fields cannot adequately describe error info (e.g. need to record `severity`, `retryable`, `httpBody`), you may add fields to items freely.
-
----
-
-## 4. Plan JSON (`plan.json`)
-
-- **Location**: `tasks/<ID>_<Slug>/plan.json`
-- **Checkbox Updates**: AI sets `done` to `true` directly after completing steps during `/archi.code`.
-- **Append Rule**: `/archi.edit` appends new Phases while preserving completed history.
-- **Verification**: Run `npx archi plan <ID>` to verify completion after finishing.

package/dist/templates/en/rules/99_context_glue.md

@@ -1,53 +0,0 @@
----
-description: Context Navigation & Document Indexing. Bridges source code to documentation using the Map registry. Essential for locating specs and plans.
-globs: **/*
-applyTo: **/*
-alwaysApply: true
----
-
-# Context Glue Protocol
-
-> **Role**: Context Navigator. Prevent AI amnesia, use Map Look-up to determine the business document corresponding to the current code.
-
-## 1. Context Discovery
-
-When reading or editing code files, must execute the following addressing steps:
-
-**Step 1: Check Global Map**
-- Read `[[__DOCS_DIR__]]/global/map.json`.
-- Find the module the current file belongs to in `directoryMapping` / `logicalTopology`.
-- Load the Docs Link (Spec/UI/Plan) registered for that module.
-
-**Step 2: Check Explicit Context**
-- Scenario: Newly created file or Map not yet updated.
-- Check if user Prompt explicitly specified a document path, if so must load it.
-
-**Step 3: Fallback**
-- Not registered in Map and user did not specify → **STOP & ASK**.
-- Prompt: "Spec document for current code not found. Please provide the path, or run `/archi.map` to update the architecture map."
-
----
-
-## 2. Mandatory Loading Rules
-
-| Code Type | Required Context | Source of Truth |
-|:---|:---|:---|
-| **Business Logic** (Tasks/Entities) | Spec Document | `[[__DOCS_DIR__]]/global/map.json` → Module Entry |
-| **UI Components** (Pages/Widgets) [?UI] | UI Document + `[[__DOCS_DIR__]]/global/design_tokens.json` | `[[__DOCS_DIR__]]/global/map.json` + Global Rules |
-| **Data Schema** (ORM/SQL/Models) [?Data] | Data Snapshot | `[[__DOCS_DIR__]]/global/data_snapshot.json` |
-| **Config / Infra** (Package.json...) | Tech Stack | `02_tech_stack.md` |
-
----
-
-## 3. Anti-Hallucination
-
-- Code is the downstream artifact of documentation.
-- Forbidden to guess business logic based on variable names without reading Spec.
-- When code is found inconsistent with documentation: do not arbitrarily fix either, must pause and report the inconsistency.
-
----
-
-## 4. Maintenance Hook
-
-- **Trigger**: When creating a new file or new module.
-- **Action**: Must automatically update `map.json` to establish mapping between code path and document path; only ask user when the mapping relationship is unclear.

package/dist/templates/zh/rules/01_workflow.md

@@ -1,94 +0,0 @@
----
-description: Command Dispatcher & Workflow Controller. Handles /archi.start, /archi.plan, and mode transitions between Discussion, Planning, and Implementation.
-globs: **/*
-applyTo: **/*
-alwaysApply: true
----
-
-# Workflow Dispatcher
-
-> **Role**: 模式切换器。默认保持"通用架构师"模式，仅检测到显式指令时加载特定协议。
-
-> ⛔ **STOP CHECK** — 每轮回复前自检，命中任一项须立即停止并说明原因:
-> | 违规行为 | 正确处理 |
-> |:---|:---|
-> | 收到 `/archi.*` 指令，却未读取协议文件就开始执行 | 停止 → 先读取协议文件 |
-> | 用户请求涉及行为变更，却直接改代码 | 停止 → 引导到对应命令 |
-> | 执行 Terminal Gate 命令前未确认工作目录（见 `04_cli_tools.md`） | 停止 → 先通过 Working Directory Gate |
-
-## 1. Explicit Command Routing
-
-**Trigger**: 用户输入以 `/archi.` 开头时，立即加载对应协议模板。
-
-| Command | Target Template | Action |
-|:---|:---|:---|
-| `/archi.start` | `[[__DOCS_DIR__]]/prompts/start.md` | Load CPO → Project Initiation |
-| `/archi.inherit` | `[[__DOCS_DIR__]]/prompts/inherit.md` | Load Legacy Analyst → Reverse Engineering |
-| `/archi.scope` | `[[__DOCS_DIR__]]/prompts/scope.md` | Load Strategist → Requirement Decomposition |
-| `/archi.plan` | `[[__DOCS_DIR__]]/prompts/plan.md` | Load Planner → Deep Interview |
-| `/archi.edit` | `[[__DOCS_DIR__]]/prompts/edit.md` | Load Editor → Spec Modification |
-| `/archi.revise` | `[[__DOCS_DIR__]]/prompts/revise.md` | Load Chief Architect → Global Revision |
-| `/archi.code` | `[[__DOCS_DIR__]]/prompts/code.md` | Load Developer → Coding & Auditing |
-| `/archi.audit` | `[[__DOCS_DIR__]]/prompts/audit.md` | Load Chief Auditor → Deep Code Audit |
-| `/archi.fix` | `[[__DOCS_DIR__]]/prompts/fix.md` | Load Debugger → Diagnosis |
-| `/archi.map` | `[[__DOCS_DIR__]]/prompts/map.md` | Load Surveyor → Map Refresh |
-| `/archi.remove` | `[[__DOCS_DIR__]]/prompts/remove.md` | Load Surgeon → Task Decommission |
-| `/archi.help` | `[[__DOCS_DIR__]]/prompts/help.md` | Load Manual → Display Guide |
-
-> **Protocol Load Gate** (禁跳过，三步须按序完成):
-> 1. **Read** 目标 `.md` 全文 → 文件不存在时停止，输出: `协议文件未找到，中止执行`
-> 2. **Override** — 可覆盖: `<system_role>`, `<thinking_process>`, `<communication_style>`。
->    不可覆盖: `<core_philosophy>`, `<critical_protocols>`, `<architecture_governance>`。
-> 3. **Execute** `<step_1>` — 禁在步骤 1 完成前执行任何协议内容
-
----
-
-## 2. Natural Language Passthrough
-
-**Trigger**: 用户输入非 `/archi.` 指令文本。
-
-### 2.1 Intent Detection
-
-**Role**: 智能调度员。检测用户意图，按影响级别决定直接执行或引导到命令。
-
-**判定标准**: 该修改是否影响已文档化的行为（spec.md 的接口/逻辑/场景、ui.md 的交互/结构、plan.json 的实施步骤）？
-
-| 意图类型 | 处理 |
-|:---|:---|
-| 纯对话 / 代码阅读 / 架构讨论 | ✅ 直接回答，利用基底规则增强 |
-| 琐碎修改（typo/注释/格式/日志） | ✅ 直接执行 |
-| 行为变更（逻辑/接口/类型/UI） | 🔀 引导 → `/archi.edit` + `/archi.code` |
-| Bug 修复 | 🔀 引导 → `/archi.fix` |
-| 新增功能 | 🔀 引导 → `/archi.scope` 或 `/archi.plan` |
-| 大规模重构 | 🔀 引导 → `/archi.revise` |
-
-### 2.2 Guided Dispatch (引导规范)
-
-🔀 引导时须:
-1. 一句话说明为什么需走命令（关联到哪个文档会受影响）
-2. 推荐具体命令 + 参数
-3. 询问用户是否开始
-
-> ⛔ **禁**: 先改代码再事后建议走命令。违反此规则须撤销变更并重新引导。
-
-### 2.3 未纳管代码
-
-修改对象未在 `map.json` 中注册、无对应 Task:
-- **STOP & ASK** — 告知用户该模块未纳管
-- 建议 `/archi.inherit` 或 `/archi.scope` 纳入管理
-- 禁直接修改未纳管代码，须等待用户提供文档路径或完成纳管后再操作
-
-### 2.4 基底规则
-
-所有场景（含引导和纯对话）均依赖以下基底规则:
-
-| Layer | File | Role |
-|:---|:---|:---|
-| Core | `00_system.md` | 身份设定，核心原则 |
-| Tech | `02_tech_stack.md` | 技术红线，编码规范 |
-| Custom | `90_custom_rules.md` | 团队特殊约束 |
-| Context | `99_context_glue.md` | 自动关联上下文文档 |
-
-**End of Dispatcher.**
-
-> CLI 强制执行规则见 `04_cli_tools.md`。

package/dist/templates/zh/rules/03_data_governance.md

@@ -1,133 +0,0 @@
----
-description: JSON 数据文件的 AI 协作治理规则。定义全局数据文件的读写规范、更新时机与格式约束。
-globs: "**/*.json"
-applyTo: "**/*.json"
-alwaysApply: true
----
-
-# Data Governance Protocol
-
-> **Role**: 数据管家。确保全局 JSON 数据文件的一致性、完整性与可追溯性。
-
-## 1. 数据文件清单
-
-| 文件 | 类型 | 读取时机 | 写入时机 |
-|:---|:---|:---|:---|
-| `roadmap.json` | 路线图 | `/archi.plan`, `/archi.code` 开始时 | `/archi.start` 创建; AI 直接编辑或 `npx archi task` 更新状态 |
-| `map.json` | 架构地图 | 触碰代码时 (via context_glue) | `/archi.plan` Step 3 (全局同步); `/archi.inherit` Step 3.6; `/archi.map` |
-| `dictionary.json` | 术语字典 | 生成变量名/命名时 | `/archi.plan` Step 3; code/fix 后 step_5 自动追加 |
-| `design_tokens.json` | 设计令牌（仅ui项目） | 生成 UI 代码时 | `/archi.start` 创建; 设计变更时更新 |
-| `data_snapshot.json` | 数据快照（仅data项目） | `/archi.plan` Q1 设计; `/archi.code` 实现时 | Plan 阶段设计 Schema; Code 阶段同步实际变更 |
-| `error_codes.json` | 业务错误码 | 编写错误处理时 | `/archi.plan` Step 3; code/fix 后 step_5 自动追加 |
-| `api_snapshot.json` | API 端点（仅api项目） | 实现/对接 HTTP 端点时 | `/archi.plan` Step 3 注册端点; Code 阶段同步实际路径 |
-| `env_registry.json` | 环境变量（仅api项目） | 引入新配置项时 | Code 阶段引入新 env var 后立即追加 |
-| `command_api.json` | 命令签名（仅cli项目） | 实现/修改 CLI 命令时 | `/archi.plan` Step 3 注册命令; Code 阶段同步实际签名 |
-| `public_api.json` | 公共导出（仅lib项目） | 新增/修改导出 API 时 | `/archi.plan` Step 3 注册导出; Code 阶段同步实际签名 |
-
----
-
-## 2. 通用规则
-
-### 2.1 格式约束
-
-- **JSON Only**: 全局数据的唯一真理源是 `.json` 文件。`.md` 视图由 `npx archi render` 自动生成，禁直接编辑 `.md` 视图。
-- **Schema Stability**: 分两档管理：
-  - **Tier 1 (严格)**: `roadmap.json`, `plan.json` — CLI 渲染/命令直接依赖，结构由 Zod Schema 校验，禁随意变更字段。
-  - **Tier 2 (宽松)**: `dictionary.json`, `error_codes.json`, `data_snapshot.json`, `design_tokens.json`, `map.json`, `api_snapshot.json`, `env_registry.json`, `command_api.json`, `public_api.json` — 仅校验顶层 key 存在。若现有字段无法充分描述需记录的内容，可自行扩展字段（添加新 key 或在数组 item 中添加新属性），无需修改 CLI。
-- **Valid JSON**: 写入后须保证合法 JSON (无尾逗号、无注释)。
-
-### 2.2 读写纪律
-
-| 场景 | 规则 |
-|:---|:---|
-| 需要查阅数据 | 读取 `.json` 文件，禁读 `.md` 视图 (可能过期) |
-| 需要更新 Roadmap 任务状态 | 优先使用 `npx archi task <ID> --status <s>`; 批量更新时可直接编辑 JSON |
-| 需要更新其他数据文件 | AI 直接编辑 `.json` 文件 |
-| 更新后 | 运行 `npx archi render` 重新生成 `.md` 视图 |
-
----
-
-## 3. 文件专项规则
-
-### `roadmap.json`
-
-- **结构**: `phases[] → tasks[]`，每个 task 须有 `id`, `title`, `status`, `deps`。
-- **Status 值**: `pending` | `active` | `done` | `blocked`。
-- **依赖完整性**: `deps` 中引用的 ID 须存在于 tasks 中。
-- **Slug 规则**: `slug` 用于 tasks 文件夹命名，格式为 `Snake_Case`。
-
-### `map.json`
-
-- **Directory Mapping**: 须反映真实物理文件树。
-- **Logical Topology**: 须注册每个 Task Module 的职责。
-- **Feature Relations**（字段 `featureRelations`）: 记录聚合型 Task 与其来源的联动关系。每条结构为 `{ aggregator, sources, evidence, checkNote }`；由 AI 在 `/archi.plan`（规划聚合型 Task 时）或 `/archi.inherit`（逆向扫描时）写入，无需用户手动维护。
-- **自我校正**: 若代码引用违反拓扑定义的层级关系，须报错并停止生成。
-- **可扩展**: 若现有字段不足以描述项目架构，可在 item 中自行添加字段（如 `tags`、`owner`），或添加新顶层 key。
-
-### `dictionary.json`
-
-- **命名权威**: 本文件是命名的最高法律。
-- **Boundary**: 仅注册**项目业务域**内容。Architext 框架自身概念（scripts、scaffold、roadmap、plan 等）禁注册。
-- **entities**: 生成变量名前须查阅 `entities[].codeName`；禁使用 `forbiddenSynonyms` 中的词。
-- **verbs**: 业务动作命名须查阅 `verbs[].codeName`，保持全项目动词一致。
-- **utilities**: 封装的共享工具（如 logger、AppError、fetchClient）须注册；AI 须用已注册工具替代原始 API（参照 `replaces` 字段）。
-- **components** （仅ui项目）: 创建新组件前须搜索现有组件，优先复用。
-- **可扩展**: 若现有字段不足以描述某个术语/工具，可在对应数组 item 中自行添加字段（如 `tags`、`scope`、`deprecated`），也可添加新顶层数组（如 `enums`、`constants`）。
-
-### `design_tokens.json` （仅ui项目）
-
-- **Token Only**: 样式严格使用 Token；禁硬编码 Hex/px/rem。
-- **Dark Mode**: 须同时定义 `light` 和 `dark` 值。
-- **可扩展**: 若现有 Token 结构不足以覆盖项目需求（如 `motion`、`breakpoints`、`z-index`），可自行添加新属性。
-
-### `data_snapshot.json` （仅data项目）
-
-- **结构**: `models[]`（名称、字段、类型、约束）+ `relationships[]`（模型间关系：1:1/1:N/M:N/self-ref）。
-- **Design First**: Plan 阶段须定义模型结构和字段类型，禁写 "TBD"，须精确到字段名与类型。
-- **Sync Back**: Code 阶段完成后，须将实际变更同步回此文件。
-- **可扩展**: 若现有字段不足以描述数据模型（如需记录 `indexes`、`triggers`、`seedData`），可在 model item 或顶层自行添加字段。
-
-### `error_codes.json`
-
-- **Boundary**: 仅注册**项目业务域**错误。框架基础设施（scripts/validate、dev-up、dev-reset 等）的错误由脚本自身 exit code + stderr 处理，禁注册到此文件。
-- **结构**: `businessErrors`（业务错误注册表）。HTTP 协议状态码映射见 `api_snapshot.json`。
-- **Code Format**: `ERR_[MODULE]_[REASON]` (如 `ERR_AUTH_INVALID_TOKEN`)。
-- **statusCode**: 按项目类型填写（HTTP status / Exit code / 留空）。
-- **Design Before Code**: 编写错误处理代码前须先在此注册错误码，含 `message` 和 `recovery`。
-- **可扩展**: 若现有字段不足以描述错误信息（如需记录 `severity`、`retryable`），可在 item 中自行添加字段。
-
-### `api_snapshot.json` （仅api项目）
-
-- **结构**: `endpoints[]`（端点注册表）+ `protocolMapping[]`（HTTP 状态码→调用方行为映射）。
-- **Register First**: 规划端点前须先在此注册，禁实现未登记的端点。
-- **owner**: 每个端点须标注归属 Task ID，便于追踪变更来源。
-- **可扩展**: 可在 endpoint item 中追加 `tags`、`deprecated`、`version` 等字段。
-
-### `env_registry.json` （仅api项目）
-
-- **Register on Introduce**: 代码中每引入一个新的 `process.env.X` 或等价配置读取，须立即在此追加记录。
-- **required**: 必填项标 `true`；有合理默认值的标 `false` 并填写 `default`。
-- **example**: 须提供示例值，禁留空（帮助新成员快速配置环境）。
-- **可扩展**: 可追加 `sensitive`（是否为密钥）、`validValues`（枚举约束）等字段。
-
-### `command_api.json` （仅cli项目）
-
-- **Register on Introduce**: 每新增或修改 CLI 命令后同步更新此文件。
-- **owner**: 每条命令须标注归属 Task ID。
-- **可扩展**: 可追加 `examples`、`deprecated`、`since` 等字段。
-
-### `public_api.json` （仅lib项目）
-
-- **Stability First**: 导出 API 一旦标注 `stable`，变更须走 `/archi.edit` 流程，不可随意修改签名。
-- **signature**: 须写完整 TypeScript 签名，禁模糊描述（如"返回用户对象"）。
-- **owner**: 每条导出须标注归属 Task ID。
-- **可扩展**: 可追加 `since`、`examples`、`seeAlso` 等字段。
-
----
-
-## 4. Plan JSON (`plan.json`)
-
-- **位置**: `tasks/<ID>_<Slug>/plan.json`
-- **Checkbox 更新**: AI 在 `/archi.code` 中完成步骤后直接将 `done` 设为 `true`。
-- **追加规则**: `/archi.edit` 追加新 Phase 时保留已完成历史。
-- **验证**: 完成后运行 `npx archi plan <ID>` 验证完成度。

package/dist/templates/zh/rules/99_context_glue.md

@@ -1,53 +0,0 @@
----
-description: Context Navigation & Document Indexing. Bridges source code to documentation using the Map registry. Essential for locating specs and plans.
-globs: **/*
-applyTo: **/*
-alwaysApply: true
----
-
-# Context Glue Protocol
-
-> **Role**: 上下文导航仪。防止 AI 失忆，通过查阅地图 (Map Look-up) 确定代码对应的业务文档。
-
-## 1. Context Discovery
-
-读取或编辑代码文件时，须执行以下寻址步骤:
-
-**Step 1: Check Global Map**
-- 读取 `[[__DOCS_DIR__]]/global/map.json`。
-- 在 `directoryMapping` / `logicalTopology` 中查找当前文件所属模块。
-- 加载该模块注册的 Docs Link (Spec/UI/Plan)。
-
-**Step 2: Check Explicit Context**
-- 场景: 新创建的文件或 Map 尚未更新。
-- 检查用户 Prompt 中是否显式指定了文档路径，如有则须加载。
-
-**Step 3: Fallback**
-- Map 中未注册且用户未指定 → **STOP & ASK**。
-- 提示: "未找到当前代码对应的 Spec 文档。请告知路径，或运行 `/archi.map` 更新架构地图。"
-
----
-
-## 2. Mandatory Loading Rules
-
-| 代码类型 | 必读上下文 | 真理来源 |
-|:---|:---|:---|
-| **Business Logic** (Tasks/Entities) | Spec Document | `[[__DOCS_DIR__]]/global/map.json` → Module Entry |
-| **UI Components** (Pages/Widgets)（仅ui项目） | UI Document + `[[__DOCS_DIR__]]/global/design_tokens.json` | `[[__DOCS_DIR__]]/global/map.json` + Global Rules |
-| **Data Schema** (ORM/SQL/Models)（仅data项目） | Data Snapshot | `[[__DOCS_DIR__]]/global/data_snapshot.json` |
-| **Config / Infra** (Package.json...) | Tech Stack | `02_tech_stack.md` |
-
----
-
-## 3. Anti-Hallucination
-
-- 代码是文档的下游产物。
-- 禁在未读取 Spec 的情况下凭变量名猜测业务逻辑。
-- 发现代码与文档不符时: 不擅自修复文档或代码，须暂停并报告不一致性。
-
----
-
-## 4. Maintenance Hook
-
-- **Trigger**: 创建新文件或新模块时。
-- **Action**: 须自动更新 `map.json`，建立代码路径与文档路径的映射；映射关系不明确时才询问用户确认。