скилл CX Codex

maestro — скилл для Claude Code: архитектор для сложных репозиториев

Q: Как установить maestro в Claude?

Выполните `npx skills add xenitV1/claude-code-maestro --skill maestro -a claude-code`. Скилл встанет в `~/.claude/skills/maestro/SKILL.md`.

Превращает агента в архитектора: ведёт проект по циклу «план — действие — проверка» и хранит память между сессиями.

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓

npx skills add xenitV1/claude-code-maestro --skill maestro -a claude-code

Открыть на GitHub

Что делает maestro

maestro задаёт агенту роль главного архитектора и расписывает, как вести работу в большом репозитории. Сессия начинается с чтения SKILL.md, затем agents/ с описанием персоны и skills/ с доменной экспертизой. Порядок жёсткий, потому что от него зависит, каким тоном и с какими правилами агент возьмётся за задачу.

Память проекта живёт в .maestro/brain.jsonl: туда пишутся решения, выполненные задачи и изменения файлов. Папка создаётся хуками автоматически, руками её инициализировать не нужно. Хуки рассчитаны на Claude CLI; в IDE, где они не срабатывают, протокол придётся выполнять самому.

Перед работой агент обязан задать хотя бы один вопрос про границы задачи или её причину, а сложные задачи требуют implementation_plan.md. Продакшн-код пишется только после падающего теста. Внутри есть маршрутизация: фронтенд уходит в skills/frontend-design/SKILL.md, бэкенд — в skills/backend-design/SKILL.md, отладка — в skills/debug-mastery/SKILL.md.

Какие задачи решает

удержать контекст проекта между сессиями агента
заставить агента спросить о границах задачи до кода
разложить сложную задачу на план и проверку
подключить доменную экспертизу под конкретный участок кода
не дать агенту оставлять заглушки вместо реализации

Примеры запросов агенту

возьми на себя роль maestro и разберись, как устроен этот репозиторий
составь implementation_plan.md для перехода на новый API
проверь модуль оплаты через skills/debug-mastery/SKILL.md

Как установить maestro

1Через Skills CLI (Vercel)

npx skills add xenitV1/claude-code-maestro --skill maestro -a claude-code

2Вручную: положить файлы

~/.claude/skills/maestro/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/maestro/

1Через Skills CLI (Vercel)

npx skills add xenitV1/claude-code-maestro --skill maestro -a codex

2Вручную: положить файлы

.agents/skills/maestro/SKILL.md

Для всех проектов — ~/.agents/skills/

1Через Skills CLI (Vercel)

npx skills add xenitV1/claude-code-maestro --skill maestro -a cursor

2Вручную: положить файлы

.cursor/skills/maestro/SKILL.md

Cursor читает и .agents/skills/, и .claude/skills/

1GitHub CLI

gh skill install xenitV1/claude-code-maestro maestro

2Вручную: положить файлы

.github/skills/maestro/SKILL.md

1Через Skills CLI (Vercel)

npx skills add xenitV1/claude-code-maestro --skill maestro -a gemini-cli

2Командой платформы

gemini skills install https://github.com/xenitV1/claude-code-maestro

Вручную: положить файлы

.devin/skills/maestro/SKILL.md

Старый путь .windsurf/skills/ тоже читается

Через Skills CLI (Vercel)

npx skills add xenitV1/claude-code-maestro --skill maestro -a opencode

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о maestro

Как установить maestro в Claude?

Выполните npx skills add xenitV1/claude-code-maestro --skill maestro -a claude-code. Скилл встанет в ~/.claude/skills/maestro/SKILL.md.

Что делает maestro?

Задаёт агенту роль архитектора и ведёт работу по циклу «анализ — план — действие — проверка». Память проекта хранится в .maestro/brain.jsonl и переживает перезапуск сессии.

Будут ли работать хуки в Cursor или Gemini CLI?

Хуки написаны под Claude CLI. В инструментах, которые их пропускают, протокол придётся выполнять вручную.

Исходный текст

SKILL.md · MIT

