architext 0.0.3 → 0.0.5

package/dist/templates/zh-Hant/briefs/_base.md

@@ -1,115 +0,0 @@
-# Project Brief: [專案名稱]
-
-> 盡量填寫，不確定的留空即可。完成後執行 `/archi.start project-brief.md`，AI 會透過選擇題補全缺失資訊。
-
----
-
-## 專案概述
-
-**專案名稱**: 
-**一句話描述**: [專案是什麼、為誰服務、解決什麼問題]
-**問題陳述**: [目標用戶遇到的核心痛點？現有方案哪裡不足？]
-
-**目標用戶**:
-- **核心用戶**: [角色/群體]
-- **關鍵特徵**: [技術水平、使用場景、行為習慣]
-
-**成功指標**: [怎樣算做成了？例：DAU 1000 / 被 100+ 專案採用 / P99 < 200ms]
-
----
-
-## 核心任務
-
-> MVP 必須實現的任務（建議 3-7 個），每項一句話描述預期行為。
-> 詳細 Spec 在 `/archi.plan` 階段定義，此處只需明確「做什麼」。
-
-1. 
-2. 
-3. 
-
----
-
-## 已有設計決策
-
-> 如果你對某些任務/頁面/流程已有明確想法，在此描述。AI 在後續 plan 階段會以此為準，不會推翻。
-> 沒有的話留空即可。
->
-> 寫法參考：
-> - **[任務/頁面名]**: 描述具體行為、流程、約束
-> - 可附截圖/草圖連結
-
----
-
-## 技術棧
-
-> 已確定的直接填寫。不確定的留空或寫「推薦」，AI 會基於專案特徵推薦。
-
-**專案類型**: [[__PROJECT_TYPE__]]
-<!-- archi init 自動填入；手動填寫時參考 templates/archi-decompose-roadmap SKILL 中的型別表 -->
-**語言/執行時**: [例：TypeScript + Node.js 22]
-**核心框架**: [例：Next.js 15 / Fastify / Tauri]
-**套件管理器**: [例：pnpm / npm / yarn / cargo]
-**建置工具**: [例：Vite / tsup / Webpack / esbuild / cargo / go build]
-**Linter / Formatter**: [例：ESLint + Prettier / Biome / ruff / clippy + rustfmt]
-<!-- @slot:tech -->
-**部署目標**: [例：Vercel / Docker / npm publish / 二進位分發]
-**關鍵第三方函式庫**: [例：Zod, TanStack Query, Lucia Auth]
-
-**技術紅線** (禁用的技術/方案):
-- [例：不用 jQuery；不用 CSS-in-JS]
-
----
-
-## 工程規範
-
-> 團隊已有的工程約定。不確定的留空，AI 會基於技術棧推薦合理預設值。
-
-**倉庫形態**: [Monorepo (Turborepo/Nx/pnpm workspaces) / 單體倉庫]
-**架構模式**: [例：MFA / FSD / Clean Architecture / 分層架構 / 無偏好（AI 推薦）]
-**目錄結構**: [已有明確結構 → 簡述關鍵目錄 / 無（AI 基於架構模式生成）]
-**分支策略**: [例：Trunk-based / Git Flow / GitHub Flow]
-**Commit 規範**: [例：Conventional Commits (feat/fix/chore) / 自訂 → 簡述]
-**測試偏好**: [例：Vitest / Jest / pytest / 無特殊要求]
-
----
-
-## 已有資源與上下文
-
-> AI 需要知道哪些東西已經存在——避免重複造輪子或做出衝突決策。
-
-**專案起點**: [全新專案 / 基於已有程式碼庫（簡述現狀和技術債）]
-**設計資產**: [Figma 連結 / 設計稿截圖 / 無（AI 自行設計）]
-**品牌規範**: [已有 Logo/配色/字體 → 描述或附連結 / 無]
-**已有 API/後端**: [介面文檔連結 / 簡述可用端點 / 無（需從零搭建）]
-**第三方服務**: [已確定使用的服務，例：Auth0, Stripe, AWS S3, Resend...]
-**現有資料**: [已有資料庫/資料源？格式？需要遷移？/ 無]
-
----
-
-<!-- @slot:style -->
-
-## 邊界與約束
-
-**明確不做的事** (反目標):
-- [例：本期不做國際化 / 不做行動端適配 / 不做付費功能]
-
-**硬性約束**:
-- **時間**: [例：4 周 MVP / 無硬性 deadline]
-- **相容性**: [例：Chrome 90+ / Node 18+ / iOS 15+]
-- **效能**: [例：首屏 < 2s / API P99 < 500ms / 無特殊要求]
-- **合規/無障礙**: [例：WCAG 2.1 AA / GDPR / 無]
-
----
-
-## 參考與靈感
-
-| 參考專案 | 參考維度 |
-|:---|:---|
-| [例：Linear] | [互動體驗、任務管理邏輯] |
-| | |
-
----
-
-## 補充說明
-
-> 任何上述未涵蓋的資訊：背景故事、特殊需求、已有決策的原因、團隊技術偏好等。

package/dist/templates/zh-Hant/briefs/_modules.md

@@ -1,173 +0,0 @@
-<!-- @tech:ui -->
-**CSS/UI 方案**: [例：TailwindCSS + Shadcn/UI / Ant Design / 原生 CSS]
-<!-- @end -->
-
-<!-- @tech:data -->
-**資料庫**: [例：PostgreSQL / MongoDB / SQLite]
-**ORM / Query Builder**: [例：Prisma / Drizzle / TypeORM]
-<!-- @end -->
-
-<!-- @tech:api -->
-**API 風格**: [例：RESTful / GraphQL / gRPC / tRPC]
-<!-- @end -->
-
-<!-- @tech:cli -->
-**CLI 框架**: [例：cac / commander / clap (Rust) / cobra (Go)]
-**分發方式**: [例：npm publish / GitHub Releases / 二進位]
-<!-- @end -->
-
-<!-- @tech:lib -->
-**模組格式**: [例：ESM / CJS + ESM 雙出]
-**目標平台**: [例：瀏覽器 + Node.js / 僅 Node.js]
-**分發渠道**: [例：npm / PyPI / crates.io]
-<!-- @end -->
-
-<!-- @style:ui -->
-## 風格與調性
-
-**審美方向** (選一個最接近的，不確定就留空讓 AI 推薦):
-<!-- 選一個填入，或寫 custom 並在下方描述 -->
-<!-- saas-dark    — 類似 Linear/Vercel/Raycast：深色背景、高對比、極簡、銳利邊緣 -->
-<!-- saas-light   — 類似 Notion/Stripe/GitHub：白底、細邊框、系統字體、呼吸感 -->
-<!-- dashboard    — 類似 Grafana/Datadog：資訊密集、卡片網格、資料優先 -->
-<!-- marketing    — 類似 Loom/Framer：大標題、漸層、視覺衝擊、敘事感 -->
-<!-- mobile-app   — 類似 Telegram/Bear：圓角大、間距寬、觸控友善 -->
-<!-- editorial    — 類似 Medium/Substack：排版優先、襯線字體、閱讀沉浸 -->
-<!-- brutalist    — 類似 Craigslist/HN：功能極簡、無裝飾、原始感 -->
-<!-- custom       — 在「自訂描述」中寫你想要的風格 -->
-
-**審美方向**: [例：saas-dark / saas-light / dashboard / marketing / mobile-app / editorial / brutalist / custom]
-**自訂描述**: [僅 custom 時填寫，例：「類似 Spotify 的深色 + 綠色強調 + 卡片式布局」]
-
-**資訊密度**: [大留白/沉浸式 / 資訊密集/儀表板風格]
-**動效偏好**: [輕微微互動 / 豐富動畫 / 無動畫]
-
-### 視覺參考 (Visual Reference)
-
-> 為 AI 提供審美輸入，直接影響 `ui_concept.html` 的視覺品質。
-> 以下任填一項即有效，填得越多 AI 越能還原你的期望風格。
-
-**競品/靈感截圖**: [可貼上圖片 / Figma 連結 / URL]
-**品牌色板**: [主色 Hex / 漸層描述 / 無（AI 基於審美方向生成）]
-**字體偏好**: [例：JetBrains Mono + Space Grotesk / Playfair Display / 無偏好（AI 基於審美方向選擇）]
-**圖示庫**: [例：Lucide / Heroicons / Tabler / 無偏好]
-**禁用風格**: [例：禁漸層背景 / 禁卡通插畫 / 無限制]
-<!-- @end -->
-
-<!-- @style:cli -->
-## 風格與調性
-
-**輸出風格**: [簡潔單行 / 結構化彩色 / JSON 機器可讀]
-**互動模式**: [純參數驅動 / 互動式提示 / 混合]
-**錯誤展示**: [簡潔提示 / 詳細堆疊 / 分級(--verbose)]
-<!-- @end -->
-
-<!-- @style:api -->
-## 風格與調性
-
-**文檔方案**: [OpenAPI/Swagger / GraphQL Schema / 手寫文檔]
-**錯誤回應格式**: [RFC 7807 / 自訂 JSON / GraphQL errors]
-**版本策略**: [URL 路徑 /v1 / Header / 無版本控制]
-<!-- @end -->
-
-<!-- @tech:mobile -->
-**行動端執行時**: [例：React Native 0.76 / Flutter 3 / Expo SDK 52]
-**UI 元件庫**: [例：RN Paper / NativeWind / NativeBase / 原生元件]
-**導航方案**: [例：React Navigation 7 / Expo Router / Go Router]
-**原生能力**: [例：相機、推播通知、生物辨識——列出需要的]
-**發佈渠道**: [例：App Store + Play Store / Expo Go / TestFlight]
-**OTA 熱更新**: [例：Expo Updates / CodePush / 不需要]
-<!-- @end -->
-
-<!-- @tech:miniapp -->
-**小程式平台**: [例：微信 / 支付寶 / 抖音 / uni-app（多端）]
-**基礎庫版本**: [例：微信基礎庫 3.x / uni-app Vue3]
-**UI 元件庫**: [例：Vant Weapp / TDesign MiniProgram / 原生元件]
-**雲端開發**: [例：微信雲端開發 / 不使用]
-**發佈**: [例：微信公眾平台發佈 / 審核週期約定]
-<!-- @end -->
-
-<!-- @style:miniapp -->
-## 風格與調性
-
-**視覺規範**: [遵循平台設計規範（微信 Weui / 支付寶 / 抖音）/ 自訂品牌風]
-**色調傾向**: [品牌主色 / 跟隨平台預設 / 深色模式（需平台支援）]
-**元件風格**: [原生元件為主 / 自訂元件 / 混合]
-**動效偏好**: [系統預設頁面切換 / 自訂過渡 / 無特殊要求]
-<!-- @end -->
-
-<!-- @tech:desktop -->
-**桌面執行時**: [例：Tauri 2 / Electron 33]
-**IPC 通訊**: [例：Tauri invoke/command / Electron ipcMain+ipcRenderer]
-**系統級能力**: [例：系統匣、全域快速鍵、檔案關聯、剪貼簿——列出需要的]
-**打包發佈**: [例：tauri-bundler (.dmg/.msi/.deb) / electron-builder / GitHub Releases]
-**自動更新**: [例：tauri-updater / electron-updater / 不需要]
-<!-- @end -->
-
-<!-- @tech:extension -->
-**目標瀏覽器**: [例：Chrome + Edge / Firefox / 全平台]
-**Manifest 版本**: [V3（推薦）/ V2（Firefox 需相容）]
-**擴充功能結構**: [例：僅 Popup / Popup + Content Script / Background + Content Script + Popup]
-**權限宣告**: [例：storage、tabs、activeTab——列出需要的]
-**發佈渠道**: [例：Chrome Web Store / Firefox Add-ons / 私有分發]
-<!-- @end -->
-
-<!-- @tech:realtime -->
-**即時傳輸方案**: [例：Socket.io / 原生 WebSocket / SSE / WebRTC]
-**即時框架/託管**: [例：Ably / Pusher / Liveblocks / 自建]
-**房間/頻道模型**: [例：按使用者 ID 訂閱 / 按文件 ID 房間 / 廣播]
-**[?CRDT] 協作衝突解決**: [例：Yjs / Automerge / 不需要（僅廣播）]
-**離線支援**: [例：離線佇列 + 重連同步 / 不需要]
-<!-- @end -->
-
-<!-- @tech:ai -->
-**LLM 提供商**: [例：OpenAI GPT-4o / Anthropic Claude / Gemini / 本地 Ollama]
-**AI 框架**: [例：Vercel AI SDK / LangChain / LlamaIndex / 無框架直調 API]
-**Tool/Function Calling**: [例：需要（列出工具名稱）/ 不需要]
-**Memory 方案**: [例：向量資料庫（pgvector/Pinecone）/ 滑動視窗歷史 / 無]
-**[?MCP] MCP 協定**: [例：@modelcontextprotocol/sdk / 不需要]
-**串流輸出**: [例：SSE 串流 / 批量回傳]
-<!-- @end -->
-
-<!-- @style:mobile -->
-## 風格與調性
-
-**視覺關鍵字**: [例：原生感、輕量、沉浸式]
-**適配方案**: [例：響應式 dp/sp / 固定設計稿 375pt]
-**深色模式**: [跟隨系統 / 僅淺色 / 僅深色]
-**動效偏好**: [系統原生動效 / 自訂過渡 / 無特殊要求]
-**無障礙**: [例：VoiceOver / TalkBack 支援 / 無特殊要求]
-<!-- @end -->
-
-<!-- @style:desktop -->
-## 風格與調性
-
-**視覺風格**: [例：原生系統風（Fluent/HIG）/ 自訂品牌風]
-**視窗管理**: [例：單主視窗 + 系統匣 / 多視窗 / 全螢幕優先]
-**深色模式**: [跟隨系統 / 固定深色 / 固定淺色]
-**選單列/系統匣**: [例：選單列圖示 + 快速操作 / 僅系統匣圖示 / 不需要]
-<!-- @end -->
-
-<!-- @style:extension -->
-## 風格與調性
-
-**Popup 尺寸約定**: [例：320×480px / 400×600px / 自適應]
-**視覺風格**: [例：極簡卡片 / 與目標網站融合 / 獨立品牌]
-**Content Script 注入樣式**: [例：懸浮按鈕 / 側邊欄 / 高亮遮罩]
-<!-- @end -->
-
-<!-- @style:realtime -->
-## 風格與調性
-
-**協作感知 UI**: [例：即時游標、使用者頭像列表、輸入指示器——列出需要的]
-**衝突/同步狀態展示**: [例：樂觀更新 + 靜默同步 / 明確顯示「正在同步」]
-**離線提示**: [例：頂部 Banner 提示 / 靜默重連]
-<!-- @end -->
-
-<!-- @style:ai -->
-## 風格與調性
-
-**互動模式**: [對話型（聊天 UI）/ 工具型（命令+結果）/ 混合]
-**串流輸出展示**: [例：逐字打印效果 / 分段載入 / 批量回傳]
-**錯誤/降級提示**: [例：顯示 fallback 模型 / 重試按鈕 / 靜默降級]
-<!-- @end -->

package/dist/templates/zh-Hant/docs/global/data_snapshot.json

@@ -1,31 +0,0 @@
-{
-  "scope": "[?Data]",
-  "models": [
-    {
-      "name": "[ModelName]",
-      "description": "[一句話說明]",
-      "fields": [
-        {
-          "name": "id",
-          "type": "string",
-          "modifiers": "PK",
-          "description": "唯一識別碼"
-        },
-        {
-          "name": "[fieldName]",
-          "type": "[type]",
-          "modifiers": "[nullable | unique | index | ...]",
-          "description": "[欄位說明]"
-        }
-      ]
-    }
-  ],
-  "relationships": [
-    {
-      "from": "[ModelA]",
-      "to": "[ModelB]",
-      "type": "[1:1 | 1:N | M:N | self-ref]",
-      "description": "[關係說明]"
-    }
-  ]
-}

package/dist/templates/zh-Hant/docs/global/design_tokens.json

@@ -1,135 +0,0 @@
-{
-  "_comment": "由 /archi.start 基於 Brief「風格與調性」和「視覺參考」生成。所有值須從 Brief 推導，禁直接複用任何範本預設值。",
-  "scope": "[?UI]",
-  "status": "drafting",
-
-  "aestheticDirection": {
-    "preset": "",
-    "_presetOptions": "saas-dark | saas-light | dashboard | marketing | mobile-app | editorial | brutalist | custom",
-    "customDescription": ""
-  },
-
-  "primitivePalette": {
-    "neutral": {
-      "50": "",
-      "100": "",
-      "200": "",
-      "300": "",
-      "400": "",
-      "500": "",
-      "600": "",
-      "700": "",
-      "800": "",
-      "900": "",
-      "950": ""
-    },
-    "brand": {}
-  },
-
-  "semanticTokens": {
-    "colors": [
-      { "token": "Background", "light": "", "dark": "", "usage": "頁面背景" },
-      {
-        "token": "Surface",
-        "light": "",
-        "dark": "",
-        "usage": "卡片, 彈窗, 側邊欄"
-      },
-      {
-        "token": "Primary",
-        "light": "Brand-?00",
-        "dark": "Brand-?00",
-        "usage": "主按鈕, 激活狀態"
-      },
-      { "token": "Text-Main", "light": "", "dark": "", "usage": "正文, 標題" },
-      {
-        "token": "Text-Muted",
-        "light": "",
-        "dark": "",
-        "usage": "次要資訊, 註解"
-      },
-      { "token": "Border", "light": "", "dark": "", "usage": "邊框, 分隔線" },
-      {
-        "token": "Destructive",
-        "light": "",
-        "dark": "",
-        "usage": "刪除, 錯誤提示"
-      }
-    ],
-    "typography": [
-      {
-        "role": "H1",
-        "fontFamily": "",
-        "size": "",
-        "weight": "",
-        "lineHeight": ""
-      },
-      {
-        "role": "H2",
-        "fontFamily": "",
-        "size": "",
-        "weight": "",
-        "lineHeight": ""
-      },
-      {
-        "role": "Body",
-        "fontFamily": "",
-        "size": "",
-        "weight": "",
-        "lineHeight": ""
-      },
-      {
-        "role": "Small",
-        "fontFamily": "",
-        "size": "",
-        "weight": "",
-        "lineHeight": ""
-      }
-    ]
-  },
-
-  "layout": {
-    "radius": {
-      "sm": "",
-      "md": "",
-      "lg": "",
-      "full": "9999px"
-    },
-    "shadow": {
-      "sm": "",
-      "md": ""
-    },
-    "spacing": {
-      "unit": "4px",
-      "scale": [1, 2, 3, 4, 6, 8, 12, 16]
-    }
-  },
-
-  "mode": {
-    "default": "",
-    "support": []
-  },
-
-  "motion": {
-    "preference": "",
-    "easing": {
-      "standard": "",
-      "decelerate": "",
-      "accelerate": ""
-    },
-    "duration": {
-      "instant": "",
-      "fast": "",
-      "normal": "",
-      "slow": "",
-      "pageTransition": ""
-    },
-    "patterns": {}
-  },
-
-  "illustration": {
-    "style": "",
-    "iconLibrary": "",
-    "emptyStateAsset": ""
-  }
-}

package/dist/templates/zh-Hant/docs/global/dictionary.json

@@ -1,35 +0,0 @@
-{
-  "entities": [
-    {
-      "term": "[業務術語]",
-      "definition": "[一句話定義]",
-      "codeName": "[PascalCase / camelCase]",
-      "forbiddenSynonyms": [],
-      "reference": "[來源: spec / vision / task ID]"
-    }
-  ],
-  "verbs": [
-    {
-      "verb": "[業務動作]",
-      "definition": "[一句話定義]",
-      "codeName": "[camelCase]",
-      "context": "[使用場景]",
-      "reference": "[來源]"
-    }
-  ],
-  "utilities": [
-    {
-      "name": "[工具名, 如 logger]",
-      "path": "[檔案路徑, 如 src/utils/logger.ts]",
-      "purpose": "[用途說明]",
-      "replaces": "[替代的原始 API, 如 console.log]"
-    }
-  ],
-  "components [?UI]": [
-    {
-      "name": "[元件名]",
-      "path": "[檔案路徑]",
-      "purpose": "[用途說明]"
-    }
-  ]
-}

package/dist/templates/zh-Hant/docs/global/error_codes.json

@@ -1,19 +0,0 @@
-{
-  "protocolMapping [?API]": [
-    {
-      "statusCode": "[400 | EXIT_1 | ...]",
-      "code": "[ERR_VALIDATION]",
-      "meaning": "[含義]",
-      "action": "[呼叫方行為: Toast / Exit / Retry / ...]"
-    }
-  ],
-  "businessErrors": [
-    {
-      "module": "[MODULE]",
-      "code": "ERR_[MODULE]_[REASON]",
-      "statusCode": "",
-      "message": "[使用者/開發者可見的錯誤描述]",
-      "recovery": "[恢復建議]"
-    }
-  ]
-}

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

@@ -1,94 +0,0 @@
-{
-  "governance": {
-    "coreRules": [
-      {
-        "file": "00_system.md",
-        "role": "System Role",
-        "when": "每次對話開始時 (身份設定, 核心原則)"
-      },
-      {
-        "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": "觸碰程式碼時，自動關聯上下文檔案"
-      }
-    ],
-    "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": "錯誤碼與協議契約"
-      }
-    ]
-  },
-  "featureDocs": [
-    {
-      "file": "spec.md",
-      "category": "Specification",
-      "purpose": "業務邏輯、演算法、驗收標準 (Logic)"
-    },
-    {
-      "file": "ui.md",
-      "category": "UI/UX",
-      "purpose": "任務級 UI 範圍聲明 — 引用 ui_context.md 中的畫面 ID，指定本任務涵蓋的畫面/元件範圍"
-    },
-    {
-      "file": "plan.json",
-      "category": "Plan",
-      "purpose": "詳細步驟拆解與測試案例 (Execution)"
-    }
-  ],
-  "directoryMapping": [],
-  "logicalTopology": [],
-  "criticalUserJourneys": [],
-  "featureRelations": []
-}

package/dist/templates/zh-Hant/docs/global/roadmap.json

@@ -1,39 +0,0 @@
-{
-  "version": 1,
-  "projectStatus": "planning",
-  "lastUpdated": "YYYY-MM-DD",
-  "phases": [
-    {
-      "id": "phase-1",
-      "name": "Infrastructure",
-      "tasks": [
-        {
-          "id": "INF-01",
-          "title": "Project Scaffolding",
-          "status": "pending",
-          "description": "",
-          "goal": "",
-          "deps": [],
-          "tag": "Infra",
-          "slug": "Project_Scaffolding"
-        }
-      ]
-    },
-    {
-      "id": "phase-2",
-      "name": "Core Features",
-      "tasks": [
-        {
-          "id": "FEAT-01",
-          "title": "Example Task",
-          "status": "blocked",
-          "description": "",
-          "goal": "",
-          "deps": ["INF-01"],
-          "tag": "Core",
-          "slug": "Example_Task"
-        }
-      ]
-    }
-  ]
-}