Skip to content
This repository was archived by the owner on Mar 5, 2026. It is now read-only.

Repository files navigation

SAZ‑Mini v3.0 (SuperAgent‑Zero Mini)

The intelligent, adaptive orchestration framework that turns Claude Code into a proactive development companion with zero-question starts, progressive complexity scaling, and standardized memory protocols — enhanced with the philosophy of "Enhance, Don't Replace."

SAZ-Mini v3.0 brings proactive detection that eliminates unnecessary questions, progressive complexity that scales with your project, and consistent memory integration across all agents for seamless handoffs.

🚀 Quick Start

# Install globally
curl -sSL https://raw.githubusercontent.com/Gravicity/SAZ-Mini/main/install.sh | bash

# Setup any project
cd /your/project
~/.saz-mini/setup.sh         # creates docs/project.manifest.json
# Optional PRD stubs
~/.saz-mini/setup.sh --PRD   # seeds minimal docs/prd/ stubs

# Activate in Claude Code
claude   # or /init if already running

🎯 Key Features

Proactive Detection

  • Auto-detects project context (Node.js, Python, etc.) before asking questions
  • 80% of projects start with zero questions
  • Smart bundle matching for common patterns (SaaS, e-commerce, API)

Progressive Complexity

  • Level 1: Simple tasks (1-2 agents, memory only)
  • Level 2: Standard projects (3-5 agents, memory + workflows)
  • Level 3: Complex systems (6+ agents, full manifest orchestration)

Consistent Memory

  • All agents use standardized memory format
  • Clear "✅ Task Complete" signals
  • Seamless handoffs between specialists

🎯 How It Works

  1. Auto-Detection: SAZ-Mini scans your project and detects context
  2. Smart Routing: Routes to appropriate agents based on urgency and complexity
  3. Progressive Scaling: Uses simple memory for small tasks, full orchestration for complex projects
  4. Bundle Intelligence: Recommends specialist bundles for common patterns (SaaS, e-commerce, API)

First interaction:

User: "URGENT: My payment system is down!"
SuperAgent: 🚨 Emergency detected - activating direct action mode.
→ Immediate debugging without orchestration delays

User: "I'm new to React, teach me components"  
SuperAgent: 📚 Educational mode - I'll guide you step by step.
→ Tutorial-focused learning path with progressive complexity

User: "Generate some ideas for a micro SaaS"
SuperAgent: 💡 Brainstorming mode - I'll use brainstorming-specialist.
→ Creative ideation with structured idea documentation

User: "Build a complex e-commerce platform"
SuperAgent: 🎭 Multi-agent orchestration required.
→ Coordinated specialist deployment with shared memory

🎛️ Orchestration Modes

  • Build Mode (Greenfield): plan → PRD → lanes/tasks → parallel execution → deploy
  • Improve Mode (Existing): analyze → plan updates → readiness check → targeted execution → deploy

Readiness & Bundle System

  • Continuous Readiness: after each agent completion, recompute ready tasks from manifest (dependsOn, canRunParallel, gates) and propose next Tasks.
  • Bundle Creation: When patterns match (SaaS, e-commerce, API), create entire specialist bundles with single restart for efficiency.

🧰 Agents

Starter (always available): project-planner, project-analyzer, memory-manager, agent-generator, brainstorming-specialist (5 agents)

Patterns (created on demand via agent-generator): nextjs-app-builder, api-integration-specialist, database-architect, ui-component-builder, deployment-automation-specialist, performance-optimizer, debug-specialist, integration-coordinator, pdf-generator, tutorial-guide, auth-specialist, payment-processor (12+ specialists)

Intelligence Modes

  • 🚨 Emergency: Urgent issues get immediate debugging (no delays)
  • 📚 Educational: Adapts to learning level with progressive tutorials
  • 💡 Brainstorming: Structured ideation with feasibility analysis
  • 🎭 Multi-Agent: Coordinates teams of specialists for complex projects

🧰 Available Agents

Starter Agents (5 - Always Available)

  • project-planner - Roadmaps with bundle recommendations
  • project-analyzer - Codebase analysis and gap detection
  • memory-manager - Knowledge retrieval and handoff coordination
  • agent-generator - Creates specialists and bundles on demand
  • brainstorming-specialist - Ideation and concept development

Specialist Templates (12+ - Created on Demand)

Created via agent-generator when needed, or as bundles:

Bundles (Multiple specialists at once):

  • saas-pack: auth, payment, deployment specialists
  • ecommerce-pack: inventory, payment, ui specialists
  • api-pack: rate-limiting, auth, deployment specialists
  • mobile-pack: react-native, push notifications, app store
  • data-pack: ETL, ML, visualization specialists

Individual Specialists: Frontend (nextjs-app-builder, ui-component-builder), Backend (api-integration-specialist, database-architect), Operations (deployment-automation-specialist, performance-optimizer, debug-specialist), Specialized (pdf-generator, tutorial-guide, integration-coordinator)

💻 Example Interactions

# Emergency
User: "CRITICAL: Payment system down!"
SAZ: 🚨 Emergency detected → immediate debugging

# Learning
User: "Teach me React hooks"
SAZ: 📚 Educational mode → creates tutorial-guide → progressive learning

# Brainstorming
User: "Generate SaaS ideas"
SAZ: 💡 Brainstorming mode → structured ideation in ideas/ folder

# Complex Project
User: "Build e-commerce platform"
SAZ: 🎭 Recommends ecommerce-pack bundle → multi-agent coordination

🏗️ Installation & Architecture

docs/
  prd/                     # PRD pack by project-planner
  project.manifest.json    # SSOT: PRD, lanes/tasks, artifacts, events
.saz/
  memory/
    project.md             # Thin index; links to manifest
    insights.md            # Bullets referencing manifest ids
deliverables/
  <agent>/<date>/...       # Notes/reports/examples (supporting)

🔧 Typical Flows

  • Greenfield build:

    1. Task(project-planner) → writes PRD + lanes/tasks + event
    2. Task(agent-generator) (batch) → specialists
    3. Execute lanes in parallel (respect dependsOn/quality_gates)
    4. Task(deployment-automation-specialist) → CI/CD + deploy
  • Improve existing:

    1. Task(project-analyzer) → optional docs/state/ + event
    2. Task(project-planner) → update lanes/tasks + event
    3. Task(memory-manager) → readiness check
    4. Task(performance-optimizer | api-integration-specialist | ui-component-builder …)

🐛 Troubleshooting

# If agents aren't loading
~/.saz-mini/health-check.sh

# Complete uninstall & reinstall
rm -rf ~/.saz-mini/
curl -sSL https://raw.githubusercontent.com/Gravicity/SAZ-Mini/main/install.sh | bash

🔮 Philosophy & Vision v3.0

SAZ-Mini v3.0 embodies "Proactive Intelligence with Progressive Scaling":

  • Proactive Detection - Auto-detect context before asking questions
  • Progressive Complexity - Scale orchestration to actual project needs
  • Memory Excellence - Consistent protocols for seamless handoffs
  • Bundle Intelligence - Smart grouping of related specialists
  • Emergency First - Critical issues get immediate attention
  • Enhance, Don't Replace - Preserve all capabilities while reducing noise

🚀 The Future of Development

SAZ-Mini v3.0 isn't just a better orchestration tool - it's a fundamental shift toward proactive, zero-friction development that:

Detects context automatically before asking questions ✅ Scales complexity progressively based on actual needs ✅ Maintains consistent memory for perfect handoffs ✅ Creates specialist bundles for common patterns ✅ Responds to emergencies with zero delays ✅ Provides clear completion signals for every task


📄 License

MIT License


🎯 Ready for the next generation of AI-assisted development?

SAZ-Mini v3.0 transforms Claude Code into a proactive development companion that detects context automatically, scales complexity progressively, and maintains consistent memory for perfect handoffs.

🔑 Key Architecture Summary

Immediate (5 Starter Agents):

  • project-planner, project-analyzer, memory-manager, agent-generator, brainstorming-specialist

On-Demand (12+ Pattern Templates & Bundles):

  • Specialists: tutorial-guide, performance-optimizer, nextjs-app-builder, api-integration-specialist, database-architect, ui-component-builder, deployment-automation-specialist, debug-specialist, pdf-generator, integration-coordinator, auth-specialist, payment-processor
  • Bundles: saas-pack, ecommerce-pack, api-pack, mobile-pack, data-pack

Process: agent-generator creates → restart Claude Code → specialist available

🚀 Install SAZ-Mini v3.0 and experience proactive, zero-question development orchestration.

"From reactive assistance to proactive detection with progressive complexity and bundle intelligence - SAZ-Mini v3.0 eliminates friction and scales with your needs."

About

The intelligent, adaptive orchestration framework that transforms Claude Code into a contextually-aware development companion with emergency response, educational guidance, and sophisticated multi-agent coordination.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages