chati-dev 2.0.5 → 2.0.6

package/framework/orchestrator/chati.md

@@ -96,7 +96,7 @@ If not already set in session.yaml:
 project:
   name: "{detected or asked}"
   type: greenfield | brownfield
-  state: clarity
+  state: planning
 execution_mode: interactive
 current_agent: greenfield-wu | brownfield-wu
 language: "{detected}"
@@ -106,8 +106,8 @@ user_level_confidence: 0.0
 
 #### 3d. Route to First Agent
 ```
-If greenfield -> Read chati.dev/agents/clarity/greenfield-wu.md -> Activate
-If brownfield -> Read chati.dev/agents/clarity/brownfield-wu.md -> Activate
+If greenfield -> Read chati.dev/agents/planning/greenfield-wu.md -> Activate
+If brownfield -> Read chati.dev/agents/planning/brownfield-wu.md -> Activate
 ```
 
 ### Step 5: Session Resume
@@ -144,14 +144,14 @@ brownfield-wu -> Brief -> Architect -> Detail -> UX -> Phases -> Tasks -> QA-Pla
 ### Agent Location Map
 | Agent | File |
 |-------|------|
-| greenfield-wu | chati.dev/agents/clarity/greenfield-wu.md |
-| brownfield-wu | chati.dev/agents/clarity/brownfield-wu.md |
-| brief | chati.dev/agents/clarity/brief.md |
-| detail | chati.dev/agents/clarity/detail.md |
-| architect | chati.dev/agents/clarity/architect.md |
-| ux | chati.dev/agents/clarity/ux.md |
-| phases | chati.dev/agents/clarity/phases.md |
-| tasks | chati.dev/agents/clarity/tasks.md |
+| greenfield-wu | chati.dev/agents/planning/greenfield-wu.md |
+| brownfield-wu | chati.dev/agents/planning/brownfield-wu.md |
+| brief | chati.dev/agents/planning/brief.md |
+| detail | chati.dev/agents/planning/detail.md |
+| architect | chati.dev/agents/planning/architect.md |
+| ux | chati.dev/agents/planning/ux.md |
+| phases | chati.dev/agents/planning/phases.md |
+| tasks | chati.dev/agents/planning/tasks.md |
 | qa-planning | chati.dev/agents/quality/qa-planning.md |
 | dev | chati.dev/agents/build/dev.md |
 | qa-implementation | chati.dev/agents/quality/qa-implementation.md |
@@ -167,7 +167,7 @@ When an agent completes (score >= 95%):
   4. Orchestrator identifies next agent from pipeline
   5. Update session.yaml: current_agent = next_agent
   6. Update project.state if crossing macro-phase boundary:
-     - WU through QA-Planning = clarity
+     - WU through QA-Planning = planning
      - Dev + QA-Implementation = build
      - Final validation = validate
      - DevOps = deploy
@@ -230,7 +230,7 @@ For autonomous agents:
   ╔══════════════════════════════════════════════════════════════╗
   ║ PARALLELIZATION CHECK (MANDATORY — DO NOT SKIP)             ║
   ║                                                             ║
-  ║ GROUP 1 — Clarity Phase (after Brief completes):            ║
+  ║ GROUP 1 — Planning Phase (after Brief completes):           ║
   ║   Agents: [detail, architect, ux]                           ║
   ║   ALL run in parallel via separate terminals                ║
   ║                                                             ║
@@ -344,7 +344,7 @@ model_selections:
 Before any agent writes a file, the orchestrator validates the operation against the current mode:
 
 ```
-If project.state == "clarity":
+If project.state == "planning":
   ALLOW write to: chati.dev/**, .chati/**
   BLOCK write to: everything else
   ALLOW read: everything (essential for brownfield-wu codebase analysis)
@@ -364,13 +364,13 @@ If project.state == "deploy":
 Mode transitions are AUTOMATIC based on quality gate results. The orchestrator executes the transition when the trigger condition is met.
 
 ```
-clarity -> build:
+planning -> build:
   TRIGGER: qa-planning agent completes with score >= 95%
   ACTION:
     1. Update project.state = "build"
     2. Log transition in session.yaml mode_transitions:
        - timestamp: "{now}"
-         from: clarity
+         from: planning
          to: build
          trigger: "qa-planning completed with score {score}%"
          type: automatic
