chati-dev 1.0.0

package/framework/workflows/brownfield-discovery.yaml

@@ -0,0 +1,75 @@
+# Brownfield Discovery Workflow
+# Deep technical analysis of existing codebase (standalone)
+
+workflow:
+  id: brownfield-discovery
+  name: Brownfield Deep Discovery
+  version: "1.0.0"
+  type: brownfield
+  project_types: [technical-audit, tech-debt-assessment, migration-planning]
+  description: >
+    Standalone discovery workflow for deep analysis of an existing codebase.
+    Can be used independently (not as part of a full development pipeline)
+    for technical audits, tech debt assessment, or migration planning.
+
+phases:
+  - phase: 0
+    name: Context Detection
+    category: CLARITY
+    sequence:
+      - agent: brownfield-wu
+        action: context-detection
+        notes: "Automated scan of project structure, stack, tools"
+
+  - phase: 1
+    name: Architecture Analysis
+    category: CLARITY
+    sequence:
+      - agent: brownfield-wu
+        action: architecture-scout
+        notes: "Scout call to Architect for patterns, tech debt"
+
+  - phase: 2
+    name: UX Analysis
+    category: CLARITY
+    sequence:
+      - agent: brownfield-wu
+        action: ux-scout
+        notes: "Scout call to UX for design tokens, components"
+
+  - phase: 3
+    name: QA Analysis
+    category: CLARITY
+    sequence:
+      - agent: brownfield-wu
+        action: qa-scout
+        notes: "Scout call to QA for test coverage, CI/CD"
+
+  - phase: 4
+    name: Integration Mapping
+    category: CLARITY
+    sequence:
+      - agent: brownfield-wu
+        action: integration-mapping
+        notes: "External APIs, services, databases"
+
+  - phase: 5
+    name: Technical Debt Assessment
+    category: CLARITY
+    sequence:
+      - agent: brownfield-wu
+        action: tech-debt-assessment
+        notes: "Categorize by severity: critical, high, medium, low"
+
+  - phase: 6
+    name: Synthesis
+    category: CLARITY
+    sequence:
+      - agent: brownfield-wu
+        action: compile-report
+        creates: [chati.dev/artifacts/0-WU/wu-full-report.md]
+        notes: "Consolidate all findings into comprehensive report"
+
+output:
+  primary: chati.dev/artifacts/0-WU/wu-full-report.md
+  duration: "1-4 hours depending on codebase size"

package/framework/workflows/brownfield-fullstack.yaml

@@ -0,0 +1,104 @@
+# Brownfield Fullstack Workflow
+# Handles: feature addition, refactoring, modernization
+
+workflow:
+  id: brownfield-fullstack
+  name: Brownfield Fullstack Development
+  version: "1.0.0"
+  type: brownfield
+  project_types: [feature-addition, refactoring, modernization, enhancement]
+  description: >
+    Development pipeline for existing projects. Key difference from greenfield:
+    Architect comes BEFORE Detail to understand existing constraints first.
+    brownfield-wu ALWAYS runs Deep Discovery with 3 scout calls.
+
+phases:
+  - phase: 0
+    name: Deep Discovery
+    category: CLARITY
+    sequence:
+      - agent: brownfield-wu
+        action: full-discovery
+        creates: [chati.dev/artifacts/0-WU/wu-full-report.md]
+        notes: >
+          Both axes (technical + operational). ALWAYS runs Deep Discovery
+          with 3 scout calls: Architect, UX, QA in scout mode.
+
+  - phase: 1
+    name: Problem Definition
+    category: CLARITY
+    sequence:
+      - agent: brief
+        action: problem-extraction
+        creates: [chati.dev/artifacts/1-Brief/brief-report.md]
+        notes: "Informed by existing codebase context from WU"
+
+  - phase: 2
+    name: Architecture Assessment
+    category: CLARITY
+    sequence:
+      - agent: architect
+        action: assess-architecture
+        creates: [chati.dev/artifacts/3-Architecture/architecture.md]
+        template: fullstack-architecture-tmpl.yaml
+        notes: >
+          Architect comes BEFORE Detail in brownfield.
+          Assesses existing architecture, proposes changes.
+
+  - phase: 3
+    name: Product Specification
+    category: CLARITY
+    sequence:
+      - agent: detail
+        action: create-prd
+        creates: [chati.dev/artifacts/2-PRD/prd.md]
+        template: brownfield-prd-tmpl.yaml
+        notes: "PRD informed by architectural constraints"
+      - agent: ux
+        action: define-experience
+        creates: [chati.dev/artifacts/4-UX/ux-specification.md]
+        notes: "Includes Design System audit of existing code"
+
+  - phase: 4
+    name: Execution Planning
+    category: CLARITY
+    sequence:
+      - agent: phases
+        action: create-roadmap
+        creates: [chati.dev/artifacts/5-Phases/phases.md]
+      - agent: tasks
+        action: create-tasks
+        creates: [chati.dev/artifacts/6-Tasks/tasks.md]
+        template: task-tmpl.yaml
+
+  - phase: 5
+    name: Planning Quality Gate
+    category: CLARITY
+    sequence:
+      - agent: qa-planning
+        action: validate-traceability
+        creates: [chati.dev/artifacts/7-QA-Planning/qa-planning-report.md]
+        template: qa-gate-tmpl.yaml
+
+  - phase: 6
+    name: Implementation
+    category: BUILD
+    sequence:
+      - agent: dev
+        action: implement-tasks
+      - agent: qa-implementation
+        action: validate-code
+        creates: [chati.dev/artifacts/8-Validation/qa-implementation-report.md]
+
+  - phase: 7
+    name: Deployment
+    category: DEPLOY
+    sequence:
+      - agent: devops
+        action: deploy
+        creates: [chati.dev/artifacts/8-Validation/deploy-report.md]
+
+transitions:
+  clarity_to_build: "QA-Planning score >= 95%"
+  build_to_deploy: "QA-Implementation APPROVED"
+  deploy_to_completed: "DevOps deployment verified"

