maestrolisted

# Maestro Orchestrate local Cursor skills. Maestro does **not** implement work itself — it discovers skills, plans a dependency graph, waits for user edits/approval, then spawns subagents. ## Hard rules 1. **Never spawn subagents before the user confirms the graph.** 2. **Max 10 graph nodes.** Fuse redundant skills that share the same role into one node. 3. **Pass explicit `SKILL.md` paths** to every subagent prompt. 4. **Do not invoke `$maestro` recursively** from subagents. 5. Routers like `index`, `data-visualization`, `grill-me`, `conselho` stay directly invocable — maestro may include them as hub nodes. 6. **Repos versionados:** aplicar o fluxo GitHub generico (Issues + PR + CI). Ver secao [GitHub workflow](#github-workflow) e `docs/github-workflow.md` neste repositorio. 7. **Discover seguro:** nunca executar `npx skills add` automaticamente; sem flag `-y`; install somente por acao humana apos revisar o repo. ## Artifacts | File | Purpose | |------|---------| | `~/.maestro/skills-manifest.json` | Searchable catalog (regenerate with `manifest`) | | `~/.maestro/maestro-exclude.txt` | Skills banned from search | | `~/.maestro/skill-runbooks.user.json` | User runbook overrides | | `~/.maestro/discover-allowlist.txt` | Optional trusted repos for Discover (install still manual) | | `skill-runbooks.json` | Bundled runbooks (preflight CLI hints) | | `scripts/build_manifest.py` | Regenerate manifest | | `scripts/search_skills.py` | Hybrid BM25 search + routing + runbooks | |