specification

🤖 Claude Code Multi-Agent System

An INFJ-driven multi-agent development system combining rigorous technical standards with high-trust delegation. 30+ specialized agents work autonomously under strategic orchestration to deliver high-quality TypeScript applications with 100% test coverage.

🎯 Overview

This repository hosts an INFJ-orchestrated multi-agent system for TypeScript development. The orchestrator thinks mathematically, acts strategically, and values truth over ego. The system combines:

• 30 specialized agents with autonomous execution capabilities
• High-clarity, high-trust delegation with complete context and success metrics
• Constitution-based workflows creating conditions for strong thinking
• 100% test coverage with systematic TDD approach
• Learning-oriented quality - every correction upgrades the system

🏗️ Architecture

Agent Orchestration Layers

┌─────────────────────────────────────────────────┐
│         User Approval & High-Level Direction    │
└─────────────────────┬───────────────────────────┘
                      │
┌─────────────────────▼───────────────────────────┐
│    CLAUDE.md Gateway (Task Routing & Rules)     │
├─────────────────────┬───────────────────────────┤
│  Global Settings    │    Project Constitution   │
│  (~/.claude/)       │    (./.claude/)           │
└─────────────────────┼───────────────────────────┘
                      │
┌─────────────────────▼───────────────────────────┐
│        30 Specialized Agents (Parallel)         │
├─────────────────────────────────────────────────┤
│ • Frontend (React/Next.js)                      │
│ • Backend (Node/TypeScript)                     │
│ • Architecture & Design                         │
│ • Security & Quality                            │
│ • DevOps & Infrastructure                       │
└─────────────────────┬───────────────────────────┘
                      │
┌─────────────────────▼───────────────────────────┐
│    Constitution Workflows (Mandatory)            │
├─────────────────────────────────────────────────┤
│ • TDD Development    • Code Review              │
│ • Git Workflows      • Security Gates           │
│ • Quality Standards  • Documentation            │
└─────────────────────────────────────────────────┘

🤖 Agent Roster

Development Teams

Frontend Excellence

• lily-wong-ui-implementation - React/Next.js UI implementation expert
• leo-yamamoto-ux-designer - UX/UI design and user research
• sophie-laurent-design-systems - Design systems and component libraries

Backend Engineering

• james-mitchell-service-implementation - Node.js/TypeScript services
• ethan-kumar-data-architect - Database design and optimization
• casey-murphy-integration-specialist - API integrations and webhooks

Full-Stack & Architecture

• priya-sharma-fullstack - Full-stack TypeScript development
• alex-chen-architect - System architecture and technical strategy
• jordan-lee-api-designer - RESTful and GraphQL API design

Quality & Security

• ava-thompson-testing-evangelist - TDD and test coverage champion
• nina-petrov-security-champion - Security reviews and threat modeling
• marcus-williams-code-quality - Code reviews and refactoring

Infrastructure & Operations

• felix-anderson-devops - CI/CD and automation
• luna-park-sre - Site reliability and monitoring
• isabella-costa-cloud-architect - Cloud infrastructure design

Innovation & Research

• phoenix-wright-innovation-catalyst - Innovation and rapid prototyping
• nova-chen-research-engineer - Technology evaluation
• oliver-singh-data-scientist - Machine learning and analytics

View All 30 Agents →

📋 Constitution System

The constitution directory contains the single source of truth for all development practices:

Directory Structure

constitutions/
├── workflows/      # HOW to do things (step-by-step)
│   ├── coding/
│   │   ├── prepare-coding.md
│   │   └── write-code.md
│   ├── frontend/
│   │   └── build-component.md
│   ├── backend/
│   │   ├── build-service.md
│   │   └── verify-auth-scope.md
│   └── quality/
│       ├── review-code.md
│       └── approve-pr.md
├── standards/      # WHAT the rules are
│   ├── typescript-standards.md
│   └── react-patterns.md
├── patterns/       # Templates and examples
│   ├── component-template.tsx
│   └── service-template.ts
└── references/     # Quick lookup info
    ├── commit-examples.md
    └── tech-stack.md

🚀 Getting Started

Prerequisites

• Node.js 22 LTS
• pnpm 9.x
• TypeScript ≥5.8
• Claude Code CLI

Installation

# Clone the repository
git clone <repository-url>
cd <repository-name>

# Install dependencies
pnpm install

# Initialize constitution compliance
pnpm constitution:init

Basic Usage

1. Start with a high-level objective: