ultra-dex 1.8.0 → 2.2.1

package/README.md

@@ -1,219 +1,244 @@
 # Ultra-Dex CLI
 
-> Scaffold Ultra-Dex projects from the command line.
+> Scaffold Ultra-Dex projects from the command line, now with **AI-powered plan generation**.
 
-## First 10 Minutes
+## What's New in v2.1
 
 ```bash
-# 1. Create your project (2 min)
-npx ultra-dex init
+# 🚀 Generate a complete 34-section plan with AI
+npx ultra-dex generate "A task management SaaS for remote teams"
 
-# 2. Open and review QUICK-START.md (3 min)
-cd your-project
-cat QUICK-START.md
+# 🔧 Start AI-assisted development
+npx ultra-dex build --agent planner
 
-# 3. Load Cursor rules for AI assistance (1 min)
-# Rules are bundled; choose "Include cursor-rules" when prompted.
-#
-# Optional offline bundle:
-# npx ultra-dex fetch --rules --docs --agents
+# 🔍 Review code against plan
+npx ultra-dex review
+
+# 📊 Quick alignment check
+npx ultra-dex align
+```
 
-# 4. Start building with AI agents (4 min)
-# Use @Backend, @Frontend, @Database agents
-npx ultra-dex agents
+## First 10 Minutes
+
+```bash
+# Option 1: AI-Generated Plan (Recommended)
+export ANTHROPIC_API_KEY=your-key  # or OPENAI_API_KEY or GOOGLE_AI_KEY
+npx ultra-dex generate "Your SaaS idea here"
 
-# You're ready to code!
+# Option 2: Manual Setup
+npx ultra-dex init
 ```
 
 ## Installation
 
 ```bash
 # Run directly with npx (no installation needed)
-npx ultra-dex init
+npx ultra-dex generate "Your idea"
 
 # Or install globally
 npm install -g ultra-dex
-ultra-dex init
+ultra-dex generate "Your idea"
 ```
 
-## Usage
+## AI Commands (v2.0+)
 
-### Initialize a new project
+### `generate` - AI Plan Generation
+
+Generate a complete implementation plan using AI:
 
 ```bash
-npx ultra-dex init
+# Basic usage
+npx ultra-dex generate "A booking platform for dog groomers"
+
+# With options
+npx ultra-dex generate "idea" --provider openai --output ./my-project
+
+# Preview without calling AI
+npx ultra-dex generate "idea" --dry-run
 ```
 
-This will:
-1. Ask you about your SaaS idea
-2. Gather tech stack preferences
-3. Create starter files:
-   - `QUICK-START.md` - Pre-filled with your answers
-   - `CONTEXT.md` - Project context for AI agents
-   - `IMPLEMENTATION-PLAN.md` - Links to full resources
+**Options:**
+| Option | Description | Default |
+|--------|-------------|---------|
+| `-p, --provider` | AI provider (claude, openai, gemini) | claude |
+| `-m, --model` | Specific model to use | provider default |
+| `-o, --output` | Output directory | current |
+| `-k, --key` | API key | env variable |
+| `--dry-run` | Show structure only | false |
+
+### `build` - AI-Assisted Development
 
-### List examples
+Start development with AI agents:
 
 ```bash
-npx ultra-dex examples
+# Interactive agent selection
+npx ultra-dex build
+
+# Specific agent
+npx ultra-dex build --agent backend --task "Create user API endpoints"
+
+# Copy to clipboard for external AI
+npx ultra-dex build --agent planner --copy
 ```
 
-Shows links to fully filled Ultra-Dex examples:
-- TaskFlow (Task Management)
-- InvoiceFlow (Invoicing)
-- HabitStack (Habit Tracking)
+**Available Agents:**
+| Agent | Role |
+|-------|------|
+| `planner` | Break down features into atomic tasks |
+| `cto` | Architecture decisions |
+| `backend` | API endpoints and business logic |
+| `frontend` | UI components and pages |
+| `database` | Schema design and migrations |
+| `auth` | Authentication and authorization |
+| `security` | Security audit |
+| `testing` | Write and run tests |
+| `reviewer` | Code review |
+| `devops` | Deployment and CI/CD |
 
-### Audit your project
+### `review` - Code Review
+
+Check code alignment with plan:
 
 ```bash
-npx ultra-dex audit
+npx ultra-dex review
+npx ultra-dex review --dir ./src
 ```
 
