aizen-gate

⛩️ Aizen-Gate: The Premier AI-Orchestration & Specification Shield

Aizen-Gate is an elite SDLC (Software Development Life Cycle) framework that transforms standard AI interactions into a professional, multi-agent Scrum Team execution. Version 2.1 introduces a high-end Modular Architecture (src/), consolidating core logic for maximum scalability, security, and performance.

🏛️ New in v2.1: Modular Professional Architecture

To support large-scale AI orchestration, we've restructured the entire codebase into domain-specific modules:

• src/ai/: Intelligent token budget and output filtering.
• src/memory/: 5-Tier SQL-backed persistent memory & context engineering.
• src/orchestration/: Autonomous loop, dependency graphs, and worktree managers.
• src/quality/: Shield diagnostics, benchmarking, and UAT verification.
• src/missions/: Unified mission engines for flexible SDLC pipelines.
• src/server/: Integrated MCP & Orchestrator API servers.

🌟 For Newcomers: What is Aizen-Gate?

If you are new to tech, think of Aizen-Gate as your own Personal Software Agency.

Instead of asking a single AI to "write some code" (which often leads to bugs and messy structure), Aizen-Gate brings in a specialized team:

• A Project Manager to figure out exactly what you need.
• An Architect to design the blueprint.
• A Developer to write the code in a specialized workshop.
• A QA Inspector to make sure everything works perfectly.

Aizen-Gate handles the "boring" parts of professional development—management, testing, and organization—so you can focus on your vision.

🧠 Elite Capabilities

1. 🌀 Automatic AI Lifecycle Management

Aizen is "set and forget." It manages its own energy and focus:

• Auto-Wake: Resumes your exact session state the moment you run a command.
• Auto-Pause: Freezes logic while you are manually testing to save your token budget.
• Idle-Shutdown: Safely persists your work and shuts down after 30 mins of inactivity.

2. 🧬 5-Tier Persistent Memory System

Aizen never forgets a decision. It uses a SQL-backed hierarchical brain:

• Working Memory: Immediate task context.
• Episodic Memory: Decision history.
• Semantic Memory: Technical patterns.
• Document Memory: Specs & Plans.
• Long Summary Thread (LST): Sharp rolling recap.

Powered by the consolidated ContextEngine (v2.1).

3. 🛠️ Dynamic Skill System

Aizen evolves with your project. It automatically scans your code to detect if you are using React, Python, Go, or Node.js and adjusts its "Intelligence" to match.

👥 Meet Your Squad (11 Expert Personas)

Aizen-Gate coordinates a specialized squad. You can address them directly using their [TAG]:

Tag	Agent	Role & Expertise
[PM]	Project Manager	Discovery, user stories, and acceptance criteria.
[ARCH]	Lead Architect	High-level design, model debate, and blueprints.
[DEV]	Implementation	Clean code, TDD, and isolated wave implementation.
[QA]	Quality Gate	Verification, security audits, and bug hunting.
[DES]	UI/UX Designer	Aesthetic excellence and layout responsiveness.
[DB]	Database Engineer	Schema normalization and query optimization.
[SEC]	Shield Architect	Security hardening and vulnerability prevention.
[AN]	Research Analyst	Competitive analysis and technical deep-dives.
[SM]	Scrum Master	Backlog management and sprint velocity.
[QF]	Quick Flow	Rapid atomic fixes and "Quick Mode" implementation.
[SA]	System Architect	Framework maintenance and archival logic.

🚀 The 7-Phase Dominance Pipeline

Aizen-Gate enforces a rigorous process to ensure zero-defect delivery:

• specify — The [PM] launches an interactive wizard to create a bullet-proof spec.md.
• discuss — Resolve gray areas before code is written.
• research — Parallel technical research via sub-agents into research.md.
• plan — Architectural debate to finalize the blueprint.
• tasks — Decomposition into Work Packages (WPs) with smart dependency mapping.
• auto — Autonomous wave execution. Spawns parallel, isolated worktrees per WP.
• review — [QA] code review with Athena quality gates before merging.

Orchestrated by the unified MissionEngine (v2.1).

🖥️ CLI Commands Reference

Core Workflow

npx aizen-gate specify    # Launch interactive discovery wizard
npx aizen-gate research   # Parallel technical research
npx aizen-gate plan       # Architectural planning & debate
npx aizen-gate tasks      # Generate Work Packages (WPs)
npx aizen-gate auto       # Trigger the autonomous implementation loop
npx aizen-gate review     # Perform QA review on finished work
npx aizen-gate merge      # Final branch merging and cleanup

Intelligence & Visibility

npx aizen-gate dashboard  # Launch the Live Pulse Dashboard (port 6420)
npx aizen-gate status     # View Scrum Board & Memory state
npx aizen-gate map        # Generate architectural codebase map
npx aizen-gate doctor     # Run workspace protocol health check
npx aizen-gate benchmark  # Performance/compliance audit
npx aizen-gate tokens     # View token usage & efficiency report and savings report

Quick Actions & Maintenance

npx aizen-gate quick      # Fast-track a small feature or bug fix
npx aizen-gate archive    # Distill session knowledge into long-term memory
npx aizen-gate pause      # Safely pause session (persists everything)
npx aizen-gate resume     # Resume your last session instantly
npx aizen-gate clean      # Archive finished tasks and optimize storage

📦 Universal Platform Support

Aizen-Gate detect and integrates into your favorite AI development tools:

• Claude Code (CLAUDE.md)
• Cursor (.cursorrules)
• Gemini CLI (GEMINI.md)
• Windsurf (.windsurf/rules/)
• GitHub Copilot (copilot-instructions.md)

📥 Installation

# 1. Install globally via NPM
npm install -g aizen-gate

# 2. Initialize the Shield in your workspace
aizen-gate install

# 3. Alternative: Run via NPX without global install
npx aizen-gate install

⛩️ [Aizen] Shield System Active. Ready to build the future.
"Every gap has been eliminated. Welcome to the elite tier of AI development."