Skip to content

Chati.dev — AI-Powered Multi-Agent Orchestration System. Structured vibe coding for Full Stack Development.

License

Notifications You must be signed in to change notification settings

Chati-dev/Chati.dev


Chati.dev

AI-Powered Multi-Agent Orchestration System
Structured vibe coding for Full Stack Development.

npm License: MIT Node.js Multi-LLM i18n CI Contributions Welcome


What is Chati.dev?

Chati.dev is a system that turns AI into a structured development team. Instead of chatting with a single AI that forgets everything between sessions, you get 13 specialized agents — each with a clear role — working together through a defined pipeline.

You describe what you want to build. The agents handle requirements, architecture, planning, coding, testing, and deployment — in order, with quality gates between each phase.

You → DISCOVER → PLAN → BUILD → DEPLOY → Done
       "what"   "how"  "code"   "ship"

Every decision is saved. Every artifact is validated. If you close your laptop and come back tomorrow, the system picks up exactly where you left off.


Why Chati.dev?

The Problem

AI-assisted development today has three critical issues:

  1. Context Loss — AI forgets decisions across sessions, leading to inconsistent implementations
  2. Planning Gaps — Jumping straight to code without structured requirements leads to rework
  3. Vendor Lock-in — Most AI dev tools only work with one provider, limiting flexibility

The Solution

Chati.dev introduces Agent-Driven Development: a pipeline where each agent owns a specific phase, produces validated artifacts, and hands off context to the next agent. The system ensures context is never lost, knowledge persists across sessions, and you can use any supported AI provider.


Quick Start

Prerequisites

1. Install in your project

Open a terminal in your project directory:

npx chati-dev init

The wizard guides you through 4 steps:

Step What it asks
Language English, Portuguese, Spanish, or French
Project Type Greenfield (new) or Brownfield (existing)
AI Provider Claude, Gemini, Codex, or GitHub Copilot — auto-configures optimal models per agent
Confirm Review summary and proceed

2. Activate the orchestrator

Open your AI CLI in the same project directory, then type:

/chati

The orchestrator loads your session, detects where you left off, and routes you to the right agent. You stay inside the system until you explicitly exit.

3. Follow the pipeline

The agents guide you through each phase:

Phase What happens You do
DISCOVER Agents interview you about what you want to build Answer questions about your project
PLAN Agents create PRD, architecture, UX spec, phases, and tasks Review and approve the plan
BUILD Dev agent implements the code, task by task Review code as it's built
DEPLOY DevOps agent handles git, deployment, and documentation Confirm deployment settings

Quality gates run automatically between phases — if something doesn't meet the threshold, the system loops back and fixes it.

Monitor progress

npx chati-dev status          # One-time snapshot
npx chati-dev status --watch  # Auto-refresh every 5s

Exit & Resume

/chati exit     # Save session and exit
/chati          # Resume exactly where you left off

Key Features

Feature What it means
13 Specialized Agents Each agent has a defined mission, success criteria, and handoff protocol — not one AI trying to do everything
Multi-CLI Architecture Choose your AI provider at install time: Claude, Gemini, Codex, or GitHub Copilot. Each agent gets the optimal model for that provider
Quality Gates Every phase is validated before moving forward. 3-tier verdicts: APPROVED, NEEDS_REVISION, or BLOCKED
Context Persistence Sessions survive restarts. Close your IDE, come back next week — the system remembers everything
Session Lock Once activated, you stay inside the system. No accidentally "falling out" into generic AI mode
Multi-Terminal Autonomous agents run in parallel in separate terminals. Detail, Architect, and UX agents work simultaneously
Memory System The system learns from mistakes. Gotchas are captured automatically and recalled when relevant
Execution Profiles Three profiles — explore (read-only), guided (default), autonomous (gate >= 90%) — with safety net and circuit breaker
IDE-Agnostic Works with Claude Code, VS Code, Cursor, Gemini CLI, GitHub Copilot, and AntiGravity
4 Languages Interface supports English, Portuguese, Spanish, and French. Artifacts are always generated in English
Supply Chain Security Every file is cryptographically signed (Ed25519). Tampered packages are blocked on install

Multi-CLI Support

Chati.dev is provider-agnostic. You choose your AI provider during installation, and the system auto-configures optimal model assignments for every agent.

Supported Providers

Provider CLI Deep Reasoning Lightweight Status
Claude claude Opus Sonnet / Haiku Default
Gemini gemini Pro Flash Full support
Codex codex Codex Codex Mini Full support
GitHub Copilot copilot Sonnet 4.5 GPT-5 Full support

How Model Assignment Works

Each agent is classified by its reasoning needs:

  • Deep reasoning (Architect, QA, Dev, Detail, Brownfield-WU) → top-tier model
  • Lightweight (Brief, Phases, UX, Greenfield-WU, DevOps, Orchestrator) → fast model