-Checks your project for completeness:
-- Required files (QUICK-START.md, CONTEXT.md, etc.)
-- Key sections (idea, problem, MVP, tech stack)
-- Implementation details (database, API, auth)
+### `align` - Quick Score
 
-Outputs a score and grade (A-F) with suggestions.
+Get alignment score instantly:
 
-### List AI agents
+```bash
+npx ultra-dex align
+npx ultra-dex align --json  # Machine-readable output
+```
 
+**Environment Variables:**
 ```bash
-npx ultra-dex agents
+ANTHROPIC_API_KEY=sk-ant-...  # Claude (recommended)
+OPENAI_API_KEY=sk-...         # OpenAI
+GOOGLE_AI_KEY=...             # Gemini
 ```
 
-Shows available AI agent prompts:
-- CTO, Backend, Frontend, Database
-- Auth, DevOps, Reviewer, Debugger, Planner
+### `init`
 
-### Get agent prompt
+Interactive project setup:
 
 ```bash
-npx ultra-dex agent backend
+npx ultra-dex init
 ```
 
-Prints the full agent prompt. Copy and paste into your AI tool (Cursor, Claude, ChatGPT).
-
-### Set up git hooks
+Generate a runnable scaffold:
 
 ```bash
-npx ultra-dex hooks
+npx ultra-dex init --live --stack next15-prisma-clerk
 ```
 
-Installs a pre-commit hook that:
-- Validates project structure before each commit
-- Blocks commits if required files are missing
-- Can be bypassed with `git commit --no-verify`
+Presets: `next15-prisma-clerk`, `remix-supabase`, `sveltekit-drizzle`.
+
+**Options (init):**
+| Option | Description |
+|--------|-------------|
+| `-n, --name <name>` | Project name (skips prompt) |
+| `-d, --dir <directory>` | Output directory (default: current) |
+| `--preview` | Preview files without creating them |
+| `--live` | Generate a runnable scaffold |
+| `--stack <preset>` | Preset: next15-prisma-clerk, remix-supabase, sveltekit-drizzle |
 
-Remove with: `npx ultra-dex hooks --remove`
+### `audit`
 
-### Fetch assets for offline use
+Check project completeness:
 
 ```bash
-npx ultra-dex fetch
+npx ultra-dex audit
 ```
 
-Downloads all Ultra-Dex assets locally for offline development:
-- Cursor rules (12 .mdc files)
-- Agent prompts (16 agents)
-- Documentation and guides
+### `agents`
 
-Options:
-- `--dir <path>` - Target directory (default: `.ultra-dex`)
-- `--agents` - Fetch only agent prompts
-- `--rules` - Fetch only cursor rules
-- `--docs` - Fetch only documentation
+List and use AI agent prompts:
 
-After fetching, copy to your project:
 ```bash
-cp -r .ultra-dex/cursor-rules .cursor/rules
-cp -r .ultra-dex/agents .agents
+npx ultra-dex agents           # List all agents
+npx ultra-dex agent backend    # Show specific agent
 ```
 
-### Serve context (MCP-compatible)
+### `fetch`
+
+Download assets for offline use:
 
 ```bash
-npx ultra-dex serve --port 3001
+npx ultra-dex fetch
+npx ultra-dex fetch --agents --rules
 ```
 
-Endpoints:
-- `GET /` health check
-- `GET /context` returns CONTEXT.md, IMPLEMENTATION-PLAN.md, QUICK-START.md
+### `serve`
 
-## Commands
+Serve context (MCP-compatible):
+
+```bash
+npx ultra-dex serve --port 3001
+```
+
+### Other Commands
 
 | Command | Description |
 |---------|-------------|
