chati-dev 2.0.9 → 2.1.0

package/framework/workflows/greenfield-fullstack.yaml

@@ -16,7 +16,7 @@ workflow:
 phases:
   - phase: 0
     name: Discovery
-    category: PLANNING
+    category: DISCOVER
     sequence:
       - agent: greenfield-wu
         action: operational-discovery
@@ -25,7 +25,7 @@ phases:
 
   - phase: 1
     name: Problem Definition
-    category: PLANNING
+    category: DISCOVER
     sequence:
       - agent: brief
         action: problem-extraction
@@ -34,7 +34,7 @@ phases:
 
   - phase: 2
     name: Product Specification
-    category: PLANNING
+    category: PLAN
     sequence:
       - agent: detail
         action: create-prd
@@ -44,7 +44,7 @@ phases:
 
   - phase: 3
     name: Technical Design
-    category: PLANNING
+    category: PLAN
     sequence:
       - agent: architect
         action: design-architecture
@@ -58,7 +58,7 @@ phases:
 
   - phase: 4
     name: Execution Planning
-    category: PLANNING
+    category: PLAN
     sequence:
       - agent: phases
         action: create-roadmap
@@ -72,7 +72,7 @@ phases:
 
   - phase: 5
     name: Planning Quality Gate
-    category: PLANNING
+    category: PLAN
     sequence:
       - agent: qa-planning
         action: validate-traceability
@@ -103,7 +103,11 @@ phases:
         notes: "Git operations, deployment, documentation"
 
 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"
@@ -111,15 +115,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/quick-flow.yaml

@@ -0,0 +1,125 @@
+# Quick Flow Workflow
+# Fast-track pipeline for simple tasks: bug fixes, small features, config changes
+# Skips full DISCOVER/PLAN phases when complexity is low
+
+workflow:
+  id: quick-flow
+  name: Quick Flow — Fast Track Development
+  version: "1.0.0"
+  type: any
+  project_types: [bug-fix, small-feature, config-change, hotfix, refactor]
+  description: >
+    Condensed pipeline for tasks that don't need full discovery/planning.
+    Used when the orchestrator detects low complexity: clear requirements,
+    known codebase, small scope. Skips Detail, Architect, UX, Phases, Tasks,
+    and QA-Planning. Goes straight from Brief (quick) to Dev.
+
+detection:
+  # Orchestrator uses these signals to auto-detect quick-flow eligibility
+  triggers:
+    - "User explicitly requests quick fix or hotfix"
+    - "Single, well-defined requirement (can be stated in one sentence)"
+    - "Bug report with reproduction steps"
+    - "Configuration or environment change"
+    - "Small refactoring with clear scope"
+    - "User says 'just do it' or 'quick fix' or similar urgency signals"
+  disqualifiers:
+    - "New feature requiring architecture decisions"
+    - "Multiple interconnected requirements"
+    - "Greenfield project (no existing codebase)"
+    - "Enterprise or compliance context"
+    - "User explicitly requests full pipeline"
+    - "Scope involves more than 5 files"
+    - "Requires database schema changes"
+    - "Requires new API endpoints (>2)"
+
+  confidence_threshold: 0.8
+  user_confirmation: true
+
+phases:
+  - phase: 0
+    name: Quick Brief
+    category: DISCOVER
+    sequence:
+      - agent: brief
+        action: quick-extraction
+        creates: [chati.dev/artifacts/1-Brief/quick-brief.md]
+        notes: >
+          Condensed extraction: single-pass, no 5-phase process.
+          Capture: what, why, constraints, acceptance criteria.
+          Duration: 2-5 min max.
+        template: quick-brief-tmpl.yaml
+        config:
+          max_rounds: 2
+          require_approval: true
+
+  - phase: 1
+    name: Implementation
+    category: BUILD
+    sequence:
+      - agent: dev
+        action: implement-tasks
+        notes: >
+          Dev works directly from Quick Brief (no PRD, no architecture doc).
+          Scope is tight: fix the bug, add the small feature, make the change.
+          Self-critique checklist still applies.
+
+  - phase: 2
+    name: Validation
+    category: BUILD
+    sequence:
+      - agent: qa-implementation
+        action: validate-code
+        creates: [chati.dev/artifacts/8-Validation/qa-implementation-report.md]
+        notes: >
+          Full QA-Implementation validation still applies (no shortcuts on quality).
+          Adversarial review still mandatory.
+          Tests must pass, SAST must be clean.
+        config:
+          adversarial_review: true
+          minimum_findings: 3
+
+  - phase: 3
+    name: Deployment
+    category: DEPLOY
+    sequence:
+      - agent: devops
+        action: deploy
+        creates: [chati.dev/artifacts/8-Validation/deploy-report.md]
+        notes: "Standard deployment process"
+
+transitions:
+  quick_brief_to_build:
+    trigger: "brief.status == completed"
+    type: automatic
+    action: "Skip full PLAN phase, go directly to BUILD"
+    notes: "No Detail, Architect, UX, Phases, Tasks, or QA-Planning"
+  build_to_validate:
+    trigger: "dev.status == completed"
+    type: automatic
+    action: "Update project.state = validate"
+  validate_to_deploy:
+    trigger: "qa-implementation.status == approved"
+    type: automatic
+    action: "Update project.state = deploy"
+    notes: "User preview skipped for quick-flow (scope too small)"
+  deploy_to_completed:
+    trigger: "devops.status == completed"
+    type: automatic
+    action: "Update project.state = completed"
+
+escalation:
+  # If at any point the quick-flow feels insufficient, escalate to full pipeline
+  triggers:
+    - "Dev discovers the change is more complex than expected"
+    - "QA-Implementation finds architectural issues"
+    - "Scope creep detected (>5 files, new APIs, schema changes)"
+    - "Dev agent requests escalation"
+  action: >
+    Pause quick-flow, notify user:
+    "This task is more complex than initially estimated.
+    Recommend switching to full pipeline for proper planning.
+    Options:
+    1. Switch to full pipeline (Recommended)
+    2. Continue with quick-flow (document risk)
+    3. Abort and reassess"