When you select a provider, the system maps each agent to the best available model:

Claude:  architect → opus,   brief → sonnet,  greenfield-wu → haiku
Gemini:  architect → pro,    brief → flash,   greenfield-wu → flash
Codex:   architect → codex,  brief → codex-mini
GitHub Copilot: architect → claude-sonnet, brief → claude-sonnet

CLI Invocation Syntax

Each provider uses its own CLI syntax. Chati.dev handles this transparently:

Provider Command Example
Claude claude --print --model <id> claude --print --model claude-opus-4-6
Gemini gemini --model <id> gemini --model gemini-2.5-pro
Codex codex exec -m <id> codex exec -m gpt-5.3-codex
GitHub Copilot copilot -p --model <id> copilot -p --model claude-sonnet-4.5

Prompts are piped via stdin for all providers. You can override individual agent models in chati.dev/config.yaml under agent_overrides.


Execution Profiles

Three profiles control how much autonomy agents have:

Profile Behavior When to use
explore Read-only. Agents analyze but don't modify files Understanding a new codebase
guided Default. Agents propose changes, you approve Normal development workflow
autonomous Agents execute without confirmation (quality gates >= 90%) Trusted pipelines with high quality scores

The system starts in guided mode. Transition to autonomous requires both QA gates scoring >= 95%. A safety net with 5 triggers (stuck loop, quality drop, scope creep, error cascade, user override) automatically reverts to guided mode when needed.


Architecture

13 Agents, 4 Pipeline Phases

Phase Agents What they do
DISCOVER Greenfield WU, Brownfield WU, Brief Interview you, understand your project, extract requirements
PLAN Detail, Architect, UX, Phases, Tasks Create PRD, design architecture, define UX, break work into phases and tasks
BUILD Dev Implement code task by task, following the plan
DEPLOY DevOps Handle git operations, deployment, and documentation
Quality QA-Planning, QA-Implementation Validate plan coherence (>= 95%) and code quality (>= 95%) between phases

How the Pipeline Works

 You type /chati
       │
       ▼
 ┌──────────────────────────────────────────────┐
 │  ORCHESTRATOR                                │
 │  Routes you to the right agent.              │
 │  Manages session state and handoffs.         │
 └──────────────────────────────────────────────┘
       │
       ├─ In your conversation ─────────────────┐
       │                                        │
       │    DISCOVER (interactive)              │
       │    WU interviews you → Brief compiles  │
       │    requirements into a structured doc  │
       │                                        │
       ├─ Spawns separate terminals ────────────┐
       │   (using your selected AI provider)    │
       │                                        │
       │    PLAN (autonomous, parallel)         │
       │    Detail ───┐                         │
       │    Architect ├─ run simultaneously     │
       │    UX ───────┘                         │
       │    Then: Phases → Tasks                │
       │                                        │
       ├─ Quality Gate ─────────────────────────┐
       │                                        │
       │    QA-Planning validates the plan      │
       │    Must score >= 95% to proceed        │
       │                                        │
       ├─ Spawns terminal(s) ───────────────────┐
       │                                        │
       │    BUILD                               │
       │    Dev implements tasks (parallel      │
       │    when tasks are independent)         │
       │                                        │
       ├─ Quality Gate ─────────────────────────┐
       │                                        │
       │    QA-Implementation validates code    │
       │    Tests + static analysis + coverage  │
       │                                        │
       └─ Spawns terminal ──────────────────────┐
                                                │
            DEPLOY                              │
            DevOps handles git, deploy, docs    │
                                                │
                                         ✓ Done │

Each spawned terminal runs as a separate CLI process with its own context window, write-scope isolation, and structured handoff output. The AI provider and model are selected automatically based on your configuration.

Intelligence Layer

Three systems operate transparently behind the pipeline:

System What it does
Context Engine (PRISM) Injects the right context at the right time. 5 layers of context (from system-wide rules down to specific task details). Tracks how much context space remains and adapts automatically.
Memory System (RECALL) Remembers decisions, gotchas, and lessons across sessions. Organized into 4 sectors: what happened (episodic), what we know (semantic), how we do things (procedural), and what we learned (reflective).
Decision Engine (COMPASS) Before creating something new, checks if a similar component already exists. Decides whether to reuse, adapt, or create from scratch. Keeps a registry of all project entities.

Constitution

The system is governed by a 19-article Constitution that enforces agent behavior, quality standards, security, and system integrity:

  • Agent Governance — Every agent has a defined mission, scope, and success criteria
  • Quality Standards — Minimum 95% score on quality gates. 3-tier verdicts (APPROVED / NEEDS_REVISION / BLOCKED)
  • Security — No secrets in system files. No destructive operations without confirmation. Ed25519 supply chain verification
  • Mode Governance — Planning mode can't modify project code. Build mode has full access
  • Session Lock — Once activated, all messages route through the orchestrator
  • Model Governance — Each agent runs on its designated model, enforced by the CLI adapter
  • Execution Profiles — Explore, guided, and autonomous modes with safety net and circuit breaker
  • Multi-CLI — Provider-agnostic architecture with adapter pattern and automatic model mapping

