chati-dev 2.0.8 → 2.1.0

package/framework/tasks/orchestrator-suggest-mode.md

@@ -48,7 +48,7 @@ For each potential transition, check requirements:
 **For planning → build**:
 - QA-Planning agent status = `completed`
 - QA-Planning score >= 95%
-- All PLANNING agents completed or skipped
+- All DISCOVER/PLAN agents completed or skipped
 - No blocking issues in planning phase
 
 **For build → validate**:
@@ -208,7 +208,7 @@ mode_suggestion:
 
   current_state:
     mode: "planning"
-    phase: "PLANNING"
+    phase: "PLAN"
     last_completed_agent: "qa-planning"
     last_activity: "2026-02-13T15:30:00Z"
 
@@ -271,7 +271,7 @@ mode_suggestion:
     approved_by: "autonomous"
     rationale: |
       QA-Planning completed with excellent score (97.5% vs 95% required).
-      All PLANNING agents complete. No blockers. High confidence (95%).
+      All DISCOVER/PLAN agents complete. No blockers. High confidence (95%).
       Article XI allows autonomous transition. Auto-executing.
 
   execution:
@@ -282,7 +282,7 @@ mode_suggestion:
   user_notification: |
     ✓ Autonomous Mode Transition
 
-    PLANNING → BUILD
+    PLAN → BUILD
 
     QA-Planning completed with score 97.5% (>= 95% required).
     Confidence: 95% (high)
@@ -321,14 +321,14 @@ mode_suggestion:
       3 open questions reduce confidence. Suggesting to user.
 
   user_prompt: |
-    Mode Transition Available: PLANNING → BUILD
+    Mode Transition Available: PLAN → BUILD
 
     QA-Planning completed with score 96.5% (>= 95% required).
     Confidence: 87% (strong suggestion)
 
     Considerations:
     ✓ Quality score exceeds threshold
-    ✓ All PLANNING agents complete
+    ✓ All DISCOVER/PLAN agents complete
     ⚠ 3 open questions remain (non-blocking)
 
     Proceed with transition to BUILD mode? (yes/no)
@@ -358,7 +358,7 @@ mode_suggestion:
   user_notification: |
     Mode Transition: Not Ready
 
-    QA-Planning score: 92% (95% required for PLANNING → BUILD)
+    QA-Planning score: 92% (95% required for PLAN → BUILD)
 
     To proceed:
     1. Address planning issues identified by QA-Planning

package/framework/tasks/phases-breakdown.md

@@ -2,7 +2,7 @@
 id: phases-breakdown
 agent: phases
 trigger: architect
-phase: planning
+phase: plan
 requires_input: false
 parallelizable: false
 outputs: [phases.yaml]

package/framework/tasks/phases-dependency-mapping.md

@@ -2,7 +2,7 @@
 id: phases-dependency-mapping
 agent: phases
 trigger: phases-breakdown
-phase: planning
+phase: plan
 requires_input: false
 parallelizable: false
 outputs: [dependency-map.yaml]

package/framework/tasks/phases-mvp-scoping.md

@@ -2,7 +2,7 @@
 id: phases-mvp-scoping
 agent: phases
 trigger: phases-dependency-mapping
-phase: planning
+phase: plan
 requires_input: false
 parallelizable: false
 outputs: [mvp-scope.yaml]

package/framework/tasks/qa-impl-consolidate.md

@@ -2,7 +2,7 @@
 id: qa-impl-consolidate
 agent: qa-implementation
 trigger: qa-impl-verdict
-phase: validate
+phase: build
 requires_input: false
 parallelizable: false
 outputs: [qa-implementation-report.yaml]
@@ -142,7 +142,7 @@ Compile the final QA implementation report synthesizing all testing, analysis, a
 version: 1.0.0
 created: YYYY-MM-DD
 agent: qa-implementation
-phase: validate
+phase: build
 
 executive_summary:
   verdict: PASS # PASS, FAIL, CONDITIONAL

package/framework/tasks/qa-impl-verdict.md

@@ -2,7 +2,7 @@
 id: qa-impl-verdict
 agent: qa-implementation
 trigger: qa-impl-performance-test
-phase: validate
+phase: build
 requires_input: false
 parallelizable: false
 outputs: [qa-verdict.yaml]