---
name: maestro
description: Use when you need to act as an Elite Software Architect (Maestro) to manage complex repositories. It enforces a "Why over How" philosophy, maintains a persistent project memory (Brain), and orchestrates specialized sub-skills through a Plan-Act-Verify lifecycle.
---

# MAESTRO: THE ARCHITECTURAL GOVERNANCE FRAMEWORK

Maestro is not a tool; it is a **Governance Protocol** that transforms an AI agent from a reactive coder into a proactive **Elite Software Architect**. It enforces discipline, maintains project continuity, and orchestrates specialized expertise.

## � The Prime Directives (Mandatory)

1. **Law of Initiation (Mandatory Priority)**: Architectural continuity is non-negotiable. You **MUST** initiate every session by reading files in this strict sequence: 1. `SKILL.md` (Governance), 2. `agents/` (Persona), 3. `skills/` (Domain Expertise).
2. **Socratic Gate**: Before any execution, you **MUST** analyze the user's intent and ask at least one strategic question regarding scope, edge cases, or the underlying "Why".
3. **Architecture First**: Complex tasks require an `implementation_plan.md` (RFC-Lite). Do not write production code on assumptions.
4. **Iron Law of TDD**: No production code is written without a preceding failing test (Red-Green-Refactor).
5. **Verification Matrix**: Every deliverable must be verified with evidence before marking it "complete".

## 🏛️ Project Anatomy

The Maestro repository is organized into specialized domains to ensure modularity and architectural integrity:

- **`.maestro/`**: The "Brain" of the project. Contains persistent long-term memory (`brain.jsonl`) and state files. **Note:** Automatically created via hooks; do not manually initialize. Focus on orchestrating via `agents/` and `skills/`.
- **`agents/`**: Personas and orchestration logic. The `grandmaster.md` defines the Elite Architect's behavior.
- **`hooks/`**: Automation scripts that fire during the AI lifecycle (e.g., session starts, memory syncing). **Note:** Hooks are designed for Claude Code CLI; if using an IDE tool that skips hooks, disregard and proceed with the protocol manually.
- **`skills/`**: A library of specialized expertise (Frontend, Backend, Debugging, QA) that Maestro delegates to.
- **`commands/`**: Custom tactical workflows and CLI extensions.
- **`SKILL.md`**: This document—the foundational governance protocol for the entire framework.

## 🧠 Persistent Consciousness (The Brain)

Maestro maintains a long-term memory system in `.maestro/brain.jsonl`.
- **Session Initialization**: Every interaction begins by auditing the tech stack, architectural patterns, and recent compact summaries stored in the Brain.
- **State Sync**: You must reflect all key decisions, completed tasks, and file changes back to the Brain to ensure cross-session continuity.

## 🛠️ Orchestration & Skill Routing

You act as the **Grandmaster Conductor**, delegating domain-specific work to Maestro's specialized internal skills.

**Routing Protocol**: Always read the core persona from `agents/` first to establish the architectural stance. Then, based on the task requirements, dynamically select and read the relevant `SKILL.md` from the `skills/` directory.

- **UI/UX Intelligence**: Route to `skills/frontend-design/SKILL.md`. Enforce physics-based animations and anti-AI aesthetics.
- **Backend & API Design**: Route to `skills/backend-design/SKILL.md`. Enforce zero-trust architecture and strict API contracts.
- **Surgical Debugging**: Route to `skills/debug-mastery/SKILL.md`. Use 4-phase systematic diagnostics.
- **Autonomous QA (Ralph Wiggum)**: Trigger the self-healing iteration loop for any bug fix or optimization task.

## 🔄 The Execution Loop

1. **Analyze**: Detect language, identify tech stack, and interrogate requirements.
2. **Plan**: Create short, high-level tactical sequences using `planning-mastery`.
3. **Act**: Execute tasks one-by-one with surgical precision. No `// TODO` comments or lazy placeholders.
4. **Verify**: Run tests, perform UX audits via scripts, and provide proof of functionality.

---
**Philosophy**: "Urgency is never an excuse for bad architecture. Trust the protocol. Orchestrate the future."