-| `ultra-dex init` | Initialize a new project |
-| `ultra-dex init --preview` | Preview files without creating them |
-| `ultra-dex audit` | Audit project for completeness |
-| `ultra-dex examples` | List available examples |
-| `ultra-dex agents` | List available AI agents |
-| `ultra-dex agent <name>` | Show specific agent prompt |
-| `ultra-dex pack <agent>` | Package context + agent for any AI |
-| `ultra-dex hooks` | Set up git pre-commit hooks |
-| `ultra-dex fetch` | Download assets for offline use |
-| `ultra-dex serve` | Serve context over HTTP |
-| `ultra-dex validate` | Validate project structure |
-| `ultra-dex workflow <feature>` | Show workflow for a feature |
-| `ultra-dex suggest` | Get AI agent suggestions |
-| `ultra-dex --help` | Show help |
-| `ultra-dex --version` | Show version |
-
-## Options
-
-### init
+| `init` | Initialize a new project |
+| `init --preview` | Preview files without creating them |
+| `init --live` | Generate a runnable scaffold |
+| `audit` | Audit project for completeness |
+| `examples` | List available examples |
+| `agents` | List AI agents |
+| `agent <name>` | Show specific agent prompt |
+| `hooks` | Set up git pre-commit hooks |
+| `fetch` | Download assets for offline |
+| `serve` | Serve context over HTTP |
+| `validate` | Validate project structure |
+| `workflow <feature>` | Show workflow for a feature |
+| `suggest` | Get AI agent suggestions |
+| `--help` | Show help |
+| `--version` | Show version |
+
+## Example: AI Generation
 
-| Option | Description |
-|--------|-------------|
-| `-n, --name <name>` | Project name (skips prompt) |
-| `-d, --dir <directory>` | Output directory (default: current) |
+```bash
+$ npx ultra-dex generate "A booking platform for dog groomers"
 
-### audit
+🚀 Ultra-Dex AI Plan Generator
 
-| Option | Description |
-|--------|-------------|
-| `-d, --dir <directory>` | Directory to audit (default: current) |
+✔ AI modules loaded
 
-## Example
+📝 Idea: "A booking platform for dog groomers"
 
-```bash
-$ npx ultra-dex init
-
-╔═══════════════════════════════════════════════════════════╗
-║   ULTRA-DEX                                               ║
-║   From Idea to Production-Ready SaaS                      ║
-╚═══════════════════════════════════════════════════════════╝
-
-Welcome to Ultra-Dex! Let's plan your SaaS.
-
-? What's your project name? my-saas
-? What are you building? A booking platform for dog groomers
-? Who is it for? Independent dog grooming businesses
-? Problem #1 you're solving: Manual booking via phone is time-consuming
-? Problem #2 you're solving: No-shows cost money
-? Problem #3 you're solving: No online presence
-? Most important MVP feature: Online booking calendar
-? Frontend framework: Next.js
-? Database: PostgreSQL
-? Authentication: NextAuth
-? Payments: Stripe
-? Hosting: Vercel
-
-✔ Project created successfully!
-
-Files created:
-  my-saas/
-  ├── QUICK-START.md
-  ├── CONTEXT.md
-  ├── IMPLEMENTATION-PLAN.md
-  ├── .cursor/rules/ (11 AI rule files)
-  └── .agents/ (9 AI agent prompts)
+✓ Using Claude (Anthropic) (claude-sonnet-4-20250514)
+
+📊 Estimated Generation:
+   Input tokens:  ~2,650
+   Output tokens: ~40,000
+   Estimated cost: ~$0.45
+
+? Proceed with generation? Yes
+
+⚡ Generating 34-section implementation plan...
+
+✔ Generation complete!
+
+✅ All 34 sections generated
+   Tokens used: 42,350 tokens (2,650 in / 39,700 out)
+   Actual cost: $0.52
+
+📦 Project: GroomBook
+
+✓ Created ./IMPLEMENTATION-PLAN.md
+✓ Created ./QUICK-START.md
+✓ Created ./CONTEXT.md
+
+🎉 Generation complete!
 
 Next steps:
-  1. cd my-saas
-  2. Open QUICK-START.md and complete it
-  3. Start building! 🚀
+  1. Review IMPLEMENTATION-PLAN.md
+  2. Customize sections as needed
+  3. Start building with: npx ultra-dex init
 ```
 
 ## Links

package/assets/agents/0-orchestration/orchestrator.md

@@ -1,13 +1,13 @@
 # @Orchestrator - Meta Agent
 
-> **Role**: Coordinate all 15 agents for complete feature implementation
+> **Role**: Coordinate all 16 agents for complete feature implementation
 > **When to Use**: Building a complete feature that spans architecture, implementation, security, testing, and deployment
 
 ---
 
 ## System Prompt
 
-You are the **Ultra-Dex Orchestrator**, a meta-agent that coordinates all 15 specialized agents to build complete, production-ready features. Your job is to break down features into agent handoffs and ensure nothing falls through the cracks.
+You are the **Ultra-Dex Orchestrator**, a meta-agent that coordinates all 16 specialized agents to build complete, production-ready features. Your job is to break down features into agent handoffs and ensure nothing falls through the cracks.
 
 ---
 

package/assets/docs/QUICK-REFERENCE.md

@@ -10,7 +10,7 @@ One-page cheatsheet for AI-driven SaaS development.
 # Initialize Ultra-Dex in your project
 npx ultra-dex init
 
-# List all 15 agents
+# List all 16 agents
 npx ultra-dex agents
 
 # Show specific agent
@@ -139,7 +139,7 @@ npx ultra-dex init              # Interactive setup
 npx ultra-dex init --yes        # Use defaults
 
 # Agents
-npx ultra-dex agents            # List all 15 agents
+npx ultra-dex agents            # List all 16 agents
 npx ultra-dex agent backend     # Show backend agent
 npx ultra-dex agent cto         # Show CTO agent
 
@@ -216,7 +216,7 @@ Use different AI tools for different tasks:
 
 **Core:**
 - [Main README](./README.md) - Project overview
-- [Agent Index](./agents/00-AGENT_INDEX.md) - All 15 agents
+- [Agent Index](./agents/00-AGENT_INDEX.md) - All 16 agents
 - [Guide Directory](./guides/README.md) - All guides
 - [CHANGELOG](./CHANGELOG.md) - Version history
 

package/assets/docs/ROADMAP.md

@@ -12,7 +12,7 @@ By 2027, developers should think: "Building a SaaS? Use Ultra-Dex + AI agents."
 
 ---
 
-## Current State (v1.7.3) ✅
+## Current State (v2.1.0) ✅
 
 **Released: January 26, 2026**
 
@@ -339,7 +339,7 @@ Integrate Ultra-Dex directly into development platforms.
 
 | Tier | Price | What You Get |
 |------|-------|--------------|
-| **Core** | Free | Full framework, 15 agents, CLI, templates, community support |
+| **Core** | Free | Full framework, 16 agents, CLI, templates, community support |
 | **Pro Playbooks** | $49-149 | Industry-specific playbooks (Healthcare SaaS, Fintech, E-commerce) with compliance guidance |
 | **Team License** | $29/user/mo | Shared configs, audit logs, priority support, custom agent builder |
 | **Enterprise** | Custom | Self-hosted, SSO, dedicated support, SLA, custom integrations |
@@ -357,7 +357,7 @@ Integrate Ultra-Dex directly into development platforms.
 - **Enterprise** - When demand justifies (target: 10+ inbound requests)
 
 ### What Will NEVER Be Paid
-- Core 15 agents
+- Core 16 agents
 - CLI tool
 - All existing templates and guides
 - Community support (GitHub, Discord)
@@ -471,10 +471,10 @@ Integrate Ultra-Dex directly into development platforms.
 
 *This roadmap is a living document and will evolve based on community feedback and real-world usage.*
 
-*Last updated: January 26, 2026 - v1.7.3 released, offline mode added*
+*Last updated: January 26, 2026 - v2.1.0 released, offline mode added*
 
 ---
 
-*Ultra-Dex v1.7.3 - Professional AI Orchestration Meta Layer*
+*Ultra-Dex v2.1.0 - Professional AI Orchestration Meta Layer*
 
 **The future is collaborative AI-driven development. Let's build it together.** 🚀

package/assets/docs/WORKFLOW-DIAGRAMS.md

@@ -390,7 +390,7 @@ graph TD
 - [Multi-Tool Workflow](./guides/MULTI-TOOL-WORKFLOW.md) - Coordinate multiple AIs
 
 **Agent Reference:**
-- [Agent Index](./agents/00-AGENT_INDEX.md) - All 15 agents with "when to use"
+- [Agent Index](./agents/00-AGENT_INDEX.md) - All 16 agents with "when to use"
 - [Agents README](./agents/README.md) - Tier-based organization
 
 **Decision Guides:**

package/assets/templates/README.md

@@ -374,7 +374,7 @@ Both templates are **fully customizable**. Common modifications:
 - [Advanced Workflows](../guides/ADVANCED-WORKFLOWS.md) - Real-world examples
 
 **Agent Prompts:**
-- [Agent Index](../agents/00-AGENT_INDEX.md) - Quick reference for all 15 agents
+- [Agent Index](../agents/00-AGENT_INDEX.md) - Quick reference for all 16 agents
 - [Agents Directory](../agents/) - Full agent prompt library
 
 **Core Framework:**