architext 0.0.3 → 0.0.5

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

@@ -1,93 +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** `00_system` 部分設定
-> 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:
-- 告知使用者該模組未納管
-- 建議 `/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-Hant/rules/02_tech_stack.md

@@ -1,192 +0,0 @@
----
-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.
-> **Status:** [Active]
-> **Note:** 這是一個模板檔案，需要根據專案類型（Web/CLI/Backend/Library/Mobile 等）填充具體內容。
-> 某些章節（如 UI Protocol）僅適用於有 UI 的專案，應根據實際情況調整或刪除。
-
-## 1. Global Mandates (全局紅線)
-* **No Hardcoding:** 所有的密鑰、API地址必須使用環境變數，嚴禁硬編碼。
-* **No Dead Code:** 提交的程式碼必須是乾淨的，嚴禁保留註釋掉的程式碼塊或無用的 `TODO`。
-* **Comments for Why:** 註釋解釋「為什麼這麼做」（業務背景），而不僅僅是「做了什麼」。
-
----
-
-## 2. Technology Selection (技術選型)
-### Core Stack
-* **Framework:** [例如：Next.js 14 (App Router) / NestJS / Express / FastAPI / Gin]
-* **Language:** [例如：TypeScript (Strict Mode) / Python 3.11+ / Rust / Go 1.21+]
-* **Styling** (如專案有 UI): [例如：TailwindCSS + Shadcn/UI / CSS Modules / Styled Components]
-* **State** (如專案有前端狀態管理): [例如：Zustand (Client) + React Query (Server) / Redux / MobX]
-* **Database** (如專案有數據層): [例如：PostgreSQL + Prisma ORM / MongoDB / SQLite / Redis]
-
-### Infrastructure
-* **Package Manager:** [例如：pnpm / npm / yarn / cargo / go mod / pip]
-* **Runtime:** [例如：Node.js 20+ / Python 3.11+ / Rust / Go 1.21+ / Bun]
-* **Build Tool:** [例如：tsup / vite / webpack / cargo / go build]
-
----
-
-## 3. Coding & Naming Standards (程式碼與命名規範)
-### Naming Conventions
-* **Files:** [例如：`kebab-case` (e.g., `user-profile.ts` / `user_profile.py` / `user_profile.rs`)]
-* **Components/Classes:** [例如：`PascalCase` (e.g., `UserProfile` / `UserService` / `UserRepository`)]
-* **Functions/Methods:** [例如：`camelCase` (e.g., `handleSubmit`) 或 `snake_case` (Python/Rust)]
-* **Constants:** [例如：`UPPER_SNAKE_CASE` (e.g., `MAX_RETRY` / `MAX_RETRY_COUNT`)]
-* **Private Members:** [例如：`_privateMethod` (JavaScript) / `__private` (Python) / `private_field` (Rust)]
-
-### Code Patterns
-* **Export Style:** [例如：必須使用 Named Export (`export const`), 嚴禁使用 Default Export。]
-* **Type Definitions:** [例如：必須使用 `interface` 定義物件，使用 `type` 定義聯合類型。]
-* **Error Handling:** [例如：必須使用 Result 類型 (Rust) / 異常處理 (Python/Java) / 錯誤返回 (Go)]
-* **Async Patterns:** [例如：優先使用 Async/Await，避免 `.then()` 鏈式調用。]
-
----
-
-## 4. UI Protocol: ITP v3.0 (Dual-Artifact) [可選 - 僅適用於有 UI 的專案]
-<!-- 核心 UI 描述協議 -->
-> **Note:** 如果專案沒有 UI（如 CLI、Backend API、Library），可以刪除此章節。
-
-### 4.1 Dual-Artifact Strategy (雙製品策略)
-
-UI 製品層級：
-
-| 製品 | 格式 | 讀者 | 職責 |
-|:---|:---|:---|:---|
-| `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` 為**唯讀視覺參考**校準布局，用**專案自身技術棧**實現等價視覺效果
-
-### 4.2 Naming (PrefixFunction)
-元件命名須遵循 `前綴+功能` 格式：
-* **Btn**: Button | **Inp**: Input | **Txt**: Text/Label
-* **Box**: Container | **Img**: Image/Icon | **List/Card/Modal**: As named.
-
-### 4.3 Syntax Structure (語法結構)
-* **Definition**: `Name [Layout] (Style/Content) -> #Interaction`
-* **Layout Keywords**: `[Row]`, `[Col]`, `[Center]`, `[Between]`, `[Fill]`, `[Grid]`
-* **Example**:
-```
-    BoxHeader [Row, Between]
-      TxtTitle [H2] (Text: "Login")
-      BtnClose [Ghost] (Icon: X) -> #CloseModal
-```
-
-### 4.4 Design Tokens (設計令牌)
-`design_tokens.json` 定義專案專屬視覺語言，由 `/archi.start` 從 Brief 生成：
-- `primitivePalette`: 原始色階（中性灰 + 品牌色）
-- `semanticTokens`: 語義色（Background/Primary/Text…）+ 字體規格
-- `layout`: 圓角/陰影/間距尺寸
-- `motion`: 動效時長/緩動/模式偏好
-- `illustration`: 圖示風格/圖示庫
-- **code 階段**: 所有顏色/尺寸/動效值須來自此檔案對應欄位，禁硬編碼魔法值
-
-### 4.5 Delta Syntax (差分更新)
-* **Usage**: 用於修改現有 UI 快照。
-* **Format**: `@Locator { + Add, ~ Modify, - Remove }`
-
----
-
-## 5. Testing & Verification (測試與驗證)
-
-### Static Analysis (靜態分析命令)
-* **Build:** [例如：`pnpm build` / `cargo build` / `go build` / `python -m py_compile`]
-* **Type Check:** [例如：`pnpm type-check` / `mypy .` / N/A]
-* **Lint:** [例如：`pnpm lint` / `ruff check .` / `cargo clippy` / `golangci-lint run`]
-* **Format:** [例如：`pnpm format:check` / `ruff format --check` / `cargo fmt --check`]
-
-### Test Suite (測試套件)
-* **Unit:** Tool: [例如：Vitest / Jest / pytest / cargo test / go test]  Scope: [例如：Utils 工具函數、核心業務邏輯、算法]  Rule: [例如：須 Mock 外部依賴；禁對易變 UI 做快照測試]
-* **Integration:** Tool: [例如：Vitest + Testcontainers / pytest + Docker]  Scope: [例如：API→DB 寫入鏈路 / CLI 完整執行流程]
-* **E2E:** Tool: [例如：[?Web] Playwright / Cypress  [?API] Supertest / httpie  [?CLI] bats / shell script  [?Lib] 範例專案 + 自動化腳本  [?Mobile] Detox / Maestro]  Scope: [例如：[?Web] 核心使用者路徑  [?API] 關鍵 endpoint 全鏈路  [?CLI] 關鍵命令全流程  [?Lib] 公開 API 典型使用場景]
-* **Test Command:** [例如：`pnpm test` / `pytest` / `cargo test` / `go test ./...`]
-
-### Environment Scripts (環境腳本)
-> **AI Internal Tooling**: 此腳本由 AI 在 INF-01 階段基於上方命令定義自動生成，實現細節（腳本結構、失敗策略、執行方式）由 AI 自決，禁向使用者提問。按 OS 生成 `.sh` / `.ps1` 至 `[[__DOCS_DIR__]]/scripts/`。
-
-* **`[[__DOCS_DIR__]]/scripts/validate`** — 自動化質檢（AI 每次改完程式碼後執行）：Static Analysis 全項 + Test Command。
-* **`[[__DOCS_DIR__]]/scripts/dev-up`** — 拉起開發環境：Install → Build → Start Dev Server → Health Check。
-  - **Install:** [例如：`pnpm install` / `pip install -r requirements.txt` / `cargo build` / `go mod download`]
-  - **Dev Command:** [例如：`npm run dev` / `python manage.py runserver` / `cargo run` / N/A]
-  - **Health Check:** [例如：`curl http://localhost:3000/api/health` / `./bin/cli --version` / `python -c "import mylib"`]
-* **`[[__DOCS_DIR__]]/scripts/dev-reset`** — 環境重置（環境異常時執行）：Kill Processes → Clean Cache → Reinstall → Rebuild → Restart。
-
----
-
-## 6. Deployment & Release (部署與發佈)
-### CI Pipeline (流水線)
-* **Pre-commit:** [例如：必須通過 Linter 和 Formatter 檢查（ESLint/Prettier / ruff/black / clippy / golangci-lint）。]
-* **Merge Gate:** [例如：PR 合併前必須通過所有 Unit/Integration 測試。]
-* **Build Check:** [例如：必須通過構建檢查（`npm run build` / `cargo build` / `go build`）。]
-
-### Environment (環境)
-* **Secrets:** [例如：生產環境密鑰必須通過 CI 平台配置，嚴禁提交 `.env` / `.env.local`。]
-* **Database Ops** (如專案有數據庫): [例如：Schema 變更必須使用 Migration 檔案，禁止手動修改生產庫。]
-* **Binary Distribution** (如專案是 CLI/Library): [例如：使用 GitHub Releases 發佈二進位檔案，支持多平台構建。]
-
----
-
-## 7. Architecture & File Placement Strategy (架構與檔案歸位策略)
-### Repository Architecture (倉庫形態)
-* **Strategy:** [例如：Monorepo (Turborepo) 或 Single Repo (單體倉庫)]
-* **Workspace:** [例如：pnpm workspaces，共享依賴提升至 Root。]
-
-### Directory Structure (目錄結構)
-* **Pattern:** [Architecture Pattern Name]
-* **Philosophy**: [Architecture Philosophy]
-* **Key Paths**:
-    * `[Path_1]`: [Description]
-    * `[Path_2]`: [Description]
-* **Constraint**: [Architecture Constraints]
-
-### File Placement Rules (檔案歸位邏輯)
-> *Context*: 定義不同類型的檔案應創建在哪裡。**須依據專案類型 (Web/CLI/API/Lib) 與 `map.json` 的目錄結構自訂**，下表為佔位示例。
-> **Critical**: 建立新檔案前須查此表。此表填充後即為強制約束，禁憑 AI 預設習慣自行放置。
-
-| File Type | Placement Strategy | Example (依據專案調整) |
-| :--- | :--- | :--- |
-| **Unit Tests** | [e.g. Centralized 或 Colocation] | `__tests__/utils/date.test.ts` / `utils/date.test.ts` |
-| **Interfaces/Types** | [e.g. Near usage 或 Global types] | `types/user.d.ts` / `domain/user.entity.ts` |
-| **Assets/Images** [?UI] | [e.g. Public 或 Module assets] | `public/images` / `assets/` |
-| **Styles** [?UI] | [e.g. 按元件或全域] | `Button.module.css` / `global.css` |
-| **DTOs/Models** [?Data] | [e.g. Domain 或 Shared] | `domain/user/dto` / `models/` |
-
----
-
-## 8. Anti-Patterns (負面清單)
-* **No Orphan .gitkeep:** 空目錄可用 `.gitkeep` 占位以便 Git 追蹤；目錄已有其他檔案時須刪除 `.gitkeep`。
-* **No Rogue File Placement:** 建立新檔案前須查 §7 File Placement Rules 表，禁憑 AI 訓練資料的預設習慣自行放置（尤其是測試檔案）。
-* **No [技術 1]:** [例如：No Redux - 本專案過重，勿用。]
-* **No [技術 2]:** [例如：No Raw SQL - 必須使用 ORM 防止注入。]
-* **No [模式 1]:** [例如：禁止在組件內部直接 fetch 數據，必須封裝在 Service 層。]
-* **No [模式 2]:** [例如：禁止使用 `any` 類型（TypeScript）/ 禁止使用 `unsafe` 程式碼（Rust）。]
-* **No [模式 3]:** [例如：禁止使用 `console.log` 生產程式碼，必須使用統一的 Logger。]
-
----
-
-## 9. Project Conventions (專案約定)
-> 全域架構約定，由 `/archi.start` 確立。`/archi.plan` 自動繼承，任務無特殊需求時不再逐一提問。
-> 任務若需偏離約定，須在提案中明確說明偏離理由。
-
-### Error Handling (錯誤處理策略)
-* **Strategy:** [例如：Fail Fast + Form Validation / Fail Fast (stderr) / Schema Validation + Fail Fast]
-* **Rationale:** [例如：表單密集型應用，需前端即時校驗 + 後端快速失敗]
-
-### Data Flow (資料流模式) [?UI]
-* **Default:** [例如：Standard Request + SWR / Realtime (Socket) / Polling]
-* **Rationale:** [例如：大部分頁面為 CRUD 讀寫，SWR 做快取和重新驗證]
-
-### Auth & Access (認證與權限) [?Web/API]
-* **Mechanism:** [例如：JWT + RBAC / Session + Owner Only / API Key]
-* **Rationale:** [例如：多角色後台管理系統，需細粒度權限控制]

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

