chati-dev 4.0.0 → 4.0.1

package/framework/agents/plan/ux.md

@@ -43,7 +43,47 @@ Define the user experience: information architecture, user flows, interaction pa
 
 ---
 
-## Execution: 5 Phases
+## Execution: 6 Phases
+
+### Phase 0: Brand Identity (Brandbook)
+```
+PREREQUISITE: Brief handoff + Architecture handoff
+
+Before defining any design tokens or visual patterns, establish the brand identity:
+
+1. Define Brand Voice
+   - Personality traits (3-5 adjectives)
+   - Tone spectrum (formal <-> casual positioning)
+   - Writing principles and anti-patterns
+
+2. Define Visual Language
+   - Mood descriptor and visual metaphor
+   - Density and contrast philosophy
+   - Texture strategy (flat, layered, glassmorphic, etc.)
+
+3. Typography Rationale
+   - Display + body font pairing with WHY
+   - Hierarchy strategy
+   - Pairing logic explanation
+
+4. Color Philosophy
+   - Primary color rationale (emotional, functional)
+   - Palette derivation logic
+   - Accessibility considerations
+
+5. Spacing Rhythm
+   - Base unit selection + rationale
+   - Rhythm personality (generous, dense, modular)
+
+6. Iconography Style
+   - Style direction (outline, solid, duo-tone)
+   - Preferred library alignment with brand personality
+
+Output: chati.dev/artifacts/4-UX/brandbook.md
+
+RULE: Every subsequent design decision must trace back to the brandbook.
+RULE: Brandbook establishes the WHY — Design System (Phase 4) establishes the WHAT.
+```
 
 ### Phase 1: User Flow Mapping
 ```

package/framework/config.yaml

@@ -1,8 +1,8 @@
 # chati.dev Configuration
-version: "4.0.0"
+version: "4.0.1"
 installed_at: "2026-02-07T10:00:00Z"
-updated_at: "2026-03-17T00:00:00Z"
-installer_version: "4.0.0"
+updated_at: "2026-03-18T00:00:00Z"
+installer_version: "4.0.1"
 project_type: greenfield
 language: en
 ides: [claude-code]

package/framework/constitution.md

@@ -115,6 +115,12 @@ Every agent in Chati.dev:
 4. Error messages are constructive: what failed, why, and how to fix
 5. Status updates are concise and actionable
 6. Technical jargon is adapted to detected user level (vibecoder vs power user)
+7. Generated content MUST NOT contain AI-detectable writing patterns:
+   - No em dashes. Use commas, semicolons, colons, or periods instead
+   - Avoid formulaic phrases: "Delve into", "Dive into", "It's important to note that"
+   - Avoid stacking transitions: "Furthermore", "Moreover", "Additionally" in sequence
+   - Avoid over-hedging: "It could potentially perhaps maybe..."
+   - Write naturally. If a sentence reads like AI wrote it, rewrite it
 
 **Enforcement: GUIDE** — Violations trigger guidance, not blocking.
 

package/framework/data/entity-registry.yaml

@@ -3,9 +3,9 @@
 # and by the Health Check for system integrity validation.
 
 metadata:
-  version: "1.0.0"
-  last_updated: "2026-02-12T00:00:00Z"
-  entity_count: 50
+  version: "4.0.0"
+  last_updated: "2026-03-17T00:00:00Z"
+  entity_count: 55
   checksum_algorithm: sha256
 
 entities:
@@ -163,6 +163,38 @@ entities:
       dependencies: [brief]
       adaptability: 0.6
 
+    brandbook:
+      path: chati.dev/templates/brandbook-tmpl.yaml
+      type: template
+      purpose: "Brand identity foundation — voice, visual language, typography, color philosophy"
+      keywords: [brand, identity, voice, visual, typography, color]
+      dependencies: [ux]
+      adaptability: 0.8
+
+    design-tokens:
+      path: chati.dev/templates/design-token-tmpl.yaml
+      type: template
+      purpose: "Structured design token system — primitive, semantic, component, utility layers"
+      keywords: [design, tokens, colors, spacing, typography, components]
+      dependencies: [brandbook]
+      adaptability: 0.7
+
+    component-spec:
+      path: chati.dev/templates/component-spec-tmpl.yaml
+      type: template
+      purpose: "UI component specification — variants, states, anatomy, accessibility"
+      keywords: [component, specification, ui, variants, states, accessibility]
+      dependencies: [design-tokens]
+      adaptability: 0.7
+
+    icon-system:
+      path: chati.dev/templates/icon-system-tmpl.yaml
+      type: template
+      purpose: "Icon library selection, sizing scale, usage guidelines, and inventory"
+      keywords: [icons, library, sizing, accessibility, inventory]
+      dependencies: [brandbook]
+      adaptability: 0.8
+
   workflows:
     greenfield-fullstack:
       path: chati.dev/workflows/greenfield-fullstack.yaml
@@ -212,6 +244,14 @@ entities:
       dependencies: [orchestrator, brief, dev, qa-implementation, devops]
       adaptability: 0.4
 
+    standard-flow:
+      path: chati.dev/workflows/standard-flow.yaml
+      type: workflow
+      purpose: "Balanced pipeline for moderate tasks: features, integrations, brownfield enhancements. Uses 8 agents."
+      keywords: [standard, balanced, feature, integration, enhancement, moderate]
+      dependencies: [orchestrator, brief, detail, architect, tasks, qa-planning, dev, qa-implementation, devops]
+      adaptability: 0.4
+
   schemas:
     session:
       path: chati.dev/schemas/session.schema.json

package/framework/domains/constitution.yaml

@@ -29,7 +29,7 @@ rules:
     priority: critical
 
   - id: art-v
-    text: "Communication follows structured protocol: guided options (1,2,3), clear formatting."
+    text: "Communication follows structured protocol: guided options (1,2,3), clear formatting. No em dashes or AI-detectable writing patterns."
     priority: normal
 
   - id: art-vi

package/framework/domains/global.yaml

@@ -18,6 +18,10 @@ rules:
     text: "Interact with user in their preferred language. Artifacts stay in English."
     priority: normal
 
+  - id: anti-dash
+    text: "Never use em dashes in generated content. Avoid AI-detectable writing patterns (formulaic transitions, over-hedging, stacking connectors)."
+    priority: high
+
   # Execution Profile Rules (v3.0.0)
   execution-profiles:
     - explore-readonly: "In explore profile, all write/edit tool calls are blocked."
@@ -75,10 +79,10 @@ modes:
 
 brackets:
   FRESH:
-    behavior: "Full context injection. All layers active. Include detailed rules and examples."
+    behavior: "Moderate context injection. All layers active but model is warming up. Budget lower than MODERATE."
   MODERATE:
-    behavior: "Standard injection. Skip task detail layer (L4). Summarize long rules."
+    behavior: "Peak context injection. Maximum token budget. Model has context and needs maximum reinforcement."
   DEPLETED:
-    behavior: "Minimal injection. Only L0+L1+L2. Use rule IDs instead of full text."
+    behavior: "Reduced injection. Only L0+L1+L2. Use rule IDs instead of full text."
   CRITICAL:
     behavior: "Emergency. L0+L1 only. Trigger handoff advisory. Preserve essential state."

package/framework/domains/workflows/standard-flow.yaml

@@ -0,0 +1,33 @@
+# Standard Flow Workflow Domain — PRISM L3
+# Balanced pipeline for moderate tasks (features, integrations, brownfield enhancements)
+# Uses 8 agents — between Quick Flow (4) and Full Flow (12)
+
+steps:
+  - brief
+  - detail
+  - architect
+  - tasks
+  - qa-planning
+  - dev
+  - qa-implementation
+  - devops
+
+rules:
+  - id: sf-scope
+    text: "Standard Flow targets 2-5 requirements. Escalate to full pipeline if scope exceeds this range."
+    priority: critical
+  - id: sf-quality
+    text: "Both QA gates (planning and implementation) are mandatory. Score >= 95% required at each gate."
+    priority: critical
+  - id: sf-no-ux-skip
+    text: "UX agent is excluded. If design-heavy requirements surface, escalate to full pipeline."
+    priority: high
+  - id: sf-no-phases
+    text: "Phases agent is excluded. Tasks agent handles scope decomposition directly from PRD + Architecture."
+    priority: high
+  - id: sf-escalation-up
+    text: "If architect discovers multi-service complexity or QA finds UX gaps, offer escalation to full pipeline."
+    priority: high
+  - id: sf-escalation-down
+    text: "If detail finds only 1 simple requirement and architect confirms no changes needed, suggest quick flow."
+    priority: medium

package/framework/i18n/en.yaml

@@ -29,8 +29,8 @@ installer:
   created_overlays: "Created provider overlay directories"
   will_install: "Will install:"
   agents_count: "13 agent definitions (DISCOVER, PLAN, BUILD, DEPLOY phases)"
-  workflows_count: "6 workflow blueprints"
-  templates_count: "6 templates (PRD, Brownfield PRD, Architecture, Task, QA Gate, Quick Brief)"
+  workflows_count: "7 workflow blueprints"
+  templates_count: "10 templates (PRD, Brownfield PRD, Architecture, Task, QA Gate, Quick Brief, Brandbook, Design Tokens, Component Spec, Icon System)"
   constitution: "Constitution (19 Articles + Preamble)"
   session_mgmt: "Session management system"
   quality_gates: "Quality gates (3-tier verdicts)"
@@ -85,6 +85,15 @@ status:
   backlog_items: "Backlog Items"
   high_priority: "high priority"
 
+features:
+  brandbook_step: "Phase 0: Establishing brand identity (Brandbook)"
+  tech_preset_loaded: "Tech preset loaded: {preset}"
+  tech_preset_detected: "Detected tech stack: {stack}"
+  doctor_running: "Running Doctor diagnostics..."
+  doctor_healthy: "Doctor: All checks passed"
+  doctor_degraded: "Doctor: Issues found (see report)"
+  doctor_fix_applied: "Doctor: Applied {count} auto-fix(es)"
+
 errors:
   session_corrupted: "Session file appears corrupted. Attempting recovery..."
   handoff_missing: "Handoff not found. Using session.yaml + CLAUDE.md as fallback."

package/framework/i18n/es.yaml

@@ -29,8 +29,8 @@ installer:
   created_overlays: "Creados directorios de overlay de proveedores"
   will_install: "Se instalara:"
   agents_count: "13 definiciones de agentes (fases DISCOVER, PLAN, BUILD, DEPLOY)"
-  workflows_count: "6 blueprints de workflow"
-  templates_count: "6 templates (PRD, PRD Brownfield, Arquitectura, Task, QA Gate, Quick Brief)"
+  workflows_count: "7 blueprints de workflow"
+  templates_count: "10 templates (PRD, PRD Brownfield, Arquitectura, Task, QA Gate, Quick Brief, Brandbook, Design Tokens, Component Spec, Icon System)"
   constitution: "Constitucion (19 Articulos + Preambulo)"
   session_mgmt: "Sistema de gestion de sesion"
   quality_gates: "Quality gates (veredictos en 3 niveles)"
@@ -85,6 +85,15 @@ status:
   backlog_items: "Items del Backlog"
   high_priority: "alta prioridad"
 
+features:
+  brandbook_step: "Fase 0: Estableciendo identidad de marca (Brandbook)"
+  tech_preset_loaded: "Tech preset cargado: {preset}"
+  tech_preset_detected: "Stack tecnologico detectado: {stack}"
+  doctor_running: "Ejecutando diagnosticos del Doctor..."
+  doctor_healthy: "Doctor: Todos los checks pasaron"
+  doctor_degraded: "Doctor: Problemas encontrados (ver reporte)"
+  doctor_fix_applied: "Doctor: Aplicado(s) {count} auto-fix(es)"
+
 errors:
   session_corrupted: "Archivo de sesion parece corrupto. Intentando recuperacion..."
   handoff_missing: "Handoff no encontrado. Usando session.yaml + CLAUDE.md como respaldo."

package/framework/i18n/fr.yaml

@@ -29,8 +29,8 @@ installer:
   created_overlays: "Crees les repertoires d'overlay des fournisseurs"
   will_install: "Sera installe:"
   agents_count: "13 definitions d'agents (phases DISCOVER, PLAN, BUILD, DEPLOY)"
-  workflows_count: "6 blueprints de workflow"
-  templates_count: "6 templates (PRD, PRD Brownfield, Architecture, Task, QA Gate, Quick Brief)"
+  workflows_count: "7 blueprints de workflow"
+  templates_count: "10 templates (PRD, PRD Brownfield, Architecture, Task, QA Gate, Quick Brief, Brandbook, Design Tokens, Component Spec, Icon System)"
   constitution: "Constitution (19 Articles + Preambule)"
   session_mgmt: "Systeme de gestion de session"
   quality_gates: "Quality gates (verdicts en 3 niveaux)"
@@ -85,6 +85,15 @@ status:
   backlog_items: "Elements du Backlog"
   high_priority: "haute priorite"
 
+features:
+  brandbook_step: "Phase 0: Etablissement de l'identite de marque (Brandbook)"
+  tech_preset_loaded: "Tech preset charge: {preset}"
+  tech_preset_detected: "Stack technologique detecte: {stack}"
+  doctor_running: "Execution des diagnostics du Doctor..."
+  doctor_healthy: "Doctor: Tous les checks ont reussi"
+  doctor_degraded: "Doctor: Problemes trouves (voir rapport)"
+  doctor_fix_applied: "Doctor: Applique(s) {count} auto-fix(es)"
+
 errors:
   session_corrupted: "Le fichier de session semble corrompu. Tentative de recuperation..."
   handoff_missing: "Passation non trouvee. Utilisation de session.yaml + CLAUDE.md comme repli."

package/framework/i18n/pt.yaml

@@ -29,8 +29,8 @@ installer:
   created_overlays: "Criados diretorios de overlay de provedores"
   will_install: "Sera instalado:"
   agents_count: "13 definicoes de agentes (fases DISCOVER, PLAN, BUILD, DEPLOY)"
-  workflows_count: "6 blueprints de workflow"
-  templates_count: "6 templates (PRD, PRD Brownfield, Arquitetura, Task, QA Gate, Quick Brief)"
+  workflows_count: "7 blueprints de workflow"
+  templates_count: "10 templates (PRD, PRD Brownfield, Arquitetura, Task, QA Gate, Quick Brief, Brandbook, Design Tokens, Component Spec, Icon System)"
   constitution: "Constituicao (19 Artigos + Preambulo)"
   session_mgmt: "Sistema de gerenciamento de sessao"
   quality_gates: "Quality gates (veredictos em 3 niveis)"
@@ -85,6 +85,15 @@ status:
   backlog_items: "Itens do Backlog"
   high_priority: "alta prioridade"
 
+features:
+  brandbook_step: "Fase 0: Estabelecendo identidade de marca (Brandbook)"
+  tech_preset_loaded: "Tech preset carregado: {preset}"
+  tech_preset_detected: "Stack tecnologico detectado: {stack}"
+  doctor_running: "Executando diagnosticos do Doctor..."
+  doctor_healthy: "Doctor: Todos os checks passaram"
+  doctor_degraded: "Doctor: Problemas encontrados (veja relatorio)"
+  doctor_fix_applied: "Doctor: Aplicado(s) {count} auto-fix(es)"
+
 errors:
   session_corrupted: "Arquivo de sessao parece corrompido. Tentando recuperacao..."
   handoff_missing: "Handoff nao encontrado. Usando session.yaml + CLAUDE.md como fallback."

package/framework/presets/nextjs.yaml

@@ -0,0 +1,41 @@
+# Tech Preset: Next.js
+# Auto-loaded by Architect agent when Next.js stack is detected
+
+stack: nextjs
+displayName: "Next.js"
+
+detection:
+  - next.config.js
+  - next.config.mjs
+  - next.config.ts
+
+conventions:
+  routing: "App Router preferred (app/ directory)"
+  components: "Server Components by default, 'use client' for interactivity"
+  data_fetching: "Server-side fetch in page/layout, React Query for client"
+  styling: "Tailwind CSS or CSS Modules (no global CSS imports in components)"
+  api: "Route Handlers in app/api/ (not pages/api/)"
+
+structure:
+  - "app/ — Routes, layouts, and pages"
+  - "app/api/ — Route Handlers (REST endpoints)"
+  - "components/ — Reusable UI components"
+  - "lib/ — Utility functions and shared logic"
+  - "public/ — Static assets"
+
+rules:
+  - id: nextjs-ssr
+    text: "Prefer Server Components. Only add 'use client' when interactivity is needed."
+    priority: high
+  - id: nextjs-api
+    text: "Use Route Handlers (app/api/) for API endpoints. Not pages/api/."
+    priority: high
+  - id: nextjs-layout
+    text: "Use layout.tsx for shared UI. Avoid prop drilling through layouts."
+    priority: normal
+  - id: nextjs-metadata
+    text: "Export metadata from page.tsx for SEO. Use generateMetadata for dynamic pages."
+    priority: normal
+  - id: nextjs-loading
+    text: "Use loading.tsx and error.tsx for streaming and error boundaries."
+    priority: normal

package/framework/presets/node-express.yaml

@@ -0,0 +1,39 @@
+# Tech Preset: Node.js + Express
+# Auto-loaded by Architect agent when Express stack is detected
+
+stack: node-express
+displayName: "Node.js + Express"
+
+detection:
+  - "package.json containing express"
+
+conventions:
+  routing: "Express Router with modular route files"
+  middleware: "Error-handling middleware at the end of the chain"
+  validation: "Zod or Joi for request validation"
+  auth: "JWT or session-based, middleware pattern"
+  errors: "Centralized error handler with error classes"
+
+structure:
+  - "src/ — Application source code"
+  - "src/routes/ — Express route definitions"
+  - "src/controllers/ — Request handlers"
+  - "src/middleware/ — Custom middleware"
+  - "src/services/ — Business logic"
+  - "src/models/ — Data models (ORM or raw queries)"
+  - "src/utils/ — Utility functions"
+  - "src/config/ — Configuration and environment"
+
+rules:
+  - id: express-error-handler
+    text: "Always use a centralized error-handling middleware. Never swallow errors silently."
+    priority: critical
+  - id: express-validation
+    text: "Validate all request input (body, params, query) before processing."
+    priority: high
+  - id: express-async
+    text: "Wrap async route handlers to catch rejected promises (express-async-errors or manual try/catch)."
+    priority: high
+  - id: express-env
+    text: "Use environment variables for all configuration. Never hardcode secrets."
+    priority: critical

package/framework/presets/react-vite.yaml

@@ -0,0 +1,37 @@
+# Tech Preset: React + Vite
+# Auto-loaded by Architect agent when React+Vite stack is detected
+
+stack: react-vite
+displayName: "React + Vite"
+
+detection:
+  - vite.config.js
+  - vite.config.ts
+  - vite.config.mjs
+
+conventions:
+  routing: "React Router v6+ with createBrowserRouter"
+  components: "Functional components with hooks"
+  state: "React Context for simple state, Zustand/Jotai for complex"
+  styling: "Tailwind CSS or CSS Modules"
+  build: "Vite with ESBuild for dev, Rollup for production"
+
+structure:
+  - "src/ — Application source code"
+  - "src/components/ — Reusable UI components"
+  - "src/pages/ — Route-level components"
+  - "src/hooks/ — Custom React hooks"
+  - "src/lib/ — Utility functions"
+  - "src/assets/ — Static assets (images, fonts)"
+  - "public/ — Public static files"
+
+rules:
+  - id: vite-env
+    text: "Use import.meta.env for environment variables. Prefix with VITE_ for client exposure."
+    priority: high
+  - id: vite-lazy
+    text: "Use React.lazy() and Suspense for route-level code splitting."
+    priority: normal
+  - id: vite-alias
+    text: "Configure path aliases in vite.config.ts (e.g., @ for src/)."
+    priority: normal

package/framework/presets/supabase-fullstack.yaml

@@ -0,0 +1,37 @@
+# Tech Preset: Supabase Fullstack
+# Auto-loaded by Architect agent when Supabase stack is detected
+
+stack: supabase-fullstack
+displayName: "Supabase Fullstack"
+
+detection:
+  - supabase/config.toml
+  - .env.local containing SUPABASE_URL
+
+conventions:
+  auth: "Supabase Auth with RLS policies for authorization"
+  database: "PostgreSQL with Row Level Security (RLS) on every table"
+  storage: "Supabase Storage for file uploads with bucket policies"
+  functions: "Supabase Edge Functions (Deno) for serverless logic"
+  realtime: "Supabase Realtime for live subscriptions"
+
+structure:
+  - "supabase/ — Supabase project configuration"
+  - "supabase/migrations/ — SQL migration files"
+  - "supabase/functions/ — Edge Functions (Deno)"
+  - "supabase/seed.sql — Seed data"
+  - "src/lib/supabase.ts — Supabase client initialization"
+
+rules:
+  - id: supabase-rls
+    text: "EVERY table MUST have RLS enabled. No exceptions. Create policies before exposing data."
+    priority: critical
+  - id: supabase-migrations
+    text: "All schema changes go through migration files. Never modify production DB directly."
+    priority: critical
+  - id: supabase-types
+    text: "Generate TypeScript types from database schema (supabase gen types)."
+    priority: high
+  - id: supabase-auth
+    text: "Use Supabase Auth helpers for SSR frameworks. Handle auth state server-side."
+    priority: high

package/framework/templates/brandbook-tmpl.yaml

@@ -0,0 +1,113 @@
+# Brandbook Template
+# Used by: UX Agent (Phase 0: Brand Identity)
+# Language: English (Constitution Article VII)
+
+template:
+  name: Brandbook
+  version: "1.0.0"
+  description: >
+    Brand identity foundation document. Defines voice, visual language,
+    typography rationale, color philosophy, spacing rhythm, and iconography
+    style. Must be completed BEFORE design tokens.
+
+output_path: chati.dev/artifacts/4-UX/brandbook.md
+
+sections:
+  - brand_voice
+  - visual_language
+  - typography_rationale
+  - color_philosophy
+  - spacing_rhythm
+  - iconography_style
+
+brand_voice:
+  description: "Brand personality, tone, and communication style"
+  fields:
+    - name: personality_traits
+      type: array
+      description: "3-5 adjectives defining the brand personality"
+    - name: tone_spectrum
+      type: object
+      description: "Formal vs casual, technical vs approachable spectrum"
+    - name: writing_guidelines
+      type: array
+      description: "Dos and don'ts for brand voice"
+    - name: example_phrases
+      type: array
+      description: "Sample phrases demonstrating brand voice"
+
+visual_language:
+  description: "Core visual principles and aesthetic direction"
+  fields:
+    - name: design_principles
+      type: array
+      description: "3-5 guiding principles for visual design"
+    - name: mood_keywords
+      type: array
+      description: "Keywords capturing the visual mood"
+    - name: inspiration_references
+      type: array
+      description: "Visual references and mood board elements"
+
+typography_rationale:
+  description: "Font selection rationale and typographic hierarchy"
+  fields:
+    - name: primary_font
+      type: object
+      description: "Primary typeface and why it was chosen"
+    - name: secondary_font
+      type: object
+      description: "Secondary typeface for contrast"
+    - name: hierarchy_rules
+      type: array
+      description: "Heading, body, caption sizing rationale"
+
+color_philosophy:
+  description: "Color palette rationale and emotional associations"
+  fields:
+    - name: primary_palette
+      type: array
+      description: "Primary colors with emotional rationale"
+    - name: semantic_mapping
+      type: object
+      description: "Color-to-meaning mapping (success, warning, error)"
+    - name: accessibility_notes
+      type: string
+      description: "WCAG contrast compliance notes"
+
+spacing_rhythm:
+  description: "Spacing scale rationale and rhythm system"
+  fields:
+    - name: base_unit
+      type: number
+      description: "Base spacing unit in pixels"
+    - name: scale_rationale
+      type: string
+      description: "Why this scale was chosen (4px, 8px, etc.)"
+    - name: rhythm_rules
+      type: array
+      description: "Rules for consistent vertical and horizontal rhythm"
+
+iconography_style:
+  description: "Icon style direction and usage philosophy"
+  fields:
+    - name: style_direction
+      type: string
+      description: "Outlined, filled, duotone, etc."
+    - name: stroke_weight
+      type: string
+      description: "Consistent stroke weight for icon set"
+    - name: metaphor_guidelines
+      type: array
+      description: "Guidelines for icon metaphor selection"
+
+rules:
+  - id: brand-before-tokens
+    text: "Brandbook MUST be completed before design tokens are defined."
+    priority: critical
+  - id: brand-consistency
+    text: "All visual decisions must trace back to brandbook principles."
+    priority: high
+  - id: brand-voice-artifacts
+    text: "All user-facing text in artifacts must follow brand voice guidelines."
+    priority: high

package/framework/templates/component-spec-tmpl.yaml

@@ -0,0 +1,74 @@
+# Component Spec Template
+# Used by: UX Agent (Phase 2: Component Specifications)
+# Language: English (Constitution Article VII)
+
+template:
+  name: Component Spec
+  version: "1.0.0"
+  description: >
+    UI component specification document. Defines variants, states,
+    anatomy, props, accessibility, and responsive behavior.
+
+output_path: chati.dev/artifacts/4-UX/components/
+
+fields:
+  - name: id
+    type: string
+    description: "Unique component identifier (kebab-case)"
+    required: true
+  - name: name
+    type: string
+    description: "Human-readable component name"
+    required: true
+  - name: category
+    type: enum
+    values: [primitive, composite, layout, feedback, navigation, data-display, form]
+    description: "Component category for organization"
+    required: true
+  - name: description
+    type: string
+    description: "One-sentence description of the component purpose"
+    required: true
+  - name: variants
+    type: array
+    description: "Visual variants (primary, secondary, ghost, destructive, etc.)"
+    required: true
+  - name: sizes
+    type: array
+    description: "Size variants (xs, sm, md, lg, xl)"
+    required: true
+  - name: states
+    type: array
+    description: "Interactive states (default, hover, active, focus, disabled, loading, error)"
+    required: true
+  - name: anatomy
+    type: object
+    description: "Component parts and their structure"
+    required: true
+  - name: props
+    type: array
+    description: "Component API (props with types, defaults, descriptions)"
+    required: true
+  - name: tokens_used
+    type: array
+    description: "Design tokens consumed by this component"
+    required: true
+  - name: accessibility
+    type: object
+    description: "ARIA roles, keyboard navigation, screen reader behavior"
+    required: true
+  - name: responsive_behavior
+    type: object
+    description: "How component adapts across breakpoints"
+    required: false
+
+rules:
+  - id: tokens-required
+    text: "Every visual property MUST reference a design token. No hardcoded values."
+    priority: critical
+  - id: accessibility-required
+    text: "Every component MUST have ARIA roles and keyboard navigation defined."
+    priority: critical
+  - id: state-coverage
+    text: "All interactive states must be specified including disabled and loading."
+    priority: high

package/framework/templates/design-token-tmpl.yaml

@@ -0,0 +1,55 @@
+# Design Token Template
+# Used by: UX Agent (Phase 1: Design Tokens)
+# Language: English (Constitution Article VII)
+
+template:
+  name: Design Tokens
+  version: "1.0.0"
+  description: >
+    Structured design token system with 4 layers: primitive, semantic,
+    component, and utility. Derived from brandbook decisions.
+
+output_path: chati.dev/artifacts/4-UX/design-tokens.md
+
+layers:
+  - primitive
+  - semantic
+  - component
+  - utility
+
+token_categories:
+  color:
+    primitive: "Raw color values (hex, hsl)"
+    semantic: "Mapped to meaning (primary, success, error)"
+    component: "Component-specific (button-bg, card-border)"
+  spacing:
+    primitive: "Base unit multiples (4, 8, 12, 16, 24, 32, 48, 64)"
+    semantic: "Mapped to usage (compact, default, relaxed)"
+    component: "Component-specific (card-padding, input-gap)"
+  typography:
+    primitive: "Font families, raw sizes, weights"
+    semantic: "Mapped to roles (heading, body, caption, label)"
+    component: "Component-specific (button-text, input-label)"
+  radius:
+    primitive: "Raw radius values (0, 2, 4, 8, 12, full)"
+    semantic: "Mapped to shape intent (sharp, soft, round, pill)"
+  shadow:
+    primitive: "Raw shadow definitions (offset, blur, spread, color)"
+    semantic: "Mapped to elevation (flat, raised, floating, overlay)"
+  motion:
+    primitive: "Duration and easing values"
+    semantic: "Mapped to intent (enter, exit, emphasis, feedback)"
+
+rules:
+  - id: tokens-after-brandbook
+    text: "Design tokens MUST be derived from brandbook decisions."
+    priority: critical
+  - id: primitive-first
+    text: "Define primitive tokens before semantic. Semantic references primitive."
+    priority: high
+  - id: token-naming
+    text: "Use consistent naming: layer-category-variant (e.g., color-primary-500)."
+    priority: high
+  - id: accessibility-contrast
+    text: "All text color tokens must meet WCAG AA contrast ratio (4.5:1)."
+    priority: critical

package/framework/templates/icon-system-tmpl.yaml

@@ -0,0 +1,95 @@
+# Icon System Template
+# Used by: UX Agent (Phase 0: Brand Identity / Iconography)
+# Language: English (Constitution Article VII)
+
+template:
+  name: Icon System
+  version: "1.0.0"
+  description: >
+    Icon library selection, sizing scale, usage guidelines, and inventory.
+    Aligned with brandbook iconography style.
+
+output_path: chati.dev/artifacts/4-UX/icon-system.md
+
+sections:
+  library_selection:
+    description: "Chosen icon library and rationale"
+    fields:
+      - name: library_name
+        type: string
+        description: "Selected icon library (e.g., Lucide, Phosphor, Heroicons)"
+      - name: rationale
+        type: string
+        description: "Why this library was chosen"
+      - name: style
+        type: enum
+        values: [outlined, filled, duotone, solid]
+        description: "Icon style variant"
+      - name: license
+        type: string
+        description: "Icon library license (MIT, Apache, etc.)"
+
+  sizing_scale:
+    description: "Icon size scale aligned with spacing tokens"
+    fields:
+      - name: xs
+        type: number
+        description: "Extra small icon size (12-14px)"
+      - name: sm
+        type: number
+        description: "Small icon size (16px)"
+      - name: md
+        type: number
+        description: "Medium icon size (20-24px)"
+      - name: lg
+        type: number
+        description: "Large icon size (28-32px)"
+      - name: xl
+        type: number
+        description: "Extra large icon size (40-48px)"
+      - name: xxl
+        type: number
+        description: "Display icon size (56-64px)"
+
+  usage_guidelines:
+    description: "Rules for consistent icon usage"
+    fields:
+      - name: with_text
+        type: string
+        description: "When to pair icons with text labels"
+      - name: standalone
+        type: string
+        description: "When icons can stand alone (with aria-label)"
+      - name: color_rules
+        type: string
+        description: "How icons inherit or override color tokens"
+      - name: touch_target
+        type: string
+        description: "Minimum touch target size (44x44px for mobile)"
+
+  icon_inventory:
+    description: "Catalog of icons used in the project"
+    fields:
+      - name: navigation
+        type: array
+        description: "Icons used in navigation elements"
+      - name: actions
+        type: array
+        description: "Icons for user actions (add, edit, delete, etc.)"
+      - name: status
+        type: array
+        description: "Icons for status indicators (success, warning, error, info)"
+      - name: content
+        type: array
+        description: "Icons for content types (file, folder, image, etc.)"
+
+rules:
+  - id: icon-library-consistency
+    text: "Use ONE icon library per project. Do not mix libraries."
+    priority: critical
+  - id: icon-accessibility
+    text: "Standalone icons MUST have aria-label. Decorative icons use aria-hidden."
+    priority: critical
+  - id: icon-sizing-alignment
+    text: "Icon sizes must align with the spacing token scale from design tokens."
+    priority: high

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chati-dev",
-  "version": "4.0.0",
+  "version": "4.0.1",
   "description": "AI-Powered Multi-Agent Orchestration System — Structured vibe coding for Full Stack Development",
   "type": "module",
   "bin": {

package/scripts/bundle-framework.js

@@ -37,7 +37,7 @@ const dirs = [
   'schemas', 'frameworks', 'intelligence', 'patterns',
   'hooks', 'domains',
   'i18n', 'migrations', 'data',
-  'tasks', 'context',
+  'tasks', 'context', 'presets',
 ];
 
 for (const dir of dirs) {

package/src/intelligence/decision-engine.js

@@ -10,7 +10,7 @@
  */
 
 import { existsSync, readFileSync } from 'fs';
-import { join } from 'path';
+
 
 /**
  * @typedef {object} DecisionIntent
@@ -198,7 +198,7 @@ export function parseRegistryEntities(raw) {
 
   for (const line of lines) {
     // Category header (agents:, templates:, etc.) — 2-space indent under entities:
-    const categoryMatch = line.match(/^  (\w[\w-]*):\s*$/);
+    const categoryMatch = line.match(/^ {2}(\w[\w-]*):\s*$/);
     if (categoryMatch && !line.match(/^\s{4}/)) {
       // Save previous entity
       if (currentEntity && currentData.purpose) {
@@ -211,7 +211,7 @@ export function parseRegistryEntities(raw) {
     }
 
     // Entity header (e.g., "    orchestrator:") — 4-space indent
-    const entityMatch = line.match(/^    ([\w][\w-]*):\s*$/);
+    const entityMatch = line.match(/^ {4}([\w][\w-]*):\s*$/);
     if (entityMatch) {
       // Save previous entity
       if (currentEntity && currentData.purpose) {