Supported IDEs

IDE How it connects
Claude Code .claude/commands/chati.md → orchestrator
VS Code .vscode/chati.md → orchestrator
Cursor .cursor/rules/chati.md → orchestrator
Gemini CLI .gemini/commands/chati.toml → orchestrator
GitHub Copilot .github/agents/chati.md → orchestrator
AntiGravity Platform agent config → orchestrator

All IDEs use a thin router file that points to the same orchestrator. Your project works the same regardless of which IDE you use.


CLI Commands

Setup & Maintenance

Command Description
npx chati-dev init Initialize new project with guided wizard
npx chati-dev install Install into existing project
npx chati-dev status Show project dashboard
npx chati-dev status --watch Auto-refresh dashboard every 5s
npx chati-dev health Run system health check (5 checks)
npx chati-dev check-update Check for updates
npx chati-dev upgrade Upgrade to latest version
npx chati-dev upgrade --version X.Y.Z Upgrade to specific version
npx chati-dev --reconfigure Reconfigure installation
npx chati-dev changelog View changelog

Memory & Context

Command Description
npx chati-dev memory stats Show memory statistics
npx chati-dev memory list List memories (filter by --agent, --sector, --tier)
npx chati-dev memory search <query> Search memories by tags or content
npx chati-dev memory clean Clean expired memories (--dry-run to preview)
npx chati-dev context Show context bracket status
npx chati-dev registry stats Show entity registry statistics
npx chati-dev registry check Validate registry against filesystem

Inside an Active Session

Command Description
/chati Start or resume session
/chati status Show pipeline progress
/chati help Show available commands
/chati resume Resume from continuation file
/chati exit Save session and exit

Project Structure

your-project/
├── .chati/
│   ├── session.yaml              # Session state (auto-managed, gitignored)
│   └── memories/                 # Memory storage (gitignored)
├── .claude/
│   ├── commands/
│   │   └── chati.md              # Thin router → orchestrator
│   └── rules/
│       └── chati/                # Framework context (auto-loaded)
│           ├── root.md           # System overview
│           ├── governance.md     # Constitution rules
│           ├── protocols.md      # Universal protocols
│           └── quality.md        # Quality standards
├── CLAUDE.md                     # Project context (auto-generated)
├── CLAUDE.local.md               # Runtime state (gitignored)
├── chati.dev/
│   ├── orchestrator/             # Main orchestrator
│   ├── agents/                   # 13 agent definitions
│   │   ├── discover/             # Greenfield WU, Brownfield WU, Brief
│   │   ├── plan/                 # Detail, Architect, UX, Phases, Tasks
│   │   ├── quality/              # QA-Planning, QA-Implementation
│   │   ├── build/                # Dev
│   │   └── deploy/               # DevOps
│   ├── workflows/                # 6 workflow blueprints
│   ├── templates/                # 6 artifact templates
│   ├── schemas/                  # 5 JSON schemas
│   ├── intelligence/             # PRISM, RECALL, COMPASS specs
│   ├── domains/                  # Per-agent and per-workflow configs
│   ├── hooks/                    # 6 Claude Code hooks
│   ├── context/                  # Context files (deployed to .claude/rules/)
│   ├── frameworks/               # Decision heuristics
│   ├── quality-gates/            # Planning & implementation gates
│   ├── patterns/                 # Elicitation patterns
│   ├── data/                     # Entity registry
│   ├── i18n/                     # EN, PT, ES, FR translations
│   ├── migrations/               # Version migration scripts
│   ├── constitution.md           # 19 Articles + Preamble
│   └── config.yaml               # System configuration
└── packages/
    └── chati-dev/                # CLI + runtime engine

Internationalization

The installer and agent interactions support 4 languages:

Language Code Status
English en Default
Portugues pt Full support
Espanol es Full support
Francais fr Full support

Artifacts are always generated in English for portability and team collaboration.


Upgrade System

npx chati-dev check-update                # Check for updates
npx chati-dev upgrade                      # Upgrade to latest
npx chati-dev upgrade --version 1.2.1      # Specific version

Upgrades include automatic backup, migrations, validation, and config merging. Rollback on failure.


Contributing

We welcome contributions — agents, templates, workflows, translations, and CLI improvements. See CONTRIBUTING.md for guidelines.

Security

For security concerns, see our Security Policy.

License

MIT


Built with structure, validated by agents, governed by constitution.
Chati.dev © 2026

Sponsor this project

Packages

No packages published

Contributors 2

  •  
  •