Maestro

Gerenciador dinâmico de bundles de skills para assistentes de programação com IA.

English

O Maestro ajuda agentes a carregar as instruções certas para a tarefa atual. Em vez de manter regras de todas as linguagens, frameworks e fluxos de trabalho no prompt ativo, o Maestro roteia a solicitação para um bundle focado de skills e reduz o contexto usado pelo agente.

Versão

Versão atual do projeto: 1.0.3

O Que o Maestro Faz

• Instala skills de comandos slash para Cursor, Claude, Antigravity/Gemini e Codex/Agents.
• Salva um caminho ativo de skill-bundle-folder para o Maestro.
• Escaneia pastas de bundles e cria um índice compacto de Known Bundles.
• Roteia solicitações /maestro para o bundle e os arquivos de skill mais relevantes.
• Fornece comandos de manutenção para trocar a pasta ativa, atualizar o índice e verificar a configuração atual.

Instalação

Execute o instalador com npm:

npx @alissonpokry/maestro init

O instalador pergunta:

• Ação: instalação ou desinstalação.
• Escopo: projeto local ou pasta global do usuário.
• Ambiente de IA: Cursor, Claude, Antigravity/Gemini, Codex/Agents ou todos os ambientes suportados.

Para testes locais a partir deste repositório:

node bin/cli.js init

Para remover uma instalação:

npx @alissonpokry/maestro uninstall

Estrutura dos Bundles de Skills

O Maestro espera uma pasta cujos filhos diretos sejam bundles. Cada bundle pode conter uma ou mais skills, e cada skill é representada por um arquivo SKILL.md.

My-Skill-Bundles/
|
+-- Angular-pro/
|   +-- angular-architecture/
|   |   +-- SKILL.md
|   +-- angular-ui-patterns/
|       +-- SKILL.md
|
+-- Python-pro/
|   +-- python-testing/
|       +-- SKILL.md
|
+-- Seo-pro/
    +-- seo-audit/
        +-- SKILL.md

Na terminologia do Maestro:

• skill-bundle-folder é a pasta que contém todos os bundles.
• bundle é uma pasta filha direta, como Angular-pro.
• skill é um arquivo SKILL.md específico dentro de um bundle.

Início Rápido

1. Instale o Maestro:

npx @alissonpokry/maestro init

2. Defina sua pasta de bundles no caminho de sua preferência:

/maestro-set C:\Users\user\Desktop\My-Skill-Bundles

3. Execute uma tarefa pelo Maestro:

/maestro Build a login page in Angular.

O Maestro analisa a solicitação, seleciona o bundle mais relevante, lê apenas as instruções das skills correspondentes e continua a tarefa com esse contexto focado.

Comandos

| Comando | Finalidade | | --- | --- | | /maestro <task> | Roteia uma tarefa pelo bundle mais relevante. | | /maestro-set <folder-path> | Salva ou troca o skill-bundle-folder ativo. | | /maestro-fetch [folder-path] | Atualiza o índice de Known Bundles. | | /maestro-stats | Mostra a pasta ativa de bundles e os bundles indexados. |

Se seu agente expuser apenas /maestro, use estes aliases:

| Alias | Comando equivalente | | --- | --- | | /maestro switch <folder-path> | /maestro-set <folder-path> | | /maestro fetch [folder-path] | /maestro-fetch [folder-path] | | /maestro stats | /maestro-stats |

Ambientes Suportados

O Maestro pode instalar arquivos de comando e skill para:

• Cursor
• Claude
• Antigravity/Gemini
• Codex/Agents

Instalações locais colocam os arquivos do Maestro no projeto atual. Instalações globais colocam os arquivos nas pastas de usuário correspondentes de cada assistente.

Desenvolvimento no Repositório

Este pacote não tem dependências de runtime. O ponto de entrada da CLI é:

bin/cli.js

Comandos úteis para desenvolvimento local:

node bin/cli.js init
node bin/cli.js uninstall
node --check bin/cli.js

Licença

MIT