{
  "markdown": "# Maestro: AI Development Orchestrator\n\nElite-tier orchestration framework for Claude Code CLI. Supercharges AI development through specialized agents, modular skills, intelligent hooks, and persistent memory systems.\n\n> **Version:** 0.6.0  \n> **Author:** [xenitV1](https://github.com/xenitV1) • [X/Twitter](https://x.com/xenit_v0)  \n> **Philosophy:** \"Why over How. Architecture precedes implementation.\"\n\n## Quick Start\n\n### Installation\n\n**One-line Install (Skills.sh):**\n```bash\nnpx skills add xenitV1/claude-code-maestro\n```\n\n**Manual Plugin Install:**\nMaestro is distributed as a Claude Code Plugin. To install it manually:\n\n```bash\n# 1. Add Maestro as a marketplace\n/plugin marketplace add xenitV1/claude-code-maestro\n\n# 2. Install the Maestro plugin\n/plugin install maestro@xenitV1-claude-code-maestro\n```\n\n### Prerequisites\n\n- **Node.js 18+** (required for hooks)\n- Claude Code CLI\n\n### Usage\n\nSince Maestro is a plugin, its commands are namespaced. Use the format `/maestro:command`.\n\n```bash\n# Basic orchestration\n/maestro your task description\n\n# With Ralph Wiggum (autonomous iterations)\n/maestro fix bugs and improve code. ralph 5 iterations\n\n# Design mode\n/maestro design new authentication system\n\n# Plan mode\n/maestro plan implement user dashboard\n\n# Use the Grandmaster agent directly\n/agent:grandmaster\n```\n\n## Architecture\n\n```\n┌─────────────────────────────────────────────────────────────────────┐\n│                         MAESTRO SYSTEM                               │\n├─────────────────────────────────────────────────────────────────────┤\n│  ┌──────────┐    ┌──────────────┐    ┌─────────────────────────┐   │\n│  │ /maestro │───▶│ grandmaster  │───▶│       SKILLS            │   │\n│  │ command  │    │    agent     │    │ (frontend, backend,     │   │\n│  └──────────┘    └──────────────┘    │  tdd, debug, etc.)      │   │\n│                         │            └─────────────────────────┘   │\n│                         ▼                                           │\n│  ┌─────────────────────────────────────────────────────────────┐   │\n│  │                    HOOK SYSTEM                               │   │\n│  │  SessionStart │ PostToolUse │ Stop │ PreCompact │ etc.      │   │\n│  └─────────────────────────────────────────────────────────────┘   │\n│                         │                                           │\n│                         ▼                                           │\n│  ┌──────────────────────────────────────────────────────────────┐   │\n│  │                    LONG-TERM MEMORY (LTM)                      │   │\n│  │                      (brain.jsonl)                            │   │\n│  └──────────────────────────────────────────────────────────────┘   │\n└─────────────────────────────────────────────────────────────────────┘\n```\n\n## Project Structure\n\n```\nmaestro/\n├── .claude-plugin/\n│   └── plugin.json          # Plugin manifest\n├── agents/\n│   └── grandmaster.md       # Central orchestrator agent\n├── commands/\n│   └── maestro.md           # /maestro slash command\n├── hooks/\n│   ├── hooks.json           # Hook configuration\n│   ├── lib/                 # Shared JS utilities\n│   │   ├── utils.js         # Cross-platform utilities\n│   │   ├── brain.js         # LTM operations\n│   │   └── ralph.js         # Ralph state management\n│   ├── session-start.js     # Tech stack detection + LTM injection\n│   ├── brain-sync.js        # LTM sync (PostToolUse)\n│   ├── stop.js              # Ralph Wiggum iteration\n│   ├── ralph.js             # QA enforcement\n│   ├── sentinel.js          # Change detection\n│   └── pre-maestro.js       # Skill recommendation\n├── skills/\n│   ├── clean-code/          # Code quality standards\n│   ├── frontend-design/     # Elite UI/UX\n│   ├── backend-design/      # API & Database patterns\n│   ├── tdd-mastery/         # Test-Driven Development\n│   ├── debug-mastery/       # Systematic debugging\n│   ├── verification-mastery/# Evidence-based completion\n│   ├── brainstorming/       # Design-first methodology\n│   ├── planning-mastery/    # Implementation planning\n│   ├── git-worktrees/       # Isolated workspaces\n│   ├── ralph-wiggum/        # Autonomous QA system\n│   ├── browser-extension/   # Extension development\n│   └── optimization-mastery/# Performance optimization\n├── package.json             # Node.js metadata\n├── LICENSE                  # MIT License\n└── README.md\n```\n\n## Memory Systems\n\n### Long-Term Memory (brain.jsonl)\nPersistent project context across sessions:\n- **Tech Stack:** Frameworks, dependencies, architecture patterns\n- **Decisions:** Key architectural decisions made\n- **Goals:** Project objectives\n- **Errors:** Known issues and blockers\n- **Compact History:** Session summaries after context compaction\n- **File Changes:** Changelog of edits and creates\n\n## Ralph Wiggum: Autonomous QA\n\nElite QA system with Four Pillars:\n\n| Pillar | Purpose |\n|--------|---------|\n| **Proactive Gate** | Edge case identification BEFORE coding |\n| **Reflection Loop** | Self-critique and refinement |\n| **Verification Matrix** | Test coverage tracking (80% minimum) |\n| **Circuit Breaker** | Stagnation detection and pivot strategies |\n\nActivate with: `ralph N iterations` or \"Ralph Wiggum mode\"\n\n## Skills Overview\n\n| Skill | Description |\n|-------|-------------|\n| `clean-code` | 2025 standards, SOLID, security-first |\n| `frontend-design` | Atomic Design 2.0, Lovable/v0 standard |\n| `backend-design` | Zero-trust, API contracts |\n| `tdd-mastery` | Iron Law: Test before code |\n| `debug-mastery` | 4-phase systematic debugging |\n| `verification-mastery` | Evidence before completion |\n| `brainstorming` | Design-first methodology |\n| `planning-mastery` | Bite-sized task breakdown |\n| `git-worktrees` | Isolated feature development |\n| `ralph-wiggum` | Autonomous QA orchestration |\n| `optimization-mastery` | Performance, INP, partial hydration |\n| `context7` | Auto library documentation from Upstash |\n| `browser-extension` | Manifest v3, service workers |\n\n## Platform Compatibility\n\n| Platform | Rating | Notes |\n|----------|--------|-------|\n| **Claude Code CLI** | ⭐⭐⭐⭐⭐ | Native environment, full functionality |\n| **Windows** | ⭐⭐⭐⭐⭐ | Full cross-platform support |\n| **macOS** | ⭐⭐⭐⭐⭐ | Full cross-platform support |\n| **Linux** | ⭐⭐⭐⭐⭐ | Full cross-platform support |\n\n## Core Protocols\n\n1. **Socratic Gate:** Ask clarifying questions before assuming\n2. **Think First:** `<think>` before complex actions\n3. **TDD Iron Law:** No production code without failing test\n4. **Verification:** Evidence before completion claims\n5. **Clean Code:** No TODO/FIXME, no lazy placeholders\n\n## Acknowledgments\n\nSeveral skills were inspired by and adapted from [obra/superpowers](https://github.com/obra/superpowers) and have been heavily optimized for the Maestro orchestration environment:\n\n| Feature | Source | Maestro Skill |\n|---------|--------|---------------|\n| TDD Iron Law | superpowers/tdd | `tdd-mastery` |\n| Systematic Debugging | superpowers/debugging | `debug-mastery` |\n| Verification Protocol | superpowers/verification | `verification-mastery` |\n| Brainstorming Method | superpowers/brainstorming | `brainstorming` |\n| Implementation Planning | superpowers/planning | `planning-mastery` |\n| Git Worktrees | superpowers/worktrees | `git-worktrees` |\n\n## Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=xenitV1/claude-code-maestro&type=Date)](https://star-history.com/#xenitV1/claude-code-maestro&Date)\n\n## Author\n\nCreated and maintained by **[xenitV1](https://github.com/xenitV1)**\n\n- GitHub: [github.com/xenitV1](https://github.com/xenitV1)\n- X/Twitter: [x.com/xenit_v0](https://x.com/xenit_v0)\n\n## License\n\nMIT License - See [LICENSE](LICENSE) for details.\n\n---\n\n*Orchestrating the future of autonomous development.*\n",
  "bytes": 7773,
  "sha": "edf80bb242c550c026cf15aab53096f3d5ddc3649af4285bf806cffcfdd8735f",
  "repo_slug": "xenitv1/claude-code-maestro",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_xenitv1_claude_code_maestro_skills_app_b_d6d52b6a/readme"
}