Concerto

Una orquesta de cracks dirigida por un Maestro. Skills como partituras, hooks como metrónomo, memoria como diario de ensayos.

Status: ✅ Complete — v1.0 multi-client

Concerto is a multi-client agent squad for Claude Code, OpenCode, Gemini CLI, and Codex. It replaces ad-hoc skill invocation with an orchestrated squad of 13 specialists (cracks), each with distinct persona and deep-domain expertise, led by a Maestro that decides — per request — which cracks to call, which gates to apply, and how to parallelize work.

Philosophy

• Adaptive rigor — default military, gates can be relaxed only with audited justification. Security and data-loss are never relaxable.
• Evidence over opinion — no crack closes a task without verifiable output.
• Learn over repeat — errors go to memory, they don't happen twice.
• Stack-aware — specific for backend, frontend, mobile, cloud-native, data, and AI/ML.
• Silent when safe, loud when risky — hooks stay quiet unless something warrants attention.

The Squad

Pipeline (6) — the feature lifecycle, in order

| Crack | Role | |---|---| | Sofía | Spec Lead — turns vague asks into executable specs before a line is written | | Kai | Planner — breaks specs into atomic, risk-ordered, shippable slices | | Rex | Builder — implements one slice at a time with unhurried, deliberate craft | | Iris | Tester — writes the failing test first, always; finds the edges TDD misses | | Viktor | QA/Reviewer — five-axis review with explicit severity, no rubber stamps | | Ada | SRE/CI-CD — ships safely, plans the rollback path before the rollout path |

Transversals (7) — invoked automatically when their domain is touched

| Crack | Role | |---|---| | Nyx | Security — threat-models every trust boundary; non-skippable on auth/crypto/secrets | | Atlas | Performance — measures before optimizing; reads flame graphs like sheet music | | Mira | Frontend/UX — components that work without JS and degrade gracefully | | Leo | Mobile — the only one who knows App Store review rules, battery budgets, and deep links | | Helix | Cloud Native — Dockerfiles, K8s, Helm, Terraform, and cloud bills that don't surprise you | | Vera | Data/DBA/BI — reads query plans, runs safe migrations, builds honest dashboards | | Lyra | AI/ML/MLOps — treats prompts as software that must be evaluated, versioned, and monitored |

Status

| Phase | Component | Status | |---|---|---| | 0 | Bootstrap (repo structure, LICENSE, CLAUDE.md) | ✅ | | 1 | Maestro core (persona, policy, triage, consolidation) | ✅ | | 1 | 6 pipeline cracks + 39 core skills | ✅ | | 2 | Critical transversal cracks (Nyx, Atlas, Mira) + 18 skills + hooks | ✅ | | 3 | Stack specialists (Leo, Helix, Vera, Lyra) + 32 skills | ✅ | | 4 | Live infra (memory dedupe, metrics aggregation, utility commands) | ✅ | | 5 | Polish + docs | ✅ |

Structure

concerto/
├── maestro/       Director: persona, policy, triage, consolidation
├── cracks/        The 13 soloists
├── agents/        Generated agent files for Claude Code and Gemini CLI
├── skills/        93 partituras across lifecycle phases
├── hooks/         Event-driven automation (10 scripts)
├── commands/      Claude/OpenCode commands + generated Gemini TOML commands
├── references/    Cross-framework checklists and stack-specific references
├── .concerto/     Runtime: memory, metrics, config
├── .claude-plugin/ Claude Code plugin and marketplace manifests
├── .opencode/     OpenCode commands, agents, and config
├── GEMINI.md      Gemini CLI extension context
├── AGENTS.md      OpenCode/Codex-compatible project rules
└── docs/          Getting started, personas, policy engine, flows

Install

CLI control plane

Concerto now ships a CLI control plane for product diagnostics, safe install flows, memory, backups, policy checks, and release readiness:

npm run concerto
npm run concerto -- status
npm run concerto -- doctor
npm run concerto -- install --dry-run --mode inspect --agent claude,opencode,gemini,codex
npm run concerto -- install --mode project --agent claude,opencode
npm run concerto -- install --mode team --agent claude,opencode,gemini,codex
npm run concerto -- upgrade --dry-run --mode full --agent claude,opencode,gemini,codex
npm run concerto -- release check
npm run concerto -- release pack --dry-run
npm run concerto -- release homebrew
npm run concerto -- profile list

Use install --mode user --agent claude,opencode,gemini,codex for global personal adapters, install --mode project for the current repository, and install --mode full for both in one tracked operation.

See CLI and Technical Roadmap.

Claude Code

git clone https://github.com/alafourcadev/concerto
cd concerto
claude
/plugin marketplace add .
/plugin install concerto@concerto

Claude loads .claude-plugin/plugin.json, commands/*.md, agents/*.md, skills/, and hooks/hooks.json.

OpenCode

OpenCode does not currently use the Claude plugin marketplace. Use the CLI file adapter:

npm run concerto -- install --mode user --agent opencode

For a local concerto executable:

scripts/install.sh

Then run OpenCode in any project and invoke /concerto or mention a crack with @sofia, @rex, @nyx, etc.

Gemini CLI

git clone https://github.com/alafourcadev/concerto
npm run concerto -- install --mode user --agent gemini

For extension development:

gemini extensions link ./concerto

Gemini loads gemini-extension.json, GEMINI.md, commands/*.toml, agents/*.md, skills/, and hooks/hooks.json.

Usage

Full orchestration (Maestro decides)

/concerto <your request>

The Maestro classifies the request, announces the plan, and orchestrates the squad.

Direct phase invocation (bypass Maestro triage)

/concerto:spec    → Sofía (Define)
/concerto:plan    → Kai (Plan)
/concerto:build   → Rex (Build)
/concerto:test    → Iris (Verify)
/concerto:review  → Viktor (Review)
/concerto:ship    → Ada (Ship)

Utility commands

/concerto:call <crack> <task>   → Invoke any crack directly by name
/concerto:audit                 → Full repo audit by all 13 cracks (writes docs/audits only)
/concerto:incident <description>→ Incident mode: Ada leads, Helix assists, Iris standby
/concerto:status                → Weekly squad performance report
/concerto:memory <read|write|search> [args]  → Interact with squad memory
/concerto:relax <gate> <reason> → Explicit, user-authorized gate relaxation
/concerto:learn                 → Extract a lesson from the last correction
/concerto:warmup                → Load all context without acting (session prep)

Documentation

• Getting Started — install, first interaction, troubleshooting
• Multi-client compatibility — Claude Code, OpenCode, Gemini CLI, and Codex adapters
• Crack Personas — 13 bios: taglines, superpowers, skills owned
• Policy Engine — phases, gates, relaxations, NEVER_SKIPPABLE
• Flows — the 4 typical flows: feature, bug fix, hotfix, full audit
• Plan Summaries — the 30-second tour of how Concerto was built

License

MIT — see LICENSE.

Credits

See AGRADECIMIENTOS.md for the public-domain engineering ideas this project stands on.