Skip to content
Back to search

maestro-marketplace

MarketplaceWorks with Claude CodeGitHub

Maestro: AI Development Orchestrator

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/xenitv1--claude-code-maestro/badge.svg)](/listings/xenitv1--claude-code-maestro)

HTML

<a href="/listings/xenitv1--claude-code-maestro"><img src="/api/listings/xenitv1--claude-code-maestro/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Installation

**One-line Install (Skills.sh):**

npx skills add xenitV1/claude-code-maestro

**Manual Plugin Install:** Maestro is distributed as a Claude Code Plugin. To install it manually:

# 1. Add Maestro as a marketplace
/plugin marketplace add xenitV1/claude-code-maestro

# 2. Install the Maestro plugin
/plugin install maestro@xenitV1-claude-code-maestro

Prerequisites

- **Node.js 18+** (required for hooks) - Claude Code CLI

Usage

Since Maestro is a plugin, its commands are namespaced. Use the format `/maestro:command`.

# Basic orchestration
/maestro your task description

# With Ralph Wiggum (autonomous iterations)
/maestro fix bugs and improve code. ralph 5 iterations

# Design mode
/maestro design new authentication system

# Plan mode
/maestro plan implement user dashboard

# Use the Grandmaster agent directly
/agent:grandmaster

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 18 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "maestro-marketplace",
  3. "owner": {
  4. "name": "xenitV1",
  5. "url": "https://github.com/xenitV1"
  6. },
  7. "plugins": [
  8. {
  9. "name": "maestro",
  10. "description": "Elite AI Development Orchestrator for Claude Code",
  11. "source": {
  12. "source": "url",
  13. "url": "https://github.com/xenitV1/claude-code-maestro.git"
  14. },
  15. "version": "0.6.0"
  16. }
  17. ]
  18. }