@@ -1,102 +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 自動追加 |
-
----
-
-## 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` — 僅校驗頂層 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 處理，禁註冊到此檔案。
-- **結構**: `protocolMapping [?API]`（狀態碼→行為映射）+ `businessErrors`（業務錯誤註冊表）。
-- **Code Format**: `ERR_[MODULE]_[REASON]` (如 `ERR_AUTH_INVALID_TOKEN`)。
-- **statusCode**: 按專案型別填寫（HTTP status / Exit code / 留空）。
-- **Design Before Code**: 撰寫錯誤處理程式碼前須先在此註冊錯誤碼，含 `message` 和 `recovery`。
-- **可擴展**: 若現有欄位不足以描述錯誤資訊（如需記錄 `severity`、`retryable`、`httpBody`），可在 item 中自行新增欄位。
-
----
-
-## 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-Hant/rules/04_cli_tools.md

@@ -1,50 +0,0 @@
----
-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 執行時查閱。
-
-## ⛔ Working Directory Gate
-
-**執行任何 `npx archi` 命令前須通過此檢查，否則停止**:
-
-| 檢查項 | 通過條件 |
-|:---|:---|
-| 當前目錄 | 須為專案根目錄（`[[__DOCS_DIR__]]/` 所在目錄） |
-| 不確定時 | 先確認當前目錄，禁猜測 |
-| 子目錄中 | 須 `cd` 到根目錄後再執行 |
-
----
-
-## 命令語法
-
-### `npx archi task`
-
-| 子命令 | 用途 | 範例 |
-|:---|:---|:---|
-| `npx archi task` | 列出所有任務及進度 | `npx archi task` |
-| `npx archi task <ID> --status <s>` | 更新任務狀態 | `npx archi task INF-001 --status done` |
-| `npx archi task --check` | 檢查 Roadmap 一致性 | `npx archi task --check` |
-
-**合法狀態值**: `pending` / `active` / `done` / `blocked`
-
-### `npx archi plan`
-
-| 子命令 | 用途 | 範例 |
-|:---|:---|:---|
-| `npx archi plan <ID>` | 檢查 Task 的 Plan 完成度 | `npx archi plan SUB-01` |
-
-自動識別 Manual Verification 區域並排除在自動化統計外。
-
-### `npx archi render`
-
-| 子命令 | 用途 | 範例 |
-|:---|:---|:---|
-| `npx archi render` | 將所有 JSON 資料檔案渲染為人類可讀的 `.md` 視圖 | `npx archi render` |
-
-> `.md` 視圖是自動產生的，禁直接編輯。修改須透過 `.json` 來源檔案進行。

package/dist/templates/zh-Hant/rules/90_custom_rules.md

@@ -1,21 +0,0 @@
----
-description: Project Specific Rules & Constraints. High-priority user overrides, team preferences, and business-specific invariants that supersede general defaults.
-globs: **/*
-applyTo: **/*
-alwaysApply: true
----
-
-# Custom Project Rules (用戶自定義規則)
-
-> **Priority:** [High]
-> **Role:** 本專案的「特殊家規」。當通用的 `02_tech_stack` 無法覆蓋某些細節，或有特殊業務約束時，以此文件為準。
-
-## 1. Team Conventions (團隊習慣)
-
-
-## 2. Business Constraints (業務硬約束)
-
-
-## 3. Specific Anti-Patterns (本專案黑名單)
-
-## 4. ...

package/dist/templates/zh-Hant/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`，建立程式碼路徑與文件路徑的映射；映射關係不明確時才詢問使用者確認。