package/framework/workflows/brownfield-service.yaml

@@ -0,0 +1,81 @@
+# Brownfield Service Workflow
+# Backend/API enhancements for existing projects
+
+workflow:
+  id: brownfield-service
+  name: Brownfield Service Enhancement
+  version: "1.0.0"
+  type: brownfield
+  project_types: [api-enhancement, service-modernization, backend-refactoring]
+  description: >
+    Pipeline for backend/API changes in existing projects.
+    Same as brownfield-fullstack but Architect focuses on
+    API design, data model, and service architecture.
+    UX agent runs in minimal mode (API documentation only).
+
+phases:
+  - phase: 0
+    name: Deep Discovery
+    category: CLARITY
+    sequence:
+      - agent: brownfield-wu
+        action: full-discovery
+        creates: [chati.dev/artifacts/0-WU/wu-full-report.md]
+
+  - phase: 1
+    name: Problem Definition
+    category: CLARITY
+    sequence:
+      - agent: brief
+        action: problem-extraction
+        creates: [chati.dev/artifacts/1-Brief/brief-report.md]
+
+  - phase: 2
+    name: Architecture & Specification
+    category: CLARITY
+    sequence:
+      - agent: architect
+        action: assess-architecture
+        creates: [chati.dev/artifacts/3-Architecture/architecture.md]
+        notes: "Focus on API design, data model, service patterns"
+      - agent: detail
+        action: create-prd
+        creates: [chati.dev/artifacts/2-PRD/prd.md]
+        template: brownfield-prd-tmpl.yaml
+
+  - phase: 3
+    name: Execution Planning
+    category: CLARITY
+    sequence:
+      - agent: phases
+        action: create-roadmap
+        creates: [chati.dev/artifacts/5-Phases/phases.md]
+      - agent: tasks
+        action: create-tasks
+        creates: [chati.dev/artifacts/6-Tasks/tasks.md]
+
+  - phase: 4
+    name: Planning Quality Gate
+    category: CLARITY
+    sequence:
+      - agent: qa-planning
+        action: validate-traceability
+        creates: [chati.dev/artifacts/7-QA-Planning/qa-planning-report.md]
+
+  - phase: 5
+    name: Implementation
+    category: BUILD
+    sequence:
+      - agent: dev
+        action: implement-tasks
+      - agent: qa-implementation
+        action: validate-code
+        creates: [chati.dev/artifacts/8-Validation/qa-implementation-report.md]
+
+  - phase: 6
+    name: Deployment
+    category: DEPLOY
+    sequence:
+      - agent: devops
+        action: deploy
+        creates: [chati.dev/artifacts/8-Validation/deploy-report.md]

package/framework/workflows/brownfield-ui.yaml

@@ -0,0 +1,87 @@
+# Brownfield UI Workflow
+# Frontend/UI changes for existing projects
+
+workflow:
+  id: brownfield-ui
+  name: Brownfield UI Enhancement
+  version: "1.0.0"
+  type: brownfield
+  project_types: [ui-modernization, frontend-migration, component-library, design-system-update]
+  description: >
+    Pipeline for frontend/UI changes in existing projects.
+    Same as brownfield-fullstack but UX agent takes a larger role,
+    including Design System audit and component inventory.
+    Architect focuses on frontend architecture and state management.
+
+phases:
+  - phase: 0
+    name: Deep Discovery
+    category: CLARITY
+    sequence:
+      - agent: brownfield-wu
+        action: full-discovery
+        creates: [chati.dev/artifacts/0-WU/wu-full-report.md]
+        notes: "UX scout call gets extra attention for component audit"
+
+  - phase: 1
+    name: Problem Definition
+    category: CLARITY
+    sequence:
+      - agent: brief
+        action: problem-extraction
+        creates: [chati.dev/artifacts/1-Brief/brief-report.md]
+
+  - phase: 2
+    name: Architecture & Experience
+    category: CLARITY
+    sequence:
+      - agent: architect
+        action: assess-architecture
+        creates: [chati.dev/artifacts/3-Architecture/architecture.md]
+        notes: "Focus on frontend architecture, state management, component patterns"
+      - agent: detail
+        action: create-prd
+        creates: [chati.dev/artifacts/2-PRD/prd.md]
+        template: brownfield-prd-tmpl.yaml
+      - agent: ux
+        action: define-experience
+        creates: [chati.dev/artifacts/4-UX/ux-specification.md]
+        notes: "Full Design System audit + new token definitions"
+
+  - phase: 3
+    name: Execution Planning
+    category: CLARITY
+    sequence:
+      - agent: phases
+        action: create-roadmap
+        creates: [chati.dev/artifacts/5-Phases/phases.md]
+      - agent: tasks
+        action: create-tasks
+        creates: [chati.dev/artifacts/6-Tasks/tasks.md]
+
+  - phase: 4
+    name: Planning Quality Gate
+    category: CLARITY
+    sequence:
+      - agent: qa-planning
+        action: validate-traceability
+        creates: [chati.dev/artifacts/7-QA-Planning/qa-planning-report.md]
+
+  - phase: 5
+    name: Implementation
+    category: BUILD
+    sequence:
+      - agent: dev
+        action: implement-tasks
+        notes: "Design System token enforcement is critical for UI work"
+      - agent: qa-implementation
+        action: validate-code
+        creates: [chati.dev/artifacts/8-Validation/qa-implementation-report.md]
+
+  - phase: 6
+    name: Deployment
+    category: DEPLOY
+    sequence:
+      - agent: devops
+        action: deploy
+        creates: [chati.dev/artifacts/8-Validation/deploy-report.md]

package/framework/workflows/greenfield-fullstack.yaml

@@ -0,0 +1,108 @@
+# Greenfield Fullstack Workflow
+# Handles: web apps, SaaS, MVP, enterprise, prototypes
+# The single unified pipeline for all greenfield project types
+
+workflow:
+  id: greenfield-fullstack
+  name: Greenfield Fullstack Development
+  version: "1.0.0"
+  type: greenfield
+  project_types: [web-app, saas, enterprise, prototype, mvp, api, mobile-web]
+  description: >
+    Complete development pipeline for new projects. The Architect agent
+    adapts scope based on project needs (full-stack, service-only, or UI-only)
+    rather than requiring separate workflow definitions.
+
+phases:
+  - phase: 0
+    name: Discovery
+    category: CLARITY
+    sequence:
+      - agent: greenfield-wu
+        action: operational-discovery
+        creates: [chati.dev/artifacts/0-WU/wu-operational-report.md]
+        notes: "Operational context only (no codebase to analyze)"
+
+  - phase: 1
+    name: Problem Definition
+    category: CLARITY
+    sequence:
+      - agent: brief
+        action: problem-extraction
+        creates: [chati.dev/artifacts/1-Brief/brief-report.md]
+        notes: "5-phase extraction process"
+
+  - phase: 2
+    name: Product Specification
+    category: CLARITY
+    sequence:
+      - agent: detail
+        action: create-prd
+        creates: [chati.dev/artifacts/2-PRD/prd.md]
+        template: prd-tmpl.yaml
+        notes: "Detail comes BEFORE Architect in greenfield"
+
+  - phase: 3
+    name: Technical Design
+    category: CLARITY
+    sequence:
+      - agent: architect
+        action: design-architecture
+        creates: [chati.dev/artifacts/3-Architecture/architecture.md]
+        template: fullstack-architecture-tmpl.yaml
+        notes: "Tech stack selection, data model, deployment strategy"
+      - agent: ux
+        action: define-experience
+        creates: [chati.dev/artifacts/4-UX/ux-specification.md]
+        notes: "UX follows Architect (needs to know the stack)"
+
+  - phase: 4
+    name: Execution Planning
+    category: CLARITY
+    sequence:
+      - agent: phases
+        action: create-roadmap
+        creates: [chati.dev/artifacts/5-Phases/phases.md]
+        notes: "MVP-first phase breakdown"
+      - agent: tasks
+        action: create-tasks
+        creates: [chati.dev/artifacts/6-Tasks/tasks.md]
+        template: task-tmpl.yaml
+        notes: "Atomic tasks with Given-When-Then criteria"
+
+  - phase: 5
+    name: Planning Quality Gate
+    category: CLARITY
+    sequence:
+      - agent: qa-planning
+        action: validate-traceability
+        creates: [chati.dev/artifacts/7-QA-Planning/qa-planning-report.md]
+        template: qa-gate-tmpl.yaml
+        notes: "Must score >= 95% to proceed to BUILD"
+
+  - phase: 6
+    name: Implementation
+    category: BUILD
+    sequence:
+      - agent: dev
+        action: implement-tasks
+        notes: "Interactive or autonomous (Ralph Wiggum) mode"
+      - agent: qa-implementation
+        action: validate-code
+        creates: [chati.dev/artifacts/8-Validation/qa-implementation-report.md]
+        template: qa-gate-tmpl.yaml
+        notes: "Tests + SAST + code review. Must pass to deploy"
+
+  - phase: 7
+    name: Deployment
+    category: DEPLOY
+    sequence:
+      - agent: devops
+        action: deploy
+        creates: [chati.dev/artifacts/8-Validation/deploy-report.md]
+        notes: "Git operations, deployment, documentation"
+
+transitions:
+  clarity_to_build: "QA-Planning score >= 95%"
+  build_to_deploy: "QA-Implementation APPROVED"
+  deploy_to_completed: "DevOps deployment verified"

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "chati-dev",
+  "version": "1.0.0",
+  "description": "AI-Powered Multi-Agent Development Framework — 13 agents, 7 IDEs, 4 languages",
+  "type": "module",
+  "bin": {
+    "chati": "bin/chati.js",
+    "chati-dev": "bin/chati.js"
+  },
+  "main": "src/wizard/index.js",
+  "files": [
+    "bin/",
+    "src/",
+    "assets/",
+    "framework/",
+    "scripts/"
+  ],
+  "scripts": {
+    "start": "node bin/chati.js",
+    "bundle": "node scripts/bundle-framework.js",
+    "prepublishOnly": "node scripts/bundle-framework.js",
+    "test": "node --test"
+  },
+  "keywords": [
+    "ai",
+    "agents",
+    "development",
+    "framework",
+    "planning",
+    "multi-agent",
+    "cli",
+    "claude",
+    "orchestration",
+    "fullstack"
+  ],
+  "author": "chati.dev",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ogabrielalonso/chati-dev.git",
+    "directory": "packages/chati-dev"
+  },
+  "homepage": "https://github.com/ogabrielalonso/chati-dev#readme",
+  "bugs": {
+    "url": "https://github.com/ogabrielalonso/chati-dev/issues"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.7.0",
+    "chalk": "^5.3.0",
+    "ora": "^8.0.1",
+    "cli-progress": "^3.12.0",
+    "fs-extra": "^11.2.0",
+    "js-yaml": "^4.1.0",
+    "semver": "^7.6.0",
+    "blessed": "^0.1.81"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/scripts/bundle-framework.js

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+
+/**
+ * Bundle framework files into the npm package.
+ * Run before `npm publish` — copies chati.dev/ source files
+ * into packages/chati-dev/framework/ so they ship with the package.
+ */
+
+import { cpSync, mkdirSync, rmSync, existsSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const PACKAGE_ROOT = join(__dirname, '..');
+const MONOREPO_ROOT = join(PACKAGE_ROOT, '..', '..');
+const SOURCE = join(MONOREPO_ROOT, 'chati.dev');
+const DEST = join(PACKAGE_ROOT, 'framework');
+
+if (!existsSync(SOURCE)) {
+  console.error('Error: chati.dev/ source directory not found at:', SOURCE);
+  process.exit(1);
+}
+
+// Clean previous bundle
+if (existsSync(DEST)) {
+  rmSync(DEST, { recursive: true });
+}
+
+// Copy framework files
+console.log('Bundling framework files...');
+mkdirSync(DEST, { recursive: true });
+
+const dirs = [
+  'orchestrator',
+  'agents/clarity', 'agents/quality', 'agents/build', 'agents/deploy',
+  'templates', 'workflows', 'quality-gates',
+  'schemas', 'frameworks', 'intelligence', 'patterns',
+  'i18n', 'migrations',
+];
+
+for (const dir of dirs) {
+  const src = join(SOURCE, dir);
+  if (existsSync(src)) {
+    cpSync(src, join(DEST, dir), { recursive: true });
+  }
+}
+
+// Copy root files
+const rootFiles = ['constitution.md', 'config.yaml'];
+for (const file of rootFiles) {
+  const src = join(SOURCE, file);
+  if (existsSync(src)) {
+    cpSync(src, join(DEST, file));
+  }
+}
+
+console.log('Framework bundled to:', DEST);
+console.log('Done.');

package/src/config/ide-configs.js

@@ -0,0 +1,80 @@
+/**
+ * IDE Configuration Mapping (7 IDEs)
+ * Defines where chati.dev agents are deployed per IDE
+ */
+export const IDE_CONFIGS = {
+  'claude-code': {
+    name: 'Claude Code',
+    description: 'Anthropic official CLI',
+    recommended: true,
+    configPath: '.claude/commands/',
+    rulesFile: '.claude/CLAUDE.md',
+    mcpConfigFile: '.claude/mcp.json',
+    formatNotes: 'Native markdown format',
+  },
+  'vscode': {
+    name: 'VS Code',
+    description: 'Extensions: Continue, Copilot Chat, etc',
+    recommended: false,
+    configPath: '.vscode/chati/',
+    rulesFile: '.vscode/chati/rules.md',
+    mcpConfigFile: null,
+    formatNotes: 'Markdown with VS Code extension support',
+  },
+  'antigravity': {
+    name: 'AntiGravity',
+    description: 'Google agentic development platform',
+    recommended: false,
+    configPath: '.antigravity/agents/',
+    rulesFile: '.antigravity/rules.md',
+    mcpConfigFile: null,
+    formatNotes: 'Google platform format',
+  },
+  'cursor': {
+    name: 'Cursor',
+    description: 'AI-first code editor',
+    recommended: false,
+    configPath: '.cursor/rules/',
+    rulesFile: '.cursorrules',
+    mcpConfigFile: null,
+    formatNotes: 'Cursor rules format',
+  },
+  'windsurf': {
+    name: 'Windsurf',
+    description: 'AI-powered development environment',
+    recommended: false,
+    configPath: '.windsurf/rules/',
+    rulesFile: '.windsurfrules',
+    mcpConfigFile: null,
+    formatNotes: 'Windsurf rules format',
+  },
+  'gemini-cli': {
+    name: 'Gemini CLI',
+    description: 'Google AI for development',
+    recommended: false,
+    configPath: '.gemini/agents/',
+    rulesFile: '.gemini/instructions.md',
+    mcpConfigFile: null,
+    formatNotes: 'Gemini agent format',
+  },
+  'github-copilot': {
+    name: 'GitHub Copilot',
+    description: 'GitHub AI pair programmer',
+    recommended: false,
+    configPath: '.github/agents/',
+    rulesFile: '.github/copilot-instructions.md',
+    mcpConfigFile: null,
+    formatNotes: 'GitHub Copilot format',
+  },
+};
+
+/**
+ * Get list of IDEs for selection prompt
+ */
+export function getIDEChoices() {
+  return Object.entries(IDE_CONFIGS).map(([key, config]) => ({
+    value: key,
+    label: `${config.name}${config.recommended ? ' (Recommended)' : ''}`,
+    hint: config.description,
+  }));
+}