README.md · README · 209 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Maestro: AI Development Orchestrator
  2. Elite-tier orchestration framework for Claude Code CLI. Supercharges AI development through specialized agents, modular skills, intelligent hooks, and persistent memory systems.
  3. > **Version:** 0.6.0
  4. > **Author:** [xenitV1](https://github.com/xenitV1) • [X/Twitter](https://x.com/xenit_v0)
  5. > **Philosophy:** "Why over How. Architecture precedes implementation."
  6. ## Quick Start
  7. ### Installation
  8. **One-line Install (Skills.sh):**
  9. ```bash
  10. npx skills add xenitV1/claude-code-maestro
  11. ```
  12. **Manual Plugin Install:**
  13. Maestro is distributed as a Claude Code Plugin. To install it manually:
  14. ```bash
  15. # 1. Add Maestro as a marketplace
  16. /plugin marketplace add xenitV1/claude-code-maestro
  17. # 2. Install the Maestro plugin
  18. /plugin install maestro@xenitV1-claude-code-maestro
  19. ```
  20. ### Prerequisites
  21. - **Node.js 18+** (required for hooks)
  22. - Claude Code CLI
  23. ### Usage
  24. Since Maestro is a plugin, its commands are namespaced. Use the format `/maestro:command`.
  25. ```bash
  26. # Basic orchestration
  27. /maestro your task description
  28. # With Ralph Wiggum (autonomous iterations)
  29. /maestro fix bugs and improve code. ralph 5 iterations
  30. # Design mode
  31. /maestro design new authentication system
  32. # Plan mode
  33. /maestro plan implement user dashboard
  34. # Use the Grandmaster agent directly
  35. /agent:grandmaster
  36. ```
  37. ## Architecture
  38. ```
  39. ┌─────────────────────────────────────────────────────────────────────┐
  40. │ MAESTRO SYSTEM │
  41. ├─────────────────────────────────────────────────────────────────────┤
  42. │ ┌──────────┐ ┌──────────────┐ ┌─────────────────────────┐ │
  43. │ │ /maestro │───▶│ grandmaster │───▶│ SKILLS │ │
  44. │ │ command │ │ agent │ │ (frontend, backend, │ │
  45. │ └──────────┘ └──────────────┘ │ tdd, debug, etc.) │ │
  46. │ │ └─────────────────────────┘ │
  47. │ ▼ │
  48. │ ┌─────────────────────────────────────────────────────────────┐ │
  49. │ │ HOOK SYSTEM │ │
  50. │ │ SessionStart │ PostToolUse │ Stop │ PreCompact │ etc. │ │
  51. │ └─────────────────────────────────────────────────────────────┘ │
  52. │ │ │
  53. │ ▼ │
  54. │ ┌──────────────────────────────────────────────────────────────┐ │
  55. │ │ LONG-TERM MEMORY (LTM) │ │
  56. │ │ (brain.jsonl) │ │
  57. │ └──────────────────────────────────────────────────────────────┘ │
  58. └─────────────────────────────────────────────────────────────────────┘
  59. ```
  60. ## Project Structure
  61. ```
  62. maestro/
  63. ├── .claude-plugin/
  64. │ └── plugin.json # Plugin manifest
  65. ├── agents/
  66. │ └── grandmaster.md # Central orchestrator agent
  67. ├── commands/
  68. │ └── maestro.md # /maestro slash command
  69. ├── hooks/
  70. │ ├── hooks.json # Hook configuration
  71. │ ├── lib/ # Shared JS utilities
  72. │ │ ├── utils.js # Cross-platform utilities
  73. │ │ ├── brain.js # LTM operations
  74. │ │ └── ralph.js # Ralph state management
  75. │ ├── session-start.js # Tech stack detection + LTM injection
  76. │ ├── brain-sync.js # LTM sync (PostToolUse)
  77. │ ├── stop.js # Ralph Wiggum iteration
  78. │ ├── ralph.js # QA enforcement
  79. │ ├── sentinel.js # Change detection
  80. │ └── pre-maestro.js # Skill recommendation
  81. ├── skills/
  82. │ ├── clean-code/ # Code quality standards
  83. │ ├── frontend-design/ # Elite UI/UX
  84. │ ├── backend-design/ # API & Database patterns
  85. │ ├── tdd-mastery/ # Test-Driven Development
  86. │ ├── debug-mastery/ # Systematic debugging
  87. │ ├── verification-mastery/# Evidence-based completion
  88. │ ├── brainstorming/ # Design-first methodology
  89. │ ├── planning-mastery/ # Implementation planning
  90. │ ├── git-worktrees/ # Isolated workspaces
  91. │ ├── ralph-wiggum/ # Autonomous QA system
  92. │ ├── browser-extension/ # Extension development
  93. │ └── optimization-mastery/# Performance optimization
  94. ├── package.json # Node.js metadata
  95. ├── LICENSE # MIT License
  96. └── README.md
  97. ```
  98. ## Memory Systems
  99. ### Long-Term Memory (brain.jsonl)
  100. Persistent project context across sessions:
  101. - **Tech Stack:** Frameworks, dependencies, architecture patterns
  102. - **Decisions:** Key architectural decisions made
  103. - **Goals:** Project objectives
  104. - **Errors:** Known issues and blockers
  105. - **Compact History:** Session summaries after context compaction
  106. - **File Changes:** Changelog of edits and creates
  107. ## Ralph Wiggum: Autonomous QA
  108. Elite QA system with Four Pillars:
  109. | Pillar | Purpose |
  110. |--------|---------|
  111. | **Proactive Gate** | Edge case identification BEFORE coding |
  112. | **Reflection Loop** | Self-critique and refinement |
  113. | **Verification Matrix** | Test coverage tracking (80% minimum) |
  114. | **Circuit Breaker** | Stagnation detection and pivot strategies |
  115. Activate with: `ralph N iterations` or "Ralph Wiggum mode"
  116. ## Skills Overview
  117. | Skill | Description |
  118. |-------|-------------|
  119. | `clean-code` | 2025 standards, SOLID, security-first |
  120. | `frontend-design` | Atomic Design 2.0, Lovable/v0 standard |
  121. | `backend-design` | Zero-trust, API contracts |
  122. | `tdd-mastery` | Iron Law: Test before code |
  123. | `debug-mastery` | 4-phase systematic debugging |
  124. | `verification-mastery` | Evidence before completion |
  125. | `brainstorming` | Design-first methodology |
  126. | `planning-mastery` | Bite-sized task breakdown |
  127. | `git-worktrees` | Isolated feature development |
  128. | `ralph-wiggum` | Autonomous QA orchestration |
  129. | `optimization-mastery` | Performance, INP, partial hydration |
  130. | `context7` | Auto library documentation from Upstash |
  131. | `browser-extension` | Manifest v3, service workers |
  132. ## Platform Compatibility
  133. | Platform | Rating | Notes |
  134. |----------|--------|-------|
  135. | **Claude Code CLI** | ⭐⭐⭐⭐⭐ | Native environment, full functionality |
  136. | **Windows** | ⭐⭐⭐⭐⭐ | Full cross-platform support |
  137. | **macOS** | ⭐⭐⭐⭐⭐ | Full cross-platform support |
  138. | **Linux** | ⭐⭐⭐⭐⭐ | Full cross-platform support |
  139. ## Core Protocols
  140. 1. **Socratic Gate:** Ask clarifying questions before assuming
  141. 2. **Think First:** `<think>` before complex actions
  142. 3. **TDD Iron Law:** No production code without failing test
  143. 4. **Verification:** Evidence before completion claims
  144. 5. **Clean Code:** No TODO/FIXME, no lazy placeholders
  145. ## Acknowledgments
  146. Several skills were inspired by and adapted from [obra/superpowers](https://github.com/obra/superpowers) and have been heavily optimized for the Maestro orchestration environment:
  147. | Feature | Source | Maestro Skill |
  148. |---------|--------|---------------|
  149. | TDD Iron Law | superpowers/tdd | `tdd-mastery` |
  150. | Systematic Debugging | superpowers/debugging | `debug-mastery` |
  151. | Verification Protocol | superpowers/verification | `verification-mastery` |
  152. | Brainstorming Method | superpowers/brainstorming | `brainstorming` |
  153. | Implementation Planning | superpowers/planning | `planning-mastery` |
  154. | Git Worktrees | superpowers/worktrees | `git-worktrees` |
  155. ## Star History
  156. [![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)
  157. ## Author
  158. Created and maintained by **[xenitV1](https://github.com/xenitV1)**
  159. - GitHub: [github.com/xenitV1](https://github.com/xenitV1)
  160. - X/Twitter: [x.com/xenit_v0](https://x.com/xenit_v0)
  161. ## License
  162. MIT License - See [LICENSE](LICENSE) for details.
  163. ---
  164. *Orchestrating the future of autonomous development.*

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.