architext 0.0.2

package/dist/templates/en/briefs/_base.md

@@ -0,0 +1,115 @@
+# Project Brief: [Project Name]
+
+> Fill in what you can; leave blank if unsure. When done, run `/archi.start project-brief.md` and AI will complete missing info via multiple-choice questions.
+
+---
+
+## Project Overview
+
+**Project Name**: 
+**One-line description**: [What the project is, who it serves, what problem it solves]
+**Problem statement**: [Core pain points for target users? Where do existing solutions fall short?]
+
+**Target users**:
+- **Primary users**: [Role/audience]
+- **Key characteristics**: [Skill level, usage context, behavioral patterns]
+
+**Success metrics**: [What counts as done? e.g.: DAU 1000 / adopted by 100+ projects / P99 < 200ms]
+
+---
+
+## Core Tasks
+
+> MVP must-have tasks (recommend 3–7), each in one sentence describing expected behavior.
+> Detailed specs are defined in `/archi.plan`; here just clarify "what to build."
+
+1. 
+2. 
+3. 
+
+---
+
+## Existing Design Decisions
+
+> If you have clear ideas for specific tasks/pages/flows, describe them here. AI will treat these as final in the plan phase and will not override them.
+> Leave blank if not applicable.
+>
+> Format:
+> - **[Task/page name]**: Describe behavior, flow, constraints
+> - May include screenshot/sketch links
+
+---
+
+## Tech Stack
+
+> Fill in what's confirmed. Leave blank or write "recommend" for the rest; AI will recommend based on project characteristics.
+
+**Project type**: [[__PROJECT_TYPE__]]
+<!-- Auto-filled by archi init; if writing manually, refer to the project type table in the archi-decompose-roadmap SKILL -->
+**Language/runtime**: [e.g.: TypeScript + Node.js 22]
+**Core framework**: [e.g.: Next.js 15 / Fastify / Tauri]
+**Package manager**: [e.g.: pnpm / npm / yarn / cargo]
+**Build tool**: [e.g.: Vite / tsup / Webpack / esbuild / cargo / go build]
+**Linter / Formatter**: [e.g.: ESLint + Prettier / Biome / ruff / clippy + rustfmt]
+<!-- @slot:tech -->
+**Deployment target**: [e.g.: Vercel / Docker / npm publish / binary distribution]
+**Key third-party libraries**: [e.g.: Zod, TanStack Query, Lucia Auth]
+
+**Technical red lines** (banned tech/approaches):
+- [e.g.: No jQuery; no CSS-in-JS]
+
+---
+
+## Engineering Standards
+
+> Existing team conventions. Leave blank if unsure; AI will recommend sensible defaults based on your tech stack.
+
+**Repository structure**: [Monorepo (Turborepo/Nx/pnpm workspaces) / single repo]
+**Architecture pattern**: [e.g.: MFA / FSD / Clean Architecture / layered / no preference (AI recommends)]
+**Directory structure**: [already defined → describe key dirs / none (AI generates based on pattern)]
+**Branching strategy**: [e.g.: Trunk-based / Git Flow / GitHub Flow]
+**Commit convention**: [e.g.: Conventional Commits (feat/fix/chore) / custom → describe]
+**Testing preference**: [e.g.: Vitest / Jest / pytest / no special requirements]
+
+---
+
+## Existing Resources & Context
+
+> What already exists that AI should know—to avoid reinventing or making conflicting decisions.
+
+**Project starting point**: [Greenfield / based on existing repo (brief status and tech debt)]
+**Design assets**: [Figma link / design mockup screenshots / none (AI designs)]
+**Brand guidelines**: [Existing logo/colors/fonts → describe or link / none]
+**Existing API/backend**: [API docs link / brief available endpoints / none (build from scratch)]
+**Third-party services**: [Confirmed services, e.g.: Auth0, Stripe, AWS S3, Resend...]
+**Existing data**: [Existing DB/data sources? Format? Migration needed? / none]
+
+---
+
+<!-- @slot:style -->
+
+## Scope & Constraints
+
+**Explicit non-goals** (anti-goals):
+- [e.g.: No i18n this release / no mobile adaption / no paid features]
+
+**Hard constraints**:
+- **Timeline**: [e.g.: 4-week MVP / no hard deadline]
+- **Compatibility**: [e.g.: Chrome 90+ / Node 18+ / iOS 15+]
+- **Performance**: [e.g.: First paint < 2s / API P99 < 500ms / no special requirements]
+- **Compliance/accessibility**: [e.g.: WCAG 2.1 AA / GDPR / none]
+
+---
+
+## References & Inspiration
+
+| Reference project | Reference dimension |
+|:---|:---|
+| [e.g.: Linear] | [Interaction UX, task management logic] |
+| | |
+
+---
+
+## Additional Notes
+
+> Anything not covered above: background story, special requirements, rationale for decisions, team tech preferences, etc.

