chati-dev 2.0.4 → 2.0.6

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: clarity
+phase: planning
 requires_input: false
 parallelizable: false
 outputs: [quality-gates.yaml]
@@ -21,17 +21,17 @@ Define quality gates and enforcement thresholds for each stage of the chati.dev
 
 ## Prerequisites
 - test-strategy.yaml completed with testing approach
-- Phase plan showing pipeline stages (clarity → build → validate → deploy)
+- Phase plan showing pipeline stages (planning → build → validate → deploy)
 - Understanding of mode governance rules from constitution
 - Risk matrix inputs (will be formalized in later task)
 
 ## Steps
 
 1. **Review Pipeline Architecture**
-   - Identify all pipeline stages: clarity (8 agents), build (dev + qa-impl), validate (qa-impl verdict), deploy (devops)
+   - Identify all pipeline stages: planning (8 agents), build (dev + qa-impl), validate (qa-impl verdict), deploy (devops)
    - Map agent handoff points where quality checks occur
    - Note autonomous transition triggers (qa-planning → dev at 95%, qa-impl verdict → devops on PASS)
-   - Identify backward transition scenarios (build → clarity when spec issues found)
+   - Identify backward transition scenarios (build → planning when spec issues found)
 
 2. **Define Pre-Commit Gates**
    - **Unit Test Pass Rate**: 100% (all unit tests must pass)
@@ -41,8 +41,8 @@ Define quality gates and enforcement thresholds for each stage of the chati.dev
    - **Enforcement**: Git pre-commit hooks
    - **Bypass**: Not allowed (ensures baseline quality)
 
-3. **Define Clarity Phase Gates**
-   - **Agent Completion**: All 8 clarity agents must complete (greenfield-wu/brownfield-wu → brief → detail → architect → ux → phases → tasks → qa-planning)
+3. **Define Planning Phase Gates**
+   - **Agent Completion**: All 8 planning agents must complete (greenfield-wu/brownfield-wu → brief → detail → architect → ux → phases → tasks → qa-planning)
    - **Specification Completeness**: 100% of required sections filled
    - **QA Planning Score**: >= 95% for autonomous transition to build phase
    - **Manual Override**: Available if score 90-94% with justification
@@ -161,7 +161,7 @@ pipeline_stages:
         enforcement: tsc --noEmit
         bypass: not_allowed
 
-  clarity:
+  planning:
     gates:
       - name: Agent Completion
         threshold: 8/8 agents complete

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: clarity
+phase: planning
 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: clarity
+phase: planning
 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: clarity
+phase: planning
 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: clarity
+phase: planning
 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: clarity
+phase: planning
 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: clarity
+phase: planning
 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: clarity
+phase: planning
 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: clarity
+phase: planning
 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: clarity
+phase: planning
 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: clarity
+phase: planning
 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: clarity
+phase: planning
 requires_input: false
 parallelizable: true
 outputs: [wireframes.yaml]

package/framework/workflows/brownfield-discovery.yaml

@@ -15,7 +15,7 @@ workflow:
 phases:
   - phase: 0
     name: Context Detection
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: brownfield-wu
         action: context-detection
@@ -23,7 +23,7 @@ phases:
 
   - phase: 1
     name: Architecture Analysis
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: brownfield-wu
         action: architecture-scout
@@ -31,7 +31,7 @@ phases:
 
   - phase: 2
     name: UX Analysis
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: brownfield-wu
         action: ux-scout
@@ -39,7 +39,7 @@ phases:
 
   - phase: 3
     name: QA Analysis
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: brownfield-wu
         action: qa-scout
@@ -47,7 +47,7 @@ phases:
 
   - phase: 4
     name: Integration Mapping
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: brownfield-wu
         action: integration-mapping
@@ -55,7 +55,7 @@ phases:
 
   - phase: 5
     name: Technical Debt Assessment
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: brownfield-wu
         action: tech-debt-assessment
@@ -63,7 +63,7 @@ phases:
 
   - phase: 6
     name: Synthesis
-    category: CLARITY
+    category: PLANNING
     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: CLARITY
+    category: PLANNING
     sequence:
       - agent: brownfield-wu
         action: full-discovery
@@ -26,7 +26,7 @@ phases:
 
   - phase: 1
     name: Problem Definition
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: brief
         action: problem-extraction
@@ -35,7 +35,7 @@ phases:
 
   - phase: 2
     name: Architecture Assessment
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: architect
         action: assess-architecture
@@ -47,7 +47,7 @@ phases:
 
   - phase: 3
     name: Product Specification
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: detail
         action: create-prd
@@ -61,7 +61,7 @@ phases:
 
   - phase: 4
     name: Execution Planning
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: phases
         action: create-roadmap
@@ -73,7 +73,7 @@ phases:
 
   - phase: 5
     name: Planning Quality Gate
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: qa-planning
         action: validate-traceability
@@ -99,7 +99,7 @@ phases:
         creates: [chati.dev/artifacts/8-Validation/deploy-report.md]
 
 transitions:
-  clarity_to_build:
+  planning_to_build:
     trigger: "qa-planning.score >= 95"
     type: automatic
     action: "Update project.state = build"
@@ -115,7 +115,7 @@ transitions:
     trigger: "devops.status == completed"
     type: automatic
     action: "Update project.state = completed"
-  backward_to_clarity:
+  backward_to_planning:
     trigger: "qa-implementation.issue_type in [spec, architecture]"
     type: backward
-    action: "Update project.state = clarity, route to responsible agent"
+    action: "Update project.state = planning, route to responsible agent"

package/framework/workflows/brownfield-service.yaml

@@ -16,7 +16,7 @@ workflow:
 phases:
   - phase: 0
     name: Deep Discovery
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: brownfield-wu
         action: full-discovery
@@ -24,7 +24,7 @@ phases:
 
   - phase: 1
     name: Problem Definition
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: brief
         action: problem-extraction
@@ -32,7 +32,7 @@ phases:
 
   - phase: 2
     name: Architecture & Specification
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: architect
         action: assess-architecture
@@ -45,7 +45,7 @@ phases:
 
   - phase: 3
     name: Execution Planning
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: phases
         action: create-roadmap
@@ -56,7 +56,7 @@ phases:
 
   - phase: 4
     name: Planning Quality Gate
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: qa-planning
         action: validate-traceability

package/framework/workflows/brownfield-ui.yaml

@@ -16,7 +16,7 @@ workflow:
 phases:
   - phase: 0
     name: Deep Discovery
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: brownfield-wu
         action: full-discovery
@@ -25,7 +25,7 @@ phases:
 
   - phase: 1
     name: Problem Definition
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: brief
         action: problem-extraction
@@ -33,7 +33,7 @@ phases:
 
   - phase: 2
     name: Architecture & Experience
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: architect
         action: assess-architecture
@@ -50,7 +50,7 @@ phases:
 
   - phase: 3
     name: Execution Planning
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: phases
         action: create-roadmap
@@ -61,7 +61,7 @@ phases:
 
   - phase: 4
     name: Planning Quality Gate
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: qa-planning
         action: validate-traceability

package/framework/workflows/greenfield-fullstack.yaml

@@ -16,7 +16,7 @@ workflow:
 phases:
   - phase: 0
     name: Discovery
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: greenfield-wu
         action: operational-discovery
@@ -25,7 +25,7 @@ phases:
 
   - phase: 1
     name: Problem Definition
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: brief
         action: problem-extraction
@@ -34,7 +34,7 @@ phases:
 
   - phase: 2
     name: Product Specification
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: detail
         action: create-prd
@@ -44,7 +44,7 @@ phases:
 
   - phase: 3
     name: Technical Design
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: architect
         action: design-architecture
@@ -58,7 +58,7 @@ phases:
 
   - phase: 4
     name: Execution Planning
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: phases
         action: create-roadmap
@@ -72,7 +72,7 @@ phases:
 
   - phase: 5
     name: Planning Quality Gate
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: qa-planning
         action: validate-traceability
@@ -103,7 +103,7 @@ phases:
         notes: "Git operations, deployment, documentation"
 
 transitions:
-  clarity_to_build:
+  planning_to_build:
     trigger: "qa-planning.score >= 95"
     type: automatic
     action: "Update project.state = build"
@@ -119,7 +119,7 @@ transitions:
     trigger: "devops.status == completed"
     type: automatic
     action: "Update project.state = completed"
-  backward_to_clarity:
+  backward_to_planning:
     trigger: "qa-implementation.issue_type in [spec, architecture]"
     type: backward
-    action: "Update project.state = clarity, route to responsible agent"
+    action: "Update project.state = planning, route to responsible agent"

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "chati-dev",
-  "version": "2.0.4",
-  "description": "AI-Powered Multi-Agent Orchestration System — 13 agents, 6 IDEs, 4 languages",
+  "version": "2.0.6",
+  "description": "AI-Powered Multi-Agent Orchestration System — Structured vibe coding for Full Stack Development",
   "type": "module",
   "bin": {
     "chati": "bin/chati.js",

package/scripts/bundle-framework.js

@@ -32,7 +32,7 @@ mkdirSync(DEST, { recursive: true });
 
 const dirs = [
   'orchestrator',
-  'agents/clarity', 'agents/quality', 'agents/build', 'agents/deploy',
+  'agents/planning', 'agents/quality', 'agents/build', 'agents/deploy',
   'templates', 'workflows', 'quality-gates',
   'schemas', 'frameworks', 'intelligence', 'patterns',
   'hooks', 'domains',

package/scripts/health-check.js

@@ -146,14 +146,14 @@ function checkAgents(frameworkDir) {
   const orchestratorDir = join(frameworkDir, 'orchestrator');
 
   const expectedAgents = {
-    'clarity/greenfield-wu.md': 'greenfield-wu',
-    'clarity/brownfield-wu.md': 'brownfield-wu',
-    'clarity/brief.md': 'brief',
-    'clarity/detail.md': 'detail',
-    'clarity/architect.md': 'architect',
-    'clarity/ux.md': 'ux',
-    'clarity/phases.md': 'phases',
-    'clarity/tasks.md': 'tasks',
+    'planning/greenfield-wu.md': 'greenfield-wu',
+    'planning/brownfield-wu.md': 'brownfield-wu',
+    'planning/brief.md': 'brief',
+    'planning/detail.md': 'detail',
+    'planning/architect.md': 'architect',
+    'planning/ux.md': 'ux',
+    'planning/phases.md': 'phases',
+    'planning/tasks.md': 'tasks',
     'quality/qa-planning.md': 'qa-planning',
     'quality/qa-implementation.md': 'qa-implementation',
     'build/dev.md': 'dev',

package/scripts/populate-entity-registry.js

@@ -161,7 +161,7 @@ function scanEntities(frameworkDir, relDir, category) {
 
     for (const entry of entries) {
       if (entry.isDirectory()) {
-        // Recurse into subdirectories (e.g., agents/clarity/, agents/build/)
+        // Recurse into subdirectories (e.g., agents/planning/, agents/build/)
         const subEntities = scanEntities(frameworkDir, join(relDir, entry.name), category);
         entities.push(...subEntities);
         continue;

package/scripts/validate-agents.js

@@ -19,7 +19,7 @@ import yaml from 'js-yaml';
  * Expected agents organized by category.
  */
 export const EXPECTED_AGENTS = {
-  clarity: ['greenfield-wu', 'brownfield-wu', 'brief', 'detail', 'architect', 'ux', 'phases', 'tasks'],
+  planning: ['greenfield-wu', 'brownfield-wu', 'brief', 'detail', 'architect', 'ux', 'phases', 'tasks'],
   quality: ['qa-planning', 'qa-implementation'],
   build: ['dev'],
   deploy: ['devops'],

package/scripts/validate-tasks.js

@@ -24,7 +24,7 @@ const REQUIRED_FIELDS = ['id', 'agent'];
 /**
  * Valid phase values.
  */
-const VALID_PHASES = ['clarity', 'build', 'deploy', 'validate', 'quality'];
+const VALID_PHASES = ['planning', 'build', 'deploy', 'validate', 'quality'];
 
 // ---------------------------------------------------------------------------
 // Internal Helpers

package/src/autonomy/autonomous-gate.js

@@ -16,7 +16,7 @@ export const GATE_RESULTS = {
 
 // Minimum passing scores per agent (conservative: 90 default)
 const GATE_THRESHOLDS = {
-  'qa-planning': 95,        // Highest — gates clarity→build transition
+  'qa-planning': 95,        // Highest — gates planning→build transition
   'qa-implementation': 90,  // Gates build→deploy transition
   'brief': 90,              // Requirements are critical
   'detail': 90,

package/src/autonomy/progress-reporter.js

@@ -35,7 +35,7 @@ export function buildProgressReport(pipelineState, options = {}) {
 
 /**
  * Format progress as a compact one-line status.
- * Example: "[CLARITY 3/8] brief ✅ → detail 🔄 (score: 92%)"
+ * Example: "[PLANNING 3/8] brief ✅ → detail 🔄 (score: 92%)"
  * @param {object} pipelineState
  * @returns {string}
  */
@@ -75,10 +75,10 @@ export function formatDetailedReport(pipelineState) {
   lines.push(`Stage: ${stage}`);
   lines.push('');
 
-  // CLARITY agents
-  lines.push('CLARITY:');
-  const clarityAgents = getStageAgents('CLARITY');
-  clarityAgents.forEach(agent => {
+  // PLANNING agents
+  lines.push('PLANNING:');
+  const planningAgents = getStageAgents('PLANNING');
+  planningAgents.forEach(agent => {
     const status = agentStatus[agent] || 'pending';
     const icon = getStatusIcon(status);
     const isActive = agent === pipelineState.current_agent;
@@ -146,7 +146,7 @@ export function calculateCompletion(pipelineState) {
  */
 function getStageAgents(stage) {
   const stages = {
-    CLARITY: [
+    PLANNING: [
       'greenfield-wu',
       'brownfield-wu',
       'brief',
@@ -170,7 +170,7 @@ function getStageAgents(stage) {
  */
 function getAllAgents() {
   return [
-    ...getStageAgents('CLARITY'),
+    ...getStageAgents('PLANNING'),
     ...getStageAgents('BUILD'),
     ...getStageAgents('DEPLOY'),
   ];
@@ -249,7 +249,7 @@ function countTotalAgents(_pipelineState) {
 /**
  * Get progress summary by stage.
  * @param {object} pipelineState
- * @returns {{ clarity: number, build: number, deploy: number }}
+ * @returns {{ planning: number, build: number, deploy: number }}
  */
 export function getStageProgress(pipelineState) {
   const agentStatus = pipelineState.agent_status || {};
@@ -261,7 +261,7 @@ export function getStageProgress(pipelineState) {
   };
 
   return {
-    clarity: getProgress('CLARITY'),
+    planning: getProgress('PLANNING'),
     build: getProgress('BUILD'),
     deploy: getProgress('DEPLOY'),
   };