package/package.json

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

package/scripts/bundle-framework.js

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

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/planning/, agents/build/)
+        // Recurse into subdirectories (e.g., agents/discover/, agents/plan/, agents/build/)
         const subEntities = scanEntities(frameworkDir, join(relDir, entry.name), category);
         entities.push(...subEntities);
         continue;

package/scripts/semantic-lint.js

@@ -87,7 +87,7 @@ function checkDomainAgentAlignment(frameworkDir, results) {
     }
 
     // Other agents: check all category dirs
-    const agentDirs = ['agents/planning', 'agents/quality', 'agents/build', 'agents/deploy'];
+    const agentDirs = ['agents/discover', 'agents/plan', 'agents/quality', 'agents/build', 'agents/deploy'];
     const found = agentDirs.some(dir =>
       existsSync(join(frameworkDir, dir, `${agentName}.md`))
     );
@@ -221,7 +221,7 @@ function checkWorkflowAgentRefs(frameworkDir, results) {
 
   // Collect known agent names
   const knownAgents = new Set(['orchestrator']);
-  const agentDirs = ['agents/planning', 'agents/quality', 'agents/build', 'agents/deploy'];
+  const agentDirs = ['agents/discover', 'agents/plan', 'agents/quality', 'agents/build', 'agents/deploy'];
   for (const dir of agentDirs) {
     const fullDir = join(frameworkDir, dir);
     if (!existsSync(fullDir)) continue;

package/scripts/validate-agents.js

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

package/scripts/validate-package.js

@@ -21,7 +21,7 @@ const __dirname = dirname(fileURLToPath(import.meta.url));
  */
 const EXPECTED_BUNDLE_DIRS = [
   'orchestrator',
-  'agents/planning', 'agents/quality', 'agents/build', 'agents/deploy',
+  'agents/discover', 'agents/plan', 'agents/quality', 'agents/build', 'agents/deploy',
   'templates', 'workflows', 'quality-gates',
   'schemas', 'frameworks', 'intelligence', 'patterns',
   'hooks', 'domains',

package/scripts/validate-tasks.js

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

package/src/autonomy/progress-reporter.js

@@ -35,7 +35,7 @@ export function buildProgressReport(pipelineState, options = {}) {
 
 /**
  * Format progress as a compact one-line status.
- * Example: "[PLANNING 3/8] brief ✅ → detail 🔄 (score: 92%)"
+ * Example: "[DISCOVER 2/3] brief ✅ → detail 🔄 (score: 92%)" or "[PLAN 3/6] phases 🔄 (score: 92%)"
  * @param {object} pipelineState
  * @returns {string}
  */
@@ -75,10 +75,23 @@ export function formatDetailedReport(pipelineState) {
   lines.push(`Stage: ${stage}`);
   lines.push('');
 
-  // PLANNING agents
-  lines.push('PLANNING:');
-  const planningAgents = getStageAgents('PLANNING');
-  planningAgents.forEach(agent => {
+  // DISCOVER agents
+  lines.push('DISCOVER:');
+  const discoverAgents = getStageAgents('DISCOVER');
+  discoverAgents.forEach(agent => {
+    const status = agentStatus[agent] || 'pending';
+    const icon = getStatusIcon(status);
+    const isActive = agent === pipelineState.current_agent;
+    const prefix = isActive ? '→ ' : '  ';
+    lines.push(`${prefix}${icon} ${agent}`);
+  });
+
+  lines.push('');
+
+  // PLAN agents
+  lines.push('PLAN:');
+  const planAgents = getStageAgents('PLAN');
+  planAgents.forEach(agent => {
     const status = agentStatus[agent] || 'pending';
     const icon = getStatusIcon(status);
     const isActive = agent === pipelineState.current_agent;
@@ -146,17 +159,8 @@ export function calculateCompletion(pipelineState) {
  */
 function getStageAgents(stage) {
   const stages = {
-    PLANNING: [
-      'greenfield-wu',
-      'brownfield-wu',
-      'brief',
-      'detail',
-      'architect',
-      'ux',
-      'phases',
-      'tasks',
-      'qa-planning',
-    ],
+    DISCOVER: ['greenfield-wu', 'brownfield-wu', 'brief'],
+    PLAN: ['detail', 'architect', 'ux', 'phases', 'tasks', 'qa-planning'],
     BUILD: ['dev', 'qa-implementation'],
     DEPLOY: ['devops'],
   };
@@ -170,7 +174,8 @@ function getStageAgents(stage) {
  */
 function getAllAgents() {
   return [
-    ...getStageAgents('PLANNING'),
+    ...getStageAgents('DISCOVER'),
+    ...getStageAgents('PLAN'),
     ...getStageAgents('BUILD'),
     ...getStageAgents('DEPLOY'),
   ];
@@ -222,6 +227,7 @@ function getStatusIcon(status) {
     failed: '❌',
     pending: '⏸',
     skipped: '⏭',
+    preview: '👁',
   };
 
   return icons[status] || '⏸';
@@ -249,7 +255,7 @@ function countTotalAgents(_pipelineState) {
 /**
  * Get progress summary by stage.
  * @param {object} pipelineState
- * @returns {{ planning: number, build: number, deploy: number }}
+ * @returns {{ discover: number, plan: number, build: number, deploy: number }}
  */
 export function getStageProgress(pipelineState) {
   const agentStatus = pipelineState.agent_status || {};
@@ -261,7 +267,8 @@ export function getStageProgress(pipelineState) {
   };
 
   return {
-    planning: getProgress('PLANNING'),
+    discover: getProgress('DISCOVER'),
+    plan: getProgress('PLAN'),
     build: getProgress('BUILD'),
     deploy: getProgress('DEPLOY'),
   };

package/src/context/engine.js

@@ -43,7 +43,7 @@ export function runPrism(input) {
   // 2. Build context for layer processors
   const ctx = {
     domainsDir: input.domainsDir,
-    mode: input.mode || 'planning',
+    mode: input.mode || 'discover',
     bracket: bracket.bracket,
     agent: input.agent || null,
     workflow: input.workflow || null,

package/src/context/layers/l1-global.js

@@ -2,31 +2,43 @@
  * L1 Global Layer — ALWAYS active.
  *
  * Loads global rules: coding standards, bracket-specific behavioral rules,
- * mode governance constraints (planning/build/deploy).
+ * mode governance constraints (discover/plan → planning, build, deploy).
  */
 
 import { loadGlobalDomain, extractRules } from '../domain-loader.js';
 
+// Maps session states to governance modes for domain lookup
+const STATE_TO_GOVERNANCE_MODE = {
+  discover: 'planning',
+  plan: 'planning',
+  planning: 'planning',
+  build: 'build',
+  validate: 'build',
+  deploy: 'deploy',
+  completed: 'deploy',
+};
+
 /**
  * Process L1: load global rules + mode governance.
  * @param {object} ctx - Pipeline context
  * @param {string} ctx.domainsDir - Path to chati.dev/domains/
- * @param {string} ctx.mode - Current mode (planning, build, deploy)
+ * @param {string} ctx.mode - Current session state (discover, plan, build, deploy)
  * @param {string} ctx.bracket - Current bracket (FRESH, MODERATE, etc.)
  * @returns {{ layer: string, rules: Array, mode: string, modeRules: object }}
  */
 export function processL1(ctx) {
   const domain = loadGlobalDomain(ctx.domainsDir);
   const rules = extractRules(domain);
-  const mode = ctx.mode || 'planning';
+  const sessionMode = ctx.mode || 'discover';
+  const governanceMode = STATE_TO_GOVERNANCE_MODE[sessionMode] || 'planning';
 
-  const modeRules = domain?.modes?.[mode] || {};
+  const modeRules = domain?.modes?.[governanceMode] || {};
   const bracketRules = domain?.brackets?.[ctx.bracket] || {};
 
   return {
     layer: 'L1',
     rules,
-    mode,
+    mode: sessionMode,
     modeRules: {
       writeScope: modeRules.writeScope || 'chati.dev/',
       allowedActions: modeRules.allowedActions || [],

package/src/dashboard/layout.js

@@ -21,7 +21,8 @@ function formatScore(score, status) {
  */
 function formatState(state) {
   const stateMap = {
-    planning: brand('PLANNING'),
+    discover: brand('DISCOVER'),
+    plan: brand('PLAN'),
     build: yellow('BUILD'),
     validate: bold('VALIDATE'),
     deploy: green('DEPLOY'),

package/src/gates/g1-planning-complete.js

@@ -1,7 +1,7 @@
 /**
- * @fileoverview G1 — Planning Complete Gate
+ * @fileoverview G1 — Plan Complete Gate
  *
- * Pre-BUILD gate that validates the PLANNING phase is fully completed.
+ * Pre-BUILD gate that validates the PLAN phase is fully completed.
  * Checks that all required artifacts exist and QA-Planning has approved.
  */
 
@@ -31,7 +31,7 @@ export class PlanningCompleteGate extends GateBase {
   }
 
   /**
-   * Collect evidence by checking filesystem for PLANNING artifacts.
+   * Collect evidence by checking filesystem for PLAN artifacts.
    *
    * @param {string} projectDir
    * @returns {object} Evidence about artifact presence, session state, and handoff
@@ -99,7 +99,7 @@ export class PlanningCompleteGate extends GateBase {
     const allCriteria = [
       ...REQUIRED_ARTIFACTS.map(a => `${a.label} exists`),
       'QA-Planning handoff with passing score',
-      'Session shows planning completed',
+      'Session shows plan completed',
     ];
 
     const criteriaResults = [];
@@ -130,16 +130,16 @@ export class PlanningCompleteGate extends GateBase {
 
     // Check session state
     if (evidence.sessionState) {
-      const planningAgents = ['brief', 'detail', 'architect', 'ux', 'phases', 'tasks', 'qa-planning'];
-      const completed = planningAgents.filter(a =>
+      const planAgents = ['brief', 'detail', 'architect', 'ux', 'phases', 'tasks', 'qa-planning'];
+      const completed = planAgents.filter(a =>
         evidence.sessionState.completedAgents.includes(a)
       );
 
-      if (completed.length === planningAgents.length) {
-        criteriaResults.push('Session shows planning completed');
+      if (completed.length === planAgents.length) {
+        criteriaResults.push('Session shows plan completed');
       } else {
-        const missing = planningAgents.filter(a => !completed.includes(a));
-        warnings.push(`Incomplete planning agents: ${missing.join(', ')}`);
+        const missing = planAgents.filter(a => !completed.includes(a));
+        warnings.push(`Incomplete plan agents: ${missing.join(', ')}`);
       }
     }
 

package/src/installer/core.js

@@ -49,7 +49,7 @@ export async function installFramework(config) {
   // Copy framework structure
   const frameworkDirs = [
     'orchestrator',
-    'agents/planning', 'agents/quality', 'agents/build', 'agents/deploy',
+    'agents/discover', 'agents/plan', 'agents/quality', 'agents/build', 'agents/deploy',
     'templates', 'workflows', 'quality-gates',
     'schemas', 'frameworks', 'intelligence', 'patterns',
     'hooks', 'domains', 'domains/agents', 'domains/workflows',
@@ -135,15 +135,16 @@ function copyFrameworkFiles(destDir) {
   const filesToCopy = [
     'constitution.md',
     'orchestrator/chati.md',
-    // PLANNING agents
-    'agents/planning/greenfield-wu.md',
-    'agents/planning/brownfield-wu.md',
-    'agents/planning/brief.md',
-    'agents/planning/detail.md',
-    'agents/planning/architect.md',
-    'agents/planning/ux.md',
-    'agents/planning/phases.md',
-    'agents/planning/tasks.md',
+    // DISCOVER agents
+    'agents/discover/greenfield-wu.md',
+    'agents/discover/brownfield-wu.md',
+    'agents/discover/brief.md',
+    // PLAN agents
+    'agents/plan/detail.md',
+    'agents/plan/architect.md',
+    'agents/plan/ux.md',
+    'agents/plan/phases.md',
+    'agents/plan/tasks.md',
     // Quality agents
     'agents/quality/qa-planning.md',
     'agents/quality/qa-implementation.md',
@@ -309,10 +310,11 @@ The orchestrator is at \`chati.dev/orchestrator/chati.md\`.
 Read it to understand routing, session management, and agent activation.
 
 ## Constitution
-Governance rules are in \`chati.dev/constitution.md\` (10 Articles).
+Governance rules are in \`chati.dev/constitution.md\` (17 Articles).
 
 ## Agents
-- PLANNING: chati.dev/agents/planning/ (8 agents)
+- DISCOVER: chati.dev/agents/discover/ (3 agents)
+- PLAN: chati.dev/agents/plan/ (5 agents)
 - Quality: chati.dev/agents/quality/ (2 agents)
 - BUILD: chati.dev/agents/build/ (1 agent)
 - DEPLOY: chati.dev/agents/deploy/ (1 agent)

package/src/installer/templates.js

@@ -10,7 +10,7 @@ export function generateSessionYaml(config) {
     project: {
       name: projectName,
       type: projectType,
-      state: 'planning',
+      state: 'discover',
     },
     execution_mode: 'interactive',
     current_agent: '',

package/src/installer/validator.js

@@ -27,14 +27,14 @@ export async function validateInstallation(targetDir) {
   // Check all 13 agents (orchestrator + 12 specialized)
   const agentFiles = [
     'orchestrator/chati.md',
-    'agents/planning/greenfield-wu.md',
-    'agents/planning/brownfield-wu.md',
-    'agents/planning/brief.md',
-    'agents/planning/detail.md',
-    'agents/planning/architect.md',
-    'agents/planning/ux.md',
-    'agents/planning/phases.md',
-    'agents/planning/tasks.md',
+    'agents/discover/greenfield-wu.md',
+    'agents/discover/brownfield-wu.md',
+    'agents/discover/brief.md',
+    'agents/plan/detail.md',
+    'agents/plan/architect.md',
+    'agents/plan/ux.md',
+    'agents/plan/phases.md',
+    'agents/plan/tasks.md',
     'agents/quality/qa-planning.md',
     'agents/quality/qa-implementation.md',
     'agents/build/dev.md',

package/src/intelligence/registry-manager.js

@@ -140,10 +140,10 @@ export function runHealthCheck(targetDir) {
   // 4. Agent check
   const agentPaths = [
     'orchestrator/chati.md',
-    'agents/planning/greenfield-wu.md', 'agents/planning/brownfield-wu.md',
-    'agents/planning/brief.md', 'agents/planning/detail.md',
-    'agents/planning/architect.md', 'agents/planning/ux.md',
-    'agents/planning/phases.md', 'agents/planning/tasks.md',
+    'agents/discover/greenfield-wu.md', 'agents/discover/brownfield-wu.md',
+    'agents/discover/brief.md', 'agents/plan/detail.md',
+    'agents/plan/architect.md', 'agents/plan/ux.md',
+    'agents/plan/phases.md', 'agents/plan/tasks.md',
     'agents/quality/qa-planning.md', 'agents/quality/qa-implementation.md',
     'agents/build/dev.md', 'agents/deploy/devops.md',
   ];

package/src/memory/session-digest.js

@@ -19,7 +19,7 @@ export function buildSessionDigest(projectDir, sessionState) {
     timestamp,
     date: dateStr,
     project: sessionState.project || {},
-    mode: sessionState.mode || 'planning',
+    mode: sessionState.mode || 'discover',
     pipeline: sessionState.pipeline || {},
     agents: {},
     summary: {},