Agni (அக்னி)

Context-Injection Engine & SDLC Orchestration Platform

Visualize, plan, and inject context to keep CLI tools within architectural guardrails.

---

What is Agni?

"Agni" means "fire" in Tamil — the transformative force that refines raw materials into finished products. Agni is a two-layer system for solo developers managing multiple projects:

1. Dashboard (Visualization Layer) — See the big picture, edit PRDs/Blueprints, plan sprints
2. CLI/MCP (Injection Layer) — Feed CLI tools exactly what they need with constraint guardrails

The Problems Agni Solves

Problem	Solution
Context-CLI Gap	MCP Server + CLI for instant context injection
Blueprint Maintenance	AGNI_SPEC comments auto-sync to specs
Silent Logic Failures	Constraint Guard blocks enforce architectural rules

Architecture

┌─────────────────────────────────────────────────────────────────┐
│                     AGNI DASHBOARD (Next.js)                     │
│  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌────────┐ │
│  │ Refinery │ │ Foundry  │ │ Planner  │ │Assembler │ │Validator│ │
│  │  (PRD)   │ │(Blueprint)│ │  (WOs)   │ │  (Dev)   │ │(Feedback)│
│  └──────────┘ └──────────┘ └──────────┘ └──────────┘ └────────┘ │
└────────────────────────────┬────────────────────────────────────┘
                             │
                    ┌────────┴────────┐
                    │  Knowledge Graph │
                    │    (Supabase)    │
                    └────────┬────────┘
                             │
┌────────────────────────────┴────────────────────────────────────┐
│                    AGNI CLI + MCP SERVER                         │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐              │
│  │    CLI      │  │     MCP     │  │  Constraint │              │
│  │  Commands   │  │   Server    │  │    Guard    │              │
│  └─────────────┘  └─────────────┘  └─────────────┘              │
└─────────────────────────────────────────────────────────────────┘

Project Structure

agni/
├── apps/
│   ├── cli/                 # Agni CLI (TypeScript + Commander.js)
│   │   └── src/
│   │       ├── commands/    # get-context, wo, sync-spec, run
│   │       └── lib/         # Supabase client, parsers
│   ├── mcp-server/          # MCP server for IDE integration
│   │   └── src/
│   │       ├── tools/       # MCP tool handlers
│   │       └── lib/         # Context generation
│   └── dashboard/           # Next.js 14 web app (App Router)
├── packages/
│   ├── shared/              # Shared types, Zod schemas
│   │   ├── types/           # TypeScript interfaces
│   │   └── schemas/         # Zod validation schemas
│   └── supabase/            # Database migrations
│       └── migrations/
├── docs/                    # Architecture documentation
├── examples/                # Example .agni-context setups
│   └── .agni-context/
├── agni-spec.md             # Full specification (source of truth)
├── CLAUDE.md                # AI assistant instructions
├── STATUS.md                # Current project status
└── CHECKPOINT.md            # Development checkpoints

Tech Stack

Component	Technology	Rationale
Database	Supabase (PostgreSQL + pgvector)	Real-time, auth, storage
Backend	Supabase Edge Functions	Serverless logic
Dashboard	Next.js 14 (App Router)	SSR + API routes
UI	Tailwind + shadcn/ui	Fast, accessible
CLI	TypeScript + Commander.js	Cross-platform
MCP	@modelcontextprotocol/sdk	Claude Code/Cursor integration

Quick Start

# Clone the repository
git clone https://github.com/your-org/agni.git
cd agni

# Install dependencies (when implemented)
npm install

# Set up environment
cp .env.example .env.local
# Edit .env.local with your Supabase credentials

# Run CLI
npm run cli -- get-context --project myproject

# Run MCP Server
npm run mcp

# Run Dashboard
npm run dev

CLI Commands (Planned)

# Context Injection
agni get-context --feature <name>      # Get feature context
agni get-context --work-order <id>     # Get WO with Constraint Guard
agni get-context --project <name>      # Get project foundations

# Work Order Management
agni wo list                           # List work orders
agni wo start <id>                     # Start WO, inject context
agni wo done <id>                      # Mark complete

# Sync Operations
agni sync-spec                         # Parse AGNI_SPEC → update Blueprints
agni sync-context                      # Pull latest .agni-context

# Terminal Capture
agni-run "npm run build"               # Capture failures as bugs

# Temporal Features
agni diff                              # What changed since last session
agni freeze AUTH_PROVIDER              # Mark decision as final

Development

See CLAUDE.md for detailed development instructions compatible with AI coding assistants.

See STATUS.md for current project status.

See CHECKPOINT.md for development checkpoints.

Git Worktrees

This project uses git worktrees for parallel development:

Directory	Branch	Purpose
Agni/	main	Integration, releases, documentation
Agni-cli/	feature/cli	CLI development
Agni-mcp/	feature/mcp-server	MCP Server
Agni-dashboard/	feature/dashboard	Next.js dashboard
Agni-schema/	feature/supabase-schema	Database migrations

License

MIT