@@ -403,12 +403,12 @@ deploy -> completed:
 ### Backward Transitions
 
 ```
-build/validate -> clarity:
+build/validate -> planning:
   TRIGGER: qa-implementation classifies issue as:
     - issue_type: "spec" (requirement gap, ambiguity, conflict)
     - issue_type: "architecture" (design flaw, missing component)
   ACTION:
-    1. Update project.state = "clarity"
+    1. Update project.state = "planning"
     2. Log backward transition in mode_transitions:
        - type: backward
          reason: "{QA finding description}"
@@ -432,8 +432,8 @@ When user requests to skip phases (e.g., "I need to code this NOW"):
 ```
 1. Orchestrator detects intent to change mode
 2. Inform user of current state and what will be skipped:
-   "You're in CLARITY mode. Skipping to BUILD will bypass:
-    - {list of pending CLARITY agents}
+   "You're in PLANNING mode. Skipping to BUILD will bypass:
+    - {list of pending PLANNING agents}
     Artifacts from these agents will not be generated."
 3. Request explicit confirmation
 4. If confirmed:
@@ -445,7 +445,7 @@ When user requests to skip phases (e.g., "I need to code this NOW"):
    - Mark skipped agents as "skipped" in session.yaml (not "completed")
    - Continue with target agent
 5. After override session completes, suggest:
-   "You skipped CLARITY phases. Want to go back and complete planning?"
+   "You skipped PLANNING phases. Want to go back and complete planning?"
 ```
 
 ---
@@ -550,7 +550,7 @@ Display project status dashboard:
   Phase: {state}           Mode: {execution_mode}
   Language: {language}     IDE: {ides}
 
-  CLARITY:
+  PLANNING:
     WU: {score}  Brief: {score}  Detail: {score}  Arch: {score}
     UX: {score}  Phases: {score}  Tasks: {score}  QA-P: {score}
 
@@ -756,7 +756,7 @@ If agent fails repeatedly:
 ### Exclusive (only the orchestrator can do this)
 - Route user messages to agents
 - Activate/deactivate agents
-- Execute mode transitions (clarity -> build -> validate -> deploy)
+- Execute mode transitions (planning -> build -> validate -> deploy)
 - Manage session lock (activate/deactivate)
 - Handle deviations and re-routing
 - Manage backlog items
@@ -938,7 +938,7 @@ Level 4 - Graceful Degradation:
 1. **Single Entry Point**: The orchestrator is the ONLY way users interact with Chati.dev. No agent is directly accessible.
 2. **Transparent Routing**: Users should understand which agent is active and why, but never need to manage agents directly.
 3. **State Preservation**: Every state change is logged in session.yaml. No action is lossy.
-4. **Fail-Safe Defaults**: When uncertain, default to the most restrictive mode (clarity) and the safest agent.
+4. **Fail-Safe Defaults**: When uncertain, default to the most restrictive mode (planning) and the safest agent.
 5. **Progressive Disclosure**: Show complexity only when the user needs it. Start simple, reveal depth on demand.
 6. **Pipeline Respect**: Never skip pipeline steps without explicit user consent and documented risk.
 7. **Language Fidelity**: Interaction always in user's language. Artifacts always in English. No exceptions.

package/framework/quality-gates/planning-gate.md

@@ -1,7 +1,7 @@
 # Planning Quality Gate
 
 ## Purpose
-Validates traceability and consistency across all CLARITY artifacts before allowing transition to BUILD phase.
+Validates traceability and consistency across all PLANNING artifacts before allowing transition to BUILD phase.
 
 ## When
 After Tasks agent completes, before Dev agent starts.

package/framework/schemas/context.schema.json

@@ -14,7 +14,7 @@
       "description": "Summarized constitution content (always injected, L0 layer)"
     },
     "mode": {
-      "enum": ["clarity", "build", "deploy"],
+      "enum": ["planning", "build", "deploy"],
       "description": "Current execution mode from session state (L1 layer)"
     },
     "agent": {

package/framework/schemas/session.schema.json

@@ -11,7 +11,7 @@
       "properties": {
         "name": { "type": "string", "description": "Project name" },
         "type": { "enum": ["greenfield", "brownfield"], "description": "Project type" },
-        "state": { "enum": ["clarity", "build", "validate", "deploy", "completed"], "description": "Current pipeline macro-phase" }
+        "state": { "enum": ["planning", "build", "validate", "deploy", "completed"], "description": "Current pipeline macro-phase" }
       }
     },
     "execution_mode": {
@@ -122,8 +122,8 @@
         "required": ["timestamp", "from", "to", "trigger"],
         "properties": {
           "timestamp": { "type": "string", "format": "date-time" },
-          "from": { "enum": ["clarity", "build", "validate", "deploy", "completed"] },
-          "to": { "enum": ["clarity", "build", "validate", "deploy", "completed"] },
+          "from": { "enum": ["planning", "build", "validate", "deploy", "completed"] },
+          "to": { "enum": ["planning", "build", "validate", "deploy", "completed"] },
           "trigger": { "type": "string", "description": "What caused the transition (agent completion, override, backward)" },
           "type": { "enum": ["automatic", "backward", "override"], "description": "Transition classification" },
           "skipped_agents": {

package/framework/tasks/architect-api-design.md

@@ -2,7 +2,7 @@
 id: architect-api-design
 agent: architect
 trigger: architect-stack-selection
-phase: clarity
+phase: planning
 requires_input: false
 parallelizable: false
 outputs: [api-design.yaml]

package/framework/tasks/architect-consolidate.md

@@ -2,7 +2,7 @@
 id: architect-consolidate
 agent: architect
 trigger: architect-security-review
-phase: clarity
+phase: planning
 requires_input: false
 parallelizable: false
 outputs: [architecture-final.yaml]

package/framework/tasks/architect-db-design.md

@@ -2,7 +2,7 @@
 id: architect-db-design
 agent: architect
 trigger: architect-api-design
-phase: clarity
+phase: planning
 requires_input: false
 parallelizable: false
 outputs: [db-design.yaml]

package/framework/tasks/architect-design.md

@@ -2,7 +2,7 @@
 id: architect-design
 agent: architect
 trigger: detail
-phase: clarity
+phase: planning
 requires_input: false
 parallelizable: true
 outputs: [architecture.yaml]

package/framework/tasks/architect-security-review.md

@@ -2,7 +2,7 @@
 id: architect-security-review
 agent: architect
 trigger: architect-db-design
-phase: clarity
+phase: planning
 requires_input: false
 parallelizable: false
 outputs: [security-review.yaml]

package/framework/tasks/architect-stack-selection.md

@@ -2,7 +2,7 @@
 id: architect-stack-selection
 agent: architect
 trigger: architect-design
-phase: clarity
+phase: planning
 requires_input: false
 parallelizable: false
 outputs: [stack-selection.yaml]

package/framework/tasks/brief-consolidate.md

@@ -2,7 +2,7 @@
 id: brief-consolidate
 agent: brief
 trigger: brief-constraint-identify
-phase: clarity
+phase: planning
 requires_input: false
 parallelizable: false
 outputs: [brief.yaml]

package/framework/tasks/brief-constraint-identify.md

@@ -2,7 +2,7 @@
 id: brief-constraint-identify
 agent: brief
 trigger: brief-stakeholder-map
-phase: clarity
+phase: planning
 requires_input: true
 parallelizable: false
 outputs: [constraints.yaml]

package/framework/tasks/brief-extract-requirements.md

@@ -2,7 +2,7 @@
 id: brief-extract-requirements
 agent: brief
 trigger: orchestrator
-phase: clarity
+phase: planning
 requires_input: true
 parallelizable: false
 outputs: [requirements-raw.yaml]

package/framework/tasks/brief-stakeholder-map.md

@@ -2,7 +2,7 @@
 id: brief-stakeholder-map
 agent: brief
 trigger: brief-validate-completeness
-phase: clarity
+phase: planning
 requires_input: true
 parallelizable: false
 outputs: [stakeholder-map.yaml]

package/framework/tasks/brief-validate-completeness.md

@@ -2,7 +2,7 @@
 id: brief-validate-completeness
 agent: brief
 trigger: brief-extract-requirements
-phase: clarity
+phase: planning
 requires_input: true
 parallelizable: false
 outputs: [validation-report.yaml]

package/framework/tasks/brownfield-wu-architecture-map.md

@@ -2,7 +2,7 @@
 id: brownfield-wu-architecture-map
 agent: brownfield-wu
 trigger: brownfield-wu-dependency-scan
-phase: clarity
+phase: planning
 requires_input: false
 parallelizable: true
 outputs: [architecture-map.yaml]

package/framework/tasks/brownfield-wu-deep-discovery.md

@@ -2,7 +2,7 @@
 id: brownfield-wu-deep-discovery
 agent: brownfield-wu
 trigger: orchestrator
-phase: clarity
+phase: planning
 requires_input: false
 parallelizable: false
 outputs: [discovery.yaml]

package/framework/tasks/brownfield-wu-dependency-scan.md

@@ -2,7 +2,7 @@
 id: brownfield-wu-dependency-scan
 agent: brownfield-wu
 trigger: brownfield-wu-deep-discovery
-phase: clarity
+phase: planning
 requires_input: false
 parallelizable: true
 outputs: [dependencies.yaml]

package/framework/tasks/brownfield-wu-migration-plan.md

@@ -2,7 +2,7 @@
 id: brownfield-wu-migration-plan
 agent: brownfield-wu
 trigger: brownfield-wu-risk-assess
-phase: clarity
+phase: planning
 requires_input: true
 parallelizable: false
 outputs: [migration-plan.yaml]

package/framework/tasks/brownfield-wu-report.md

@@ -2,7 +2,7 @@
 id: brownfield-wu-report
 agent: brownfield-wu
 trigger: brownfield-wu-migration-plan
-phase: clarity
+phase: planning
 requires_input: false
 parallelizable: false
 outputs: [wu-report.yaml]

package/framework/tasks/brownfield-wu-risk-assess.md

@@ -2,7 +2,7 @@
 id: brownfield-wu-risk-assess
 agent: brownfield-wu
 trigger: brownfield-wu-architecture-map
-phase: clarity
+phase: planning
 requires_input: false
 parallelizable: false
 outputs: [risk-assessment.yaml]

package/framework/tasks/detail-acceptance-criteria.md

@@ -2,7 +2,7 @@
 id: detail-acceptance-criteria
 agent: detail
 trigger: detail-edge-case-analysis
-phase: clarity
+phase: planning
 requires_input: false
 parallelizable: false
 outputs: [acceptance-criteria.yaml]

package/framework/tasks/detail-consolidate.md

@@ -2,7 +2,7 @@
 id: detail-consolidate
 agent: detail
 trigger: detail-acceptance-criteria
-phase: clarity
+phase: planning
 requires_input: false
 parallelizable: false
 outputs: [prd.yaml]

package/framework/tasks/detail-edge-case-analysis.md

@@ -2,7 +2,7 @@
 id: detail-edge-case-analysis
 agent: detail
 trigger: detail-nfr-extraction
-phase: clarity
+phase: planning
 requires_input: false
 parallelizable: true
 outputs: [edge-cases.yaml]

package/framework/tasks/detail-expand-prd.md

@@ -2,7 +2,7 @@
 id: detail-expand-prd
 agent: detail
 trigger: brief
-phase: clarity
+phase: planning
 requires_input: false
 parallelizable: false
 outputs: [prd-draft.yaml]

package/framework/tasks/detail-nfr-extraction.md

@@ -2,7 +2,7 @@
 id: detail-nfr-extraction
 agent: detail
 trigger: detail-expand-prd
-phase: clarity
+phase: planning
 requires_input: false
 parallelizable: true
 outputs: [nfr.yaml]

package/framework/tasks/greenfield-wu-analyze-empty.md

@@ -2,7 +2,7 @@
 id: greenfield-wu-analyze-empty
 agent: greenfield-wu
 trigger: orchestrator
-phase: clarity
+phase: planning
 requires_input: false
 parallelizable: false
 outputs: [wu-analysis.yaml]

package/framework/tasks/greenfield-wu-report.md

@@ -2,7 +2,7 @@
 id: greenfield-wu-report
 agent: greenfield-wu
 trigger: greenfield-wu-tech-stack-assess
-phase: clarity
+phase: planning
 requires_input: false
 parallelizable: false
 outputs: [wu-report.yaml]

package/framework/tasks/greenfield-wu-scaffold-detection.md

@@ -2,7 +2,7 @@
 id: greenfield-wu-scaffold-detection
 agent: greenfield-wu
 trigger: greenfield-wu-analyze-empty
-phase: clarity
+phase: planning
 requires_input: false
 parallelizable: false
 outputs: [scaffold-report.yaml]

package/framework/tasks/greenfield-wu-tech-stack-assess.md

@@ -2,7 +2,7 @@
 id: greenfield-wu-tech-stack-assess
 agent: greenfield-wu
 trigger: greenfield-wu-scaffold-detection
-phase: clarity
+phase: planning
 requires_input: true
 parallelizable: false
 outputs: [tech-stack.yaml]

package/framework/tasks/orchestrator-deviation.md

@@ -54,8 +54,8 @@ Identify which artifacts are impacted:
 ### 4. Assess Impact Scope
 Evaluate the ripple effects:
 - **Localized**: Change affects only current/next agent
-- **Phase-wide**: Change affects current phase (e.g., all of CLARITY)
-- **Mode-wide**: Change affects entire mode (e.g., clarity → build transition)
+- **Phase-wide**: Change affects current phase (e.g., all of PLANNING)
+- **Mode-wide**: Change affects entire mode (e.g., planning → build transition)
 - **Global**: Change affects entire project plan
 
 ### 5. Determine Required Rework
@@ -172,7 +172,7 @@ deviation_plan:
     urgency: "medium"
 
   impact_assessment:
-    scope: "phase-wide"  # Affects multiple CLARITY agents
+    scope: "phase-wide"  # Affects multiple PLANNING agents
     affected_agents:
       - agent: "detail"
         status: "completed"

package/framework/tasks/orchestrator-escalate.md

@@ -190,8 +190,8 @@ escalation_report:
 
     context:
       previous_agent: "detail"
-      session_mode: "clarity"
-      pipeline_position: "CLARITY/architect"
+      session_mode: "planning"
+      pipeline_position: "PLANNING/architect"
 
   root_cause_analysis:
     primary_cause: "dependency-missing"

package/framework/tasks/orchestrator-handoff.md

@@ -77,14 +77,14 @@ Modify `.chati/session.yaml`:
 
 ### 7. Determine Next Agent
 Based on pipeline position and mode:
-- **CLARITY**: Follow sequence (wu → brief → detail → architect → ux → phases → tasks → qa-planning)
+- **PLANNING**: Follow sequence (wu → brief → detail → architect → ux → phases → tasks → qa-planning)
 - **BUILD**: dev → qa-implementation
 - **DEPLOY**: devops
 - Handle special transitions (e.g., qa-planning → dev requires mode switch)
 
 ### 8. Check Quality Gates
 Evaluate if mode transition should occur:
-- **After QA-Planning**: If score >= 95%, eligible for clarity → build
+- **After QA-Planning**: If score >= 95%, eligible for planning → build
 - **After Dev**: If complete, eligible for build → validate
 - **After QA-Implementation**: If approved, eligible for validate → deploy
 
@@ -170,8 +170,8 @@ handoff_document:
     status: "completed"
     quality_score: 8.5
     duration_minutes: 45
-    mode: "clarity"
-    phase: "CLARITY"
+    mode: "planning"
+    phase: "PLANNING"
 
   summary: |
     Completed detailed requirements analysis for HealthCare Portal.
@@ -228,14 +228,14 @@ handoff_document:
 
   session_update:
     agent_status: "completed"
-    pipeline_progress: 37.5  # 3 of 8 CLARITY agents done
+    pipeline_progress: 37.5  # 3 of 8 PLANNING agents done
     mode_transition_check:
       eligible: false
       reason: "QA-Planning not yet complete"
 
   routing_decision:
     next_action: "route-to-architect"
-    mode: "clarity"
+    mode: "planning"
     context_package:
       - ".chati/artifacts/handoffs/2026-02-13-detail.md"
       - ".chati/artifacts/handoffs/2026-02-12-brief.md"

package/framework/tasks/orchestrator-health.md

@@ -282,7 +282,7 @@ health_report:
     status: "healthy"
     articles_present: 11
     article_xi_valid: true
-    mode_definitions: ["clarity", "build", "deploy"]
+    mode_definitions: ["planning", "build", "deploy"]
     transition_rules_defined: true
     quality_gates_specified: true