@@ -148,7 +148,7 @@ Issue the final QA verdict by synthesizing all QA implementation results (tests,
 version: 1.0.0
 created: YYYY-MM-DD
 agent: qa-implementation
-phase: validate
+phase: build
 
 verdict: PASS # PASS, FAIL, CONDITIONAL
 

package/framework/tasks/qa-planning-consolidate.md

@@ -2,7 +2,7 @@
 id: qa-planning-consolidate
 agent: qa-planning
 trigger: qa-planning-risk-matrix
-phase: planning
+phase: plan
 requires_input: false
 parallelizable: false
 outputs: [qa-plan.yaml]

package/framework/tasks/qa-planning-coverage-plan.md

@@ -2,7 +2,7 @@
 id: qa-planning-coverage-plan
 agent: qa-planning
 trigger: qa-planning-gate-define
-phase: planning
+phase: plan
 requires_input: false
 parallelizable: false
 outputs: [coverage-plan.yaml]
@@ -166,7 +166,7 @@ modules:
     files:
       - chati.dev/orchestrator.js
       - chati.dev/mode-governance.js
-      - chati.dev/deviation-handler.js
+      - chati.dev/orchestrator/chati.md
     hard_to_test:
       - IDE detection: mock process.env and fs
       - User prompts: mock readline interface

package/framework/tasks/qa-planning-gate-define.md

@@ -2,7 +2,7 @@
 id: qa-planning-gate-define
 agent: qa-planning
 trigger: qa-planning-test-strategy
-phase: planning
+phase: plan
 requires_input: false
 parallelizable: false
 outputs: [quality-gates.yaml]

package/framework/tasks/qa-planning-risk-matrix.md

@@ -2,7 +2,7 @@
 id: qa-planning-risk-matrix
 agent: qa-planning
 trigger: qa-planning-coverage-plan
-phase: planning
+phase: plan
 requires_input: false
 parallelizable: false
 outputs: [risk-matrix.yaml]

package/framework/tasks/qa-planning-test-strategy.md

@@ -2,7 +2,7 @@
 id: qa-planning-test-strategy
 agent: qa-planning
 trigger: orchestrator
-phase: planning
+phase: plan
 requires_input: false
 parallelizable: false
 outputs: [test-strategy.yaml]

package/framework/tasks/tasks-acceptance-write.md

@@ -2,7 +2,7 @@
 id: tasks-acceptance-write
 agent: tasks
 trigger: tasks-estimate
-phase: planning
+phase: plan
 requires_input: false
 parallelizable: false
 outputs: [task-criteria.yaml]

package/framework/tasks/tasks-consolidate.md

@@ -2,7 +2,7 @@
 id: tasks-consolidate
 agent: tasks
 trigger: tasks-acceptance-write
-phase: planning
+phase: plan
 requires_input: false
 parallelizable: false
 outputs: [tasks-final.yaml]

package/framework/tasks/tasks-decompose.md

@@ -2,7 +2,7 @@
 id: tasks-decompose
 agent: tasks
 trigger: phases
-phase: planning
+phase: plan
 requires_input: false
 parallelizable: false
 outputs: [tasks-list.yaml]

package/framework/tasks/tasks-estimate.md

@@ -2,7 +2,7 @@
 id: tasks-estimate
 agent: tasks
 trigger: tasks-decompose
-phase: planning
+phase: plan
 requires_input: false
 parallelizable: false
 outputs: [estimates.yaml]

package/framework/tasks/ux-a11y-check.md

@@ -2,7 +2,7 @@
 id: ux-a11y-check
 agent: ux
 trigger: ux-component-map
-phase: planning
+phase: plan
 requires_input: false
 parallelizable: false
 outputs: [a11y-report.yaml]

package/framework/tasks/ux-component-map.md

@@ -2,7 +2,7 @@
 id: ux-component-map
 agent: ux
 trigger: ux-user-flow
-phase: planning
+phase: plan
 requires_input: false
 parallelizable: false
 outputs: [component-map.yaml]

package/framework/tasks/ux-consolidate.md

@@ -2,7 +2,7 @@
 id: ux-consolidate
 agent: ux
 trigger: ux-a11y-check
-phase: planning
+phase: plan
 requires_input: false
 parallelizable: false
 outputs: [ux-final.yaml]

package/framework/tasks/ux-user-flow.md

@@ -2,7 +2,7 @@
 id: ux-user-flow
 agent: ux
 trigger: ux-wireframe
-phase: planning
+phase: plan
 requires_input: false
 parallelizable: false
 outputs: [user-flows.yaml]

package/framework/tasks/ux-wireframe.md

@@ -2,7 +2,7 @@
 id: ux-wireframe
 agent: ux
 trigger: detail
-phase: planning
+phase: plan
 requires_input: false
 parallelizable: true
 outputs: [wireframes.yaml]

package/framework/templates/quick-brief-tmpl.yaml

@@ -0,0 +1,90 @@
+# Quick Brief Template
+# Used by: Brief Agent (quick-extraction mode via Quick Flow workflow)
+# Language: English (Constitution Article VII)
+
+template:
+  name: Quick Brief
+  version: "1.0.0"
+  description: >
+    Condensed brief for simple tasks (bug fixes, small features, config changes).
+    Single-pass extraction instead of the full 5-phase process.
+
+fields:
+  - name: description
+    type: string
+    description: "One-sentence description of the change"
+    required: true
+
+  - name: motivation
+    type: string
+    description: "Why this change is needed (bug report, user request, improvement)"
+    required: true
+
+  - name: scope
+    type: object
+    description: "Files and estimated scope of change"
+    required: true
+    fields:
+      - name: files_affected
+        type: array
+        description: "List of files expected to change"
+      - name: estimated_size
+        type: enum
+        values: [small, medium]
+        description: "small = 1-3 files, medium = 4-5 files"
+
+  - name: acceptance_criteria
+    type: array
+    description: "Given-When-Then acceptance criteria"
+    min_items: 1
+    required: true
+    item_format: "Given {precondition}, When {action}, Then {expected result}"
+
+  - name: constraints
+    type: array
+    description: "Any constraints or considerations"
+    required: false
+
+  - name: risk_assessment
+    type: object
+    description: "Quick risk check for quick-flow eligibility"
+    required: true
+    fields:
+      - name: complexity
+        type: enum
+        values: [low]
+        description: "Must be low for quick-flow"
+      - name: pipeline
+        type: string
+        value: "quick-flow"
+      - name: skipped_agents
+        type: array
+        value: [detail, architect, ux, phases, tasks, qa-planning]
+      - name: justification
+        type: string
+        description: "Why quick-flow is appropriate for this task"
+
+output_format: |
+  # Quick Brief — {description}
+
+  ## What
+  {One-sentence description of the change}
+
+  ## Why
+  {Motivation: bug report, user request, improvement}
+
+  ## Scope
+  - Files affected: {list}
+  - Estimated changes: {small/medium}
+
+  ## Acceptance Criteria
+  - Given {precondition}, When {action}, Then {expected result}
+
+  ## Constraints
+  - {Any constraints or considerations}
+
+  ## Risk Assessment
+  - Complexity: low
+  - Pipeline: quick-flow
+  - Skipped: Detail, Architect, UX, Phases, Tasks, QA-Planning
+  - Justification: {why quick-flow is appropriate}

package/framework/workflows/brownfield-discovery.yaml

@@ -15,7 +15,7 @@ workflow:
 phases:
   - phase: 0
     name: Context Detection
-    category: PLANNING
+    category: DISCOVER
     sequence:
       - agent: brownfield-wu
         action: context-detection
@@ -23,7 +23,7 @@ phases:
 
   - phase: 1
     name: Architecture Analysis
-    category: PLANNING
+    category: DISCOVER
     sequence:
       - agent: brownfield-wu
         action: architecture-scout
@@ -31,7 +31,7 @@ phases:
 
   - phase: 2
     name: UX Analysis
-    category: PLANNING
+    category: DISCOVER
     sequence:
       - agent: brownfield-wu
         action: ux-scout
@@ -39,7 +39,7 @@ phases:
 
   - phase: 3
     name: QA Analysis
-    category: PLANNING
+    category: DISCOVER
     sequence:
       - agent: brownfield-wu
         action: qa-scout
@@ -47,7 +47,7 @@ phases:
 
   - phase: 4
     name: Integration Mapping
-    category: PLANNING
+    category: DISCOVER
     sequence:
       - agent: brownfield-wu
         action: integration-mapping
@@ -55,7 +55,7 @@ phases:
 
   - phase: 5
     name: Technical Debt Assessment
-    category: PLANNING
+    category: DISCOVER
     sequence:
       - agent: brownfield-wu
         action: tech-debt-assessment
@@ -63,7 +63,7 @@ phases:
 
   - phase: 6
     name: Synthesis
-    category: PLANNING
+    category: DISCOVER
     sequence:
       - agent: brownfield-wu
         action: compile-report

package/framework/workflows/brownfield-fullstack.yaml

@@ -15,7 +15,7 @@ workflow:
 phases:
   - phase: 0
     name: Deep Discovery
-    category: PLANNING
+    category: DISCOVER
     sequence:
       - agent: brownfield-wu
         action: full-discovery
@@ -26,7 +26,7 @@ phases:
 
   - phase: 1
     name: Problem Definition
-    category: PLANNING
+    category: DISCOVER
     sequence:
       - agent: brief
         action: problem-extraction
@@ -35,7 +35,7 @@ phases:
 
   - phase: 2
     name: Architecture Assessment
-    category: PLANNING
+    category: PLAN
     sequence:
       - agent: architect
         action: assess-architecture
@@ -47,7 +47,7 @@ phases:
 
   - phase: 3
     name: Product Specification
-    category: PLANNING
+    category: PLAN
     sequence:
       - agent: detail
         action: create-prd
@@ -61,7 +61,7 @@ phases:
 
   - phase: 4
     name: Execution Planning
-    category: PLANNING
+    category: PLAN
     sequence:
       - agent: phases
         action: create-roadmap
@@ -73,7 +73,7 @@ phases:
 
   - phase: 5
     name: Planning Quality Gate
-    category: PLANNING
+    category: PLAN
     sequence:
       - agent: qa-planning
         action: validate-traceability
@@ -99,7 +99,11 @@ phases:
         creates: [chati.dev/artifacts/8-Validation/deploy-report.md]
 
 transitions:
-  planning_to_build:
+  discover_to_plan:
+    trigger: "brief.status == completed"
+    type: automatic
+    action: "Update project.state = plan"
+  plan_to_build:
     trigger: "qa-planning.score >= 95"
     type: automatic
     action: "Update project.state = build"
@@ -107,15 +111,25 @@ transitions:
     trigger: "dev.status == completed"
     type: automatic
     action: "Update project.state = validate"
-  validate_to_deploy:
+  validate_to_preview:
     trigger: "qa-implementation.status == approved"
     type: automatic
+    action: "Launch user preview (orchestrator-preview task)"
+    notes: "User must approve preview before advancing to deploy"
+  preview_to_deploy:
+    trigger: "user_preview.decision in [approve_keep, approve_kill]"
+    type: manual
     action: "Update project.state = deploy"
+    notes: "User explicitly approves the preview"
   deploy_to_completed:
     trigger: "devops.status == completed"
     type: automatic
     action: "Update project.state = completed"
-  backward_to_planning:
+  backward_to_plan:
     trigger: "qa-implementation.issue_type in [spec, architecture]"
     type: backward
-    action: "Update project.state = planning, route to responsible agent"
+    action: "Update project.state = plan, route to responsible agent"
+  backward_to_discover:
+    trigger: "qa-implementation.issue_type in [requirements, scope]"
+    type: backward
+    action: "Update project.state = discover, route to brief or wu agent"

package/framework/workflows/brownfield-service.yaml

@@ -16,7 +16,7 @@ workflow:
 phases:
   - phase: 0
     name: Deep Discovery
-    category: PLANNING
+    category: DISCOVER
     sequence:
       - agent: brownfield-wu
         action: full-discovery
@@ -24,7 +24,7 @@ phases:
 
   - phase: 1
     name: Problem Definition
-    category: PLANNING
+    category: DISCOVER
     sequence:
       - agent: brief
         action: problem-extraction
@@ -32,7 +32,7 @@ phases:
 
   - phase: 2
     name: Architecture & Specification
-    category: PLANNING
+    category: PLAN
     sequence:
       - agent: architect
         action: assess-architecture
@@ -45,7 +45,7 @@ phases:
 
   - phase: 3
     name: Execution Planning
-    category: PLANNING
+    category: PLAN
     sequence:
       - agent: phases
         action: create-roadmap
@@ -56,7 +56,7 @@ phases:
 
   - phase: 4
     name: Planning Quality Gate
-    category: PLANNING
+    category: PLAN
     sequence:
       - agent: qa-planning
         action: validate-traceability
@@ -79,3 +79,39 @@ phases:
       - agent: devops
         action: deploy
         creates: [chati.dev/artifacts/8-Validation/deploy-report.md]
+
+transitions:
+  discover_to_plan:
+    trigger: "brief.status == completed"
+    type: automatic
+    action: "Update project.state = plan"
+  plan_to_build:
+    trigger: "qa-planning.score >= 95"
+    type: automatic
+    action: "Update project.state = build"
+  build_to_validate:
+    trigger: "dev.status == completed"
+    type: automatic
+    action: "Update project.state = validate"
+  validate_to_preview:
+    trigger: "qa-implementation.status == approved"
+    type: automatic
+    action: "Launch user preview (orchestrator-preview task)"
+    notes: "User must approve preview before advancing to deploy"
+  preview_to_deploy:
+    trigger: "user_preview.decision in [approve_keep, approve_kill]"
+    type: manual
+    action: "Update project.state = deploy"
+    notes: "User explicitly approves the preview"
+  deploy_to_completed:
+    trigger: "devops.status == completed"
+    type: automatic
+    action: "Update project.state = completed"
+  backward_to_plan:
+    trigger: "qa-implementation.issue_type in [spec, architecture]"
+    type: backward
+    action: "Update project.state = plan, route to responsible agent"
+  backward_to_discover:
+    trigger: "qa-implementation.issue_type in [requirements, scope]"
+    type: backward
+    action: "Update project.state = discover, route to brief or wu agent"

package/framework/workflows/brownfield-ui.yaml

@@ -16,7 +16,7 @@ workflow:
 phases:
   - phase: 0
     name: Deep Discovery
-    category: PLANNING
+    category: DISCOVER
     sequence:
       - agent: brownfield-wu
         action: full-discovery
@@ -25,7 +25,7 @@ phases:
 
   - phase: 1
     name: Problem Definition
-    category: PLANNING
+    category: DISCOVER
     sequence:
       - agent: brief
         action: problem-extraction
@@ -33,7 +33,7 @@ phases:
 
   - phase: 2
     name: Architecture & Experience
-    category: PLANNING
+    category: PLAN
     sequence:
       - agent: architect
         action: assess-architecture
@@ -50,7 +50,7 @@ phases:
 
   - phase: 3
     name: Execution Planning
-    category: PLANNING
+    category: PLAN
     sequence:
       - agent: phases
         action: create-roadmap
@@ -61,7 +61,7 @@ phases:
 
   - phase: 4
     name: Planning Quality Gate
-    category: PLANNING
+    category: PLAN
     sequence:
       - agent: qa-planning
         action: validate-traceability
@@ -85,3 +85,39 @@ phases:
       - agent: devops
         action: deploy
         creates: [chati.dev/artifacts/8-Validation/deploy-report.md]
+
+transitions:
+  discover_to_plan:
+    trigger: "brief.status == completed"
+    type: automatic
+    action: "Update project.state = plan"
+  plan_to_build:
+    trigger: "qa-planning.score >= 95"
+    type: automatic
+    action: "Update project.state = build"
+  build_to_validate:
+    trigger: "dev.status == completed"
+    type: automatic
+    action: "Update project.state = validate"
+  validate_to_preview:
+    trigger: "qa-implementation.status == approved"
+    type: automatic
+    action: "Launch user preview (orchestrator-preview task)"
+    notes: "User must approve preview before advancing to deploy"
+  preview_to_deploy:
+    trigger: "user_preview.decision in [approve_keep, approve_kill]"
+    type: manual
+    action: "Update project.state = deploy"
+    notes: "User explicitly approves the preview"
+  deploy_to_completed:
+    trigger: "devops.status == completed"
+    type: automatic
+    action: "Update project.state = completed"
+  backward_to_plan:
+    trigger: "qa-implementation.issue_type in [spec, architecture]"
+    type: backward
+    action: "Update project.state = plan, route to responsible agent"
+  backward_to_discover:
+    trigger: "qa-implementation.issue_type in [requirements, scope]"
+    type: backward
+    action: "Update project.state = discover, route to brief or wu agent"