agentic-flow

# 🚀 Agentic-Flow v2

> **Production-ready AI agent orchestration with 66 self-learning agents, 213 MCP tools, and autonomous multi-agent swarms.**

[![npm version](https://badge.fury.io/js/agentic-flow.svg)](https://www.npmjs.com/package/agentic-flow)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![TypeScript](https://img.shields.io/badge/TypeScript-5.9-blue.svg)](https://www.typescriptlang.org/)
[![Node.js](https://img.shields.io/badge/Node.js-18%2B-green.svg)](https://nodejs.org/)

---

## ⚡ Quick Start (60 seconds)

```bash
# 1. Initialize your project
npx agentic-flow init

# 2. Bootstrap intelligence from your codebase
npx agentic-flow hooks pretrain

# 3. Start Claude Code with self-learning hooks
gemini
```

That's it! Your project now has:
- 🧠 **Self-learning hooks** that improve agent routing over time
- 🤖 **80+ specialized agents** (coder, tester, reviewer, architect, etc.)
- ⚡ **Background workers** triggered by keywords (ultralearn, optimize, audit)
- 📊 **213 MCP tools** for swarm coordination

### Common Commands

```bash
# Route a task to the optimal agent
npx agentic-flow hooks route "implement user authentication"

# View learning metrics
npx agentic-flow hooks metrics

# Dispatch background workers
npx agentic-flow workers dispatch "ultralearn how caching works"

# Run MCP server for Claude Code
npx agentic-flow mcp start
```

### Use in Code

```typescript
import { AgenticFlow } from 'agentic-flow';

const flow = new AgenticFlow();
await flow.initialize();

// Route task to best agent
const result = await flow.route('Fix the login bug');
console.log(`Best agent: ${result.agent} (${result.confidence}% confidence)`);
```

---

## 🎉 What's New in v2

### **SONA: Self-Optimizing Neural Architecture** 🧠

Agentic-Flow v2 now includes **SONA** (@ruvector/sona) for sub-millisecond adaptive learning:

- 🎓 **+55% Quality Improvement**: Research profile with LoRA fine-tuning
- ⚡ **<1ms Lear