package/dist/templates/en/briefs/_modules.md

@@ -0,0 +1,173 @@
+<!-- @tech:ui -->
+**CSS/UI approach**: [e.g.: TailwindCSS + Shadcn/UI / Ant Design / plain CSS]
+<!-- @end -->
+
+<!-- @tech:data -->
+**Database**: [e.g.: PostgreSQL / MongoDB / SQLite]
+**ORM / Query Builder**: [e.g.: Prisma / Drizzle / TypeORM]
+<!-- @end -->
+
+<!-- @tech:api -->
+**API style**: [e.g.: RESTful / GraphQL / gRPC / tRPC]
+<!-- @end -->
+
+<!-- @tech:cli -->
+**CLI framework**: [e.g.: cac / commander / clap (Rust) / cobra (Go)]
+**Distribution**: [e.g.: npm publish / GitHub Releases / binary]
+<!-- @end -->
+
+<!-- @tech:lib -->
+**Module format**: [e.g.: ESM / CJS + ESM dual output]
+**Target platforms**: [e.g.: browser + Node.js / Node.js only]
+**Distribution channel**: [e.g.: npm / PyPI / crates.io]
+<!-- @end -->
+
+<!-- @style:ui -->
+## Style & Tone
+
+**Aesthetic direction** (pick the closest match; leave blank for AI to recommend):
+<!-- Pick one, or write "custom" and describe below -->
+<!-- saas-dark    — like Linear/Vercel/Raycast: dark bg, high contrast, minimal, sharp edges -->
+<!-- saas-light   — like Notion/Stripe/GitHub: white bg, thin borders, system fonts, breathing room -->
+<!-- dashboard    — like Grafana/Datadog: info-dense, card grids, data-first -->
+<!-- marketing    — like Loom/Framer: large headings, gradients, visual impact, narrative -->
+<!-- mobile-app   — like Telegram/Bear: large radius, wide spacing, touch-friendly -->
+<!-- editorial    — like Medium/Substack: typography-first, serif fonts, reading immersion -->
+<!-- brutalist    — like Craigslist/HN: function-first, no decoration, raw -->
+<!-- custom       — describe your desired style in "Custom description" below -->
+
+**Aesthetic direction**: [e.g.: saas-dark / saas-light / dashboard / marketing / mobile-app / editorial / brutalist / custom]
+**Custom description**: [only for "custom", e.g.: "Spotify-like dark + green accent + card-based layout"]
+
+**Information density**: [generous whitespace/immersive / dense/dashboard-style]
+**Motion preference**: [subtle micro-interactions / rich animation / no animation]
+
+### Visual Reference
+
+> Provides aesthetic input for AI — directly impacts `ui_concept.html` quality.
+> Fill in any of the fields below; the more you provide, the closer AI can match your vision.
+
+**Competitor/inspiration screenshots**: [paste image / Figma link / URL]
+**Brand palette**: [primary color Hex / gradient description / none (AI generates from aesthetic direction)]
+**Font preference**: [e.g.: JetBrains Mono + Space Grotesk / Playfair Display / no preference (AI picks from aesthetic direction)]
+**Icon library**: [e.g.: Lucide / Heroicons / Tabler / no preference]
+**Forbidden styles**: [e.g.: no gradient backgrounds / no cartoon illustration / no restriction]
+<!-- @end -->
+
+<!-- @style:cli -->
+## Style & Tone
+
+**Output style**: [concise single-line / structured colorful / JSON machine-readable]
+**Interaction mode**: [pure argument-driven / interactive prompts / hybrid]
+**Error display**: [concise message / detailed stack / tiered (--verbose)]
+<!-- @end -->
+
+<!-- @style:api -->
+## Style & Tone
+
+**Documentation approach**: [OpenAPI/Swagger / GraphQL Schema / hand-written docs]
+**Error response format**: [RFC 7807 / custom JSON / GraphQL errors]
+**Versioning strategy**: [URL path /v1 / Header / no versioning]
+<!-- @end -->
+
+<!-- @tech:mobile -->
+**Mobile runtime**: [e.g.: React Native 0.76 / Flutter 3 / Expo SDK 52]
+**UI component library**: [e.g.: RN Paper / NativeWind / NativeBase / native components]
+**Navigation**: [e.g.: React Navigation 7 / Expo Router / Go Router]
+**Native capabilities**: [e.g.: camera, push notifications, biometrics — list what's needed]
+**Distribution**: [e.g.: App Store + Play Store / Expo Go / TestFlight]
+**OTA updates**: [e.g.: Expo Updates / CodePush / not needed]
+<!-- @end -->
+
+<!-- @tech:miniapp -->
+**Mini program platform**: [e.g.: WeChat / Alipay / Douyin / uni-app (multi-platform)]
+**Base library version**: [e.g.: WeChat base library 3.x / uni-app Vue3]
+**UI component library**: [e.g.: Vant Weapp / TDesign MiniProgram / native components]
+**Cloud development**: [e.g.: WeChat CloudBase / not used]
+**Publishing**: [e.g.: WeChat Public Platform / review cycle expectations]
+<!-- @end -->
+
+<!-- @style:miniapp -->
+## Style & Tone
+
+**Visual guidelines**: [Follow platform design spec (WeChat Weui / Alipay / Douyin) / custom brand style]
+**Color direction**: [brand primary color / follow platform defaults / dark mode (if platform supports)]
+**Component style**: [native components first / custom components / mixed]
+**Motion preference**: [system default page transitions / custom transitions / no special requirement]
+<!-- @end -->
+
+<!-- @tech:desktop -->
+**Desktop runtime**: [e.g.: Tauri 2 / Electron 33]
+**IPC communication**: [e.g.: Tauri invoke/command / Electron ipcMain+ipcRenderer]
+**System-level capabilities**: [e.g.: system tray, global hotkeys, file associations, clipboard — list what's needed]
+**Packaging & distribution**: [e.g.: tauri-bundler (.dmg/.msi/.deb) / electron-builder / GitHub Releases]
+**Auto-update**: [e.g.: tauri-updater / electron-updater / not needed]
+<!-- @end -->
+
+<!-- @tech:extension -->
+**Target browsers**: [e.g.: Chrome + Edge / Firefox / all platforms]
+**Manifest version**: [V3 (recommended) / V2 (Firefox compatibility)]
+**Extension structure**: [e.g.: Popup only / Popup + Content Script / Background + Content Script + Popup]
+**Permission declarations**: [e.g.: storage, tabs, activeTab — list what's needed]
+**Publishing channel**: [e.g.: Chrome Web Store / Firefox Add-ons / private distribution]
+<!-- @end -->
+
+<!-- @tech:realtime -->
+**Real-time transport**: [e.g.: Socket.io / native WebSocket / SSE / WebRTC]
+**Real-time framework/hosting**: [e.g.: Ably / Pusher / Liveblocks / self-hosted]
+**Room/channel model**: [e.g.: subscribe by user ID / room by document ID / broadcast]
+**[?CRDT] Conflict resolution**: [e.g.: Yjs / Automerge / not needed (broadcast only)]
+**Offline support**: [e.g.: offline queue + reconnect sync / not needed]
+<!-- @end -->
+
+<!-- @tech:ai -->
+**LLM provider**: [e.g.: OpenAI GPT-4o / Anthropic Claude / Gemini / local Ollama]
+**AI framework**: [e.g.: Vercel AI SDK / LangChain / LlamaIndex / direct API calls]
+**Tool/Function Calling**: [e.g.: needed (list tool names) / not needed]
+**Memory approach**: [e.g.: vector DB (pgvector/Pinecone) / sliding window history / none]
+**[?MCP] MCP protocol**: [e.g.: @modelcontextprotocol/sdk / not needed]
+**Streaming output**: [e.g.: SSE streaming / batch response]
+<!-- @end -->
+
+<!-- @style:mobile -->
+## Style & Tone
+
+**Visual keywords**: [e.g.: native feel, lightweight, immersive]
+**Sizing approach**: [responsive dp/sp / fixed 375pt design base]
+**Dark mode**: [follow system / light only / dark only]
+**Motion preference**: [system native animations / custom transitions / no special requirement]
+**Accessibility**: [e.g.: VoiceOver / TalkBack support / no special requirement]
+<!-- @end -->
+
+<!-- @style:desktop -->
+## Style & Tone
+
+**Visual style**: [e.g.: native OS style (Fluent/HIG) / custom brand style]
+**Window management**: [e.g.: single main window + tray / multi-window / fullscreen-first]
+**Dark mode**: [follow system / dark only / light only]
+**Menu bar / system tray**: [e.g.: menu bar icon + quick actions / tray icon only / not needed]
+<!-- @end -->
+
+<!-- @style:extension -->
+## Style & Tone
+
+**Popup size convention**: [e.g.: 320×480px / 400×600px / adaptive]
+**Visual style**: [e.g.: minimal card / blend with host page / independent brand]
+**Content script injection style**: [e.g.: floating button / sidebar / highlight overlay]
+<!-- @end -->
+
+<!-- @style:realtime -->
+## Style & Tone
+
+**Collaboration awareness UI**: [e.g.: live cursors, user avatar list, typing indicators — list what's needed]
+**Sync/conflict state display**: [e.g.: optimistic update + silent sync / explicit "syncing" indicator]
+**Offline notification**: [e.g.: top banner / silent reconnect]
+<!-- @end -->
+
+<!-- @style:ai -->
+## Style & Tone
+
+**Interaction mode**: [conversational (chat UI) / tool-style (command + result) / hybrid]
+**Streaming output display**: [e.g.: character-by-character typewriter / chunked loading / batch response]
+**Error / fallback UX**: [e.g.: show fallback model name / retry button / silent degradation]
+<!-- @end -->

package/dist/templates/en/docs/global/data_snapshot.json

@@ -0,0 +1,31 @@
+{
+  "scope": "[?Data]",
+  "models": [
+    {
+      "name": "[ModelName]",
+      "description": "[One-line description]",
+      "fields": [
+        {
+          "name": "id",
+          "type": "string",
+          "modifiers": "PK",
+          "description": "Unique identifier"
+        },
+        {
+          "name": "[fieldName]",
+          "type": "[type]",
+          "modifiers": "[nullable | unique | index | ...]",
+          "description": "[Field description]"
+        }
+      ]
+    }
+  ],
+  "relationships": [
+    {
+      "from": "[ModelA]",
+      "to": "[ModelB]",
+      "type": "[1:1 | 1:N | M:N | self-ref]",
+      "description": "[Relationship description]"
+    }
+  ]
+}

package/dist/templates/en/docs/global/design_tokens.json

@@ -0,0 +1,150 @@
+{
+  "_comment": "Generated by /archi.start from Brief 'Style & Tone' and 'Visual Reference'. All values must be derived from the Brief — never copy template defaults.",
+  "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": "page background"
+      },
+      {
+        "token": "Surface",
+        "light": "",
+        "dark": "",
+        "usage": "cards, modals, sidebars"
+      },
+      {
+        "token": "Primary",
+        "light": "Brand-?00",
+        "dark": "Brand-?00",
+        "usage": "primary buttons, active state"
+      },
+      {
+        "token": "Text-Main",
+        "light": "",
+        "dark": "",
+        "usage": "body, headings"
+      },
+      {
+        "token": "Text-Muted",
+        "light": "",
+        "dark": "",
+        "usage": "secondary text, captions"
+      },
+      {
+        "token": "Border",
+        "light": "",
+        "dark": "",
+        "usage": "borders, dividers"
+      },
+      {
+        "token": "Destructive",
+        "light": "",
+        "dark": "",
+        "usage": "delete, error states"
+      }
+    ],
+    "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/en/docs/global/dictionary.json

@@ -0,0 +1,35 @@
+{
+  "entities": [
+    {
+      "term": "[Business Term]",
+      "definition": "[One-line definition]",
+      "codeName": "[PascalCase / camelCase]",
+      "forbiddenSynonyms": [],
+      "reference": "[Source: spec / vision / task ID]"
+    }
+  ],
+  "verbs": [
+    {
+      "verb": "[Business Action]",
+      "definition": "[One-line definition]",
+      "codeName": "[camelCase]",
+      "context": "[Usage context]",
+      "reference": "[Source]"
+    }
+  ],
+  "utilities": [
+    {
+      "name": "[Utility name, e.g. logger]",
+      "path": "[File path, e.g. src/utils/logger.ts]",
+      "purpose": "[Purpose]",
+      "replaces": "[Raw API it replaces, e.g. console.log]"
+    }
+  ],
+  "components [?UI]": [
+    {
+      "name": "[Component Name]",
+      "path": "[File Path]",
+      "purpose": "[Purpose]"
+    }
+  ]
+}

package/dist/templates/en/docs/global/error_codes.json

@@ -0,0 +1,19 @@
+{
+  "protocolMapping [?API]": [
+    {
+      "statusCode": "[400 | EXIT_1 | ...]",
+      "code": "[ERR_VALIDATION]",
+      "meaning": "[Meaning]",
+      "action": "[Caller behavior: Toast / Exit / Retry / ...]"
+    }
+  ],
+  "businessErrors": [
+    {
+      "module": "[MODULE]",
+      "code": "ERR_[MODULE]_[REASON]",
+      "statusCode": "",
+      "message": "[User/developer-facing error description]",
+      "recovery": "[Recovery suggestion]"
+    }
+  ]
+}

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

@@ -0,0 +1,94 @@
+{
+  "governance": {
+    "coreRules": [
+      {
+        "file": "00_system.md",
+        "role": "System Role",
+        "when": "At the start of every session (Identity, Core Principles)"
+      },
+      {
+        "file": "01_workflow.md",
+        "role": "SOP",
+        "when": "Decides current task flow (Task vs Fix) & Acceptance Criteria"
+      },
+      {
+        "file": "02_tech_stack.md",
+        "role": "Tech Stack",
+        "when": "Tech choices, coding standards, engineering governance"
+      },
+      {
+        "file": "03_data_governance.md",
+        "role": "Data Governance",
+        "when": "When reading/writing global JSON data files"
+      },
+      {
+        "file": "04_cli_tools.md",
+        "role": "CLI Reference",
+        "when": "When executing Terminal Gate commands (npx archi task/plan/render syntax reference)"
+      },
+      {
+        "file": "99_context_glue.md",
+        "role": "Context Bridge",
+        "when": "Automatically links context docs when touching code"
+      }
+    ],
+    "globalReference": [
+      {
+        "file": "roadmap.json",
+        "role": "Roadmap",
+        "content": "Progress tracking, milestones, technical debt management"
+      },
+      {
+        "file": "vision.md",
+        "role": "Vision",
+        "content": "Vision, North Star Metric, Design Philosophy"
+      },
+      {
+        "file": "map.json",
+        "role": "Map (This file)",
+        "content": "Directory structure, file index, logical topology"
+      },
+      {
+        "file": "dictionary.json",
+        "role": "Dictionary",
+        "content": "Business glossary, shared component registry"
+      },
+      {
+        "file": "design_tokens.json",
+        "role": "Visuals [?UI]",
+        "content": "Colors, typography, spacing variables"
+      },
+      {
+        "file": "data_snapshot.json",
+        "role": "Data [?Data]",
+        "content": "Database Schema snapshot"
+      },
+      {
+        "file": "error_codes.json",
+        "role": "Errors",
+        "content": "Error codes & protocol contracts"
+      }
+    ]
+  },
+  "featureDocs": [
+    {
+      "file": "spec.md",
+      "category": "Specification",
+      "purpose": "Business Logic, Algorithms, Acceptance Criteria (Logic)"
+    },
+    {
+      "file": "ui.md",
+      "category": "UI/UX",
+      "purpose": "Task-level UI scope declaration — references screen IDs from ui_context.md to define this task's screen/component scope"
+    },
+    {
+      "file": "plan.json",
+      "category": "Plan",
+      "purpose": "Detailed Step Breakdown & Test Cases (Execution)"
+    }
+  ],
+  "directoryMapping": [],
+  "logicalTopology": [],
+  "criticalUserJourneys": [],
+  "featureRelations": []
+}

package/dist/templates/en/docs/global/roadmap.json

@@ -0,0 +1,39 @@
+{
+  "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"
+        }
+      ]
+    }
+  ]
+}