{"_id":"@alafourcadev/concerto","_rev":"2-8a62d042d50e93b5daa1951ac30d60c3","name":"@alafourcadev/concerto","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@alafourcadev/concerto","version":"1.0.0","_id":"@alafourcadev/concerto@1.0.0","maintainers":[{"name":"alafourcadedespaigne","email":"alafourcadedespaigne@gmail.com"}],"bin":{"concerto":"bin/concerto.mjs"},"dist":{"shasum":"ca91502630260b5736aa436adcfb707f0e394f2f","tarball":"https://registry.npmjs.org/@alafourcadev/concerto/-/concerto-1.0.0.tgz","fileCount":253,"integrity":"sha512-umW4PPGC/zVmLf9ukRnSqHlbyOSy/OpaMnWi2tobZg89uKtZN4lcb4TMxY64oJ8DfqBHmXmdgIC+YSlGNVtRtg==","signatures":[{"sig":"MEYCIQDnWAfk+67ldjJz7Ll1vbq7cAlKwS5ufpYTRkoNve0URAIhAKeW+8ey2J2t6hX0HyWI6mb7A3Q21so9bGHJnSMG/Rxe","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1746316},"type":"module","engines":{"node":">=22"},"gitHead":"1776deb323ad067350a8fb5ccea1148e9e120385","scripts":{"test":"npm run verify","verify":"npm run generate:adapters && npm run verify:repo && npm run verify:cli && npm --prefix web run typecheck","concerto":"node bin/concerto.mjs","verify:cli":"node scripts/verify-cli.mjs","release:tag":"node bin/concerto.mjs release tag --apply","verify:repo":"node scripts/verify.mjs","release:pack":"node bin/concerto.mjs release pack","release:check":"node bin/concerto.mjs release check --strict","upgrade:check":"node bin/concerto.mjs upgrade --dry-run --mode full --agent claude,opencode,gemini,codex","release:homebrew":"node bin/concerto.mjs release homebrew","generate:adapters":"node scripts/generate-adapters.mjs"},"_npmUser":{"name":"alafourcadedespaigne","email":"alafourcadedespaigne@gmail.com"},"_npmVersion":"11.13.0","description":"Orchestrated squad of 13 specialist agents for the full software lifecycle","directories":{},"_nodeVersion":"24.14.1","publishConfig":{"access":"public","provenance":true},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/concerto_1.0.0_1778151872101_0.28400930648433875","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@alafourcadev/concerto","version":"1.0.1","description":"Orchestrated squad of 13 specialist agents for the full software lifecycle","license":"MIT","type":"module","bin":{"concerto":"bin/concerto.mjs"},"engines":{"node":">=22"},"publishConfig":{"access":"public","provenance":true},"scripts":{"concerto":"node bin/concerto.mjs","release:check":"node bin/concerto.mjs release check --strict","release:pack":"node bin/concerto.mjs release pack","release:tag":"node bin/concerto.mjs release tag --apply","release:homebrew":"node bin/concerto.mjs release homebrew","upgrade:check":"node bin/concerto.mjs upgrade --dry-run --mode full --agent claude,opencode,gemini,codex","generate:adapters":"node scripts/generate-adapters.mjs","verify:repo":"node scripts/verify.mjs","verify:cli":"node scripts/verify-cli.mjs","verify":"npm run generate:adapters && npm run verify:repo && npm run verify:cli && npm --prefix web run typecheck","test":"npm run verify"},"gitHead":"819b54b1a8e505e5ed60c8d49d820022b65d290f","_id":"@alafourcadev/concerto@1.0.1","_nodeVersion":"24.14.1","_npmVersion":"11.13.0","dist":{"integrity":"sha512-9d5IM+ahFzpp/HMARtwOu0dCInTrP9AJA6kTBLFQ3PWS5+LGUVp+97hz86ywtmWy3eWCXioe3K3HSidZNexH9Q==","shasum":"3a06f202d9f9f81287d835f3406435a6d70d7f3e","tarball":"https://registry.npmjs.org/@alafourcadev/concerto/-/concerto-1.0.1.tgz","fileCount":253,"unpackedSize":1746608,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQD/iLfH3QyGtXQ0U2klGQpgrODrJqsWrOpa8C8E80CMEgIhAM2/Zpt+294CyiErJC2J5/GbtMRr/T0xB4PtKnGwxXVt"}]},"_npmUser":{"name":"alafourcadedespaigne","email":"alafourcadedespaigne@gmail.com"},"directories":{},"maintainers":[{"name":"alafourcadedespaigne","email":"alafourcadedespaigne@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/concerto_1.0.1_1778153628753_0.04025979383605249"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-07T11:04:31.967Z","modified":"2026-05-07T11:33:49.095Z","1.0.0":"2026-05-07T11:04:32.323Z","1.0.1":"2026-05-07T11:33:48.969Z"},"description":"Orchestrated squad of 13 specialist agents for the full software lifecycle","maintainers":[{"name":"alafourcadedespaigne","email":"alafourcadedespaigne@gmail.com"}],"readme":"# Concerto\n\n> Una orquesta de cracks dirigida por un Maestro. Skills como partituras,\n> hooks como metrónomo, memoria como diario de ensayos.\n\n**Status:** ✅ Complete — v1.0 multi-client\n\nConcerto is a multi-client agent squad for Claude Code, OpenCode, Gemini CLI,\nand Codex. It replaces ad-hoc skill invocation with an orchestrated squad of 13\nspecialists (cracks), each with distinct persona and deep-domain expertise,\nled by a Maestro that decides — per request — which cracks to call, which\ngates to apply, and how to parallelize work.\n\n## Philosophy\n\n- **Adaptive rigor** — default military, gates can be relaxed only with\n  audited justification. Security and data-loss are never relaxable.\n- **Evidence over opinion** — no crack closes a task without verifiable output.\n- **Learn over repeat** — errors go to memory, they don't happen twice.\n- **Stack-aware** — specific for backend, frontend, mobile, cloud-native,\n  data, and AI/ML.\n- **Silent when safe, loud when risky** — hooks stay quiet unless something\n  warrants attention.\n\n## The Squad\n\n### Pipeline (6) — the feature lifecycle, in order\n\n| Crack | Role |\n|---|---|\n| **Sofía** | Spec Lead — turns vague asks into executable specs before a line is written |\n| **Kai** | Planner — breaks specs into atomic, risk-ordered, shippable slices |\n| **Rex** | Builder — implements one slice at a time with unhurried, deliberate craft |\n| **Iris** | Tester — writes the failing test first, always; finds the edges TDD misses |\n| **Viktor** | QA/Reviewer — five-axis review with explicit severity, no rubber stamps |\n| **Ada** | SRE/CI-CD — ships safely, plans the rollback path before the rollout path |\n\n### Transversals (7) — invoked automatically when their domain is touched\n\n| Crack | Role |\n|---|---|\n| **Nyx** | Security — threat-models every trust boundary; non-skippable on auth/crypto/secrets |\n| **Atlas** | Performance — measures before optimizing; reads flame graphs like sheet music |\n| **Mira** | Frontend/UX — components that work without JS and degrade gracefully |\n| **Leo** | Mobile — the only one who knows App Store review rules, battery budgets, and deep links |\n| **Helix** | Cloud Native — Dockerfiles, K8s, Helm, Terraform, and cloud bills that don't surprise you |\n| **Vera** | Data/DBA/BI — reads query plans, runs safe migrations, builds honest dashboards |\n| **Lyra** | AI/ML/MLOps — treats prompts as software that must be evaluated, versioned, and monitored |\n\n## Status\n\n| Phase | Component | Status |\n|---|---|---|\n| 0 | Bootstrap (repo structure, LICENSE, CLAUDE.md) | ✅ |\n| 1 | Maestro core (persona, policy, triage, consolidation) | ✅ |\n| 1 | 6 pipeline cracks + 39 core skills | ✅ |\n| 2 | Critical transversal cracks (Nyx, Atlas, Mira) + 18 skills + hooks | ✅ |\n| 3 | Stack specialists (Leo, Helix, Vera, Lyra) + 32 skills | ✅ |\n| 4 | Live infra (memory dedupe, metrics aggregation, utility commands) | ✅ |\n| 5 | Polish + docs | ✅ |\n\n## Structure\n\n```\nconcerto/\n├── maestro/       Director: persona, policy, triage, consolidation\n├── cracks/        The 13 soloists\n├── agents/        Generated agent files for Claude Code and Gemini CLI\n├── skills/        93 partituras across lifecycle phases\n├── hooks/         Event-driven automation (10 scripts)\n├── commands/      Claude/OpenCode commands + generated Gemini TOML commands\n├── references/    Cross-framework checklists and stack-specific references\n├── .concerto/     Runtime: memory, metrics, config\n├── .claude-plugin/ Claude Code plugin and marketplace manifests\n├── .opencode/     OpenCode commands, agents, and config\n├── GEMINI.md      Gemini CLI extension context\n├── AGENTS.md      OpenCode/Codex-compatible project rules\n└── docs/          Getting started, personas, policy engine, flows\n```\n\n## Install\n\n### CLI control plane\n\nConcerto now ships a CLI control plane for product diagnostics, safe install\nflows, memory, backups, policy checks, and release readiness:\n\n```bash\nnpm run concerto\nnpm run concerto -- status\nnpm run concerto -- doctor\nnpm run concerto -- install --dry-run --mode inspect --agent claude,opencode,gemini,codex\nnpm run concerto -- install --mode project --agent claude,opencode\nnpm run concerto -- install --mode team --agent claude,opencode,gemini,codex\nnpm run concerto -- upgrade --dry-run --mode full --agent claude,opencode,gemini,codex\nnpm run concerto -- release check\nnpm run concerto -- release pack --dry-run\nnpm run concerto -- release homebrew\nnpm run concerto -- profile list\n```\n\nUse `install --mode user --agent claude,opencode,gemini,codex` for global\npersonal adapters, `install --mode project` for the current repository, and\n`install --mode full` for both in one tracked operation.\n\nSee [CLI](docs/cli.md) and [Technical Roadmap](docs/technical-roadmap.md).\n\n### Claude Code\n\n```bash\ngit clone https://github.com/alafourcadev/concerto\ncd concerto\nclaude\n/plugin marketplace add .\n/plugin install concerto@concerto\n```\n\nClaude loads `.claude-plugin/plugin.json`, `commands/*.md`, `agents/*.md`,\n`skills/`, and `hooks/hooks.json`.\n\n### OpenCode\n\nOpenCode does not currently use the Claude plugin marketplace. Use the CLI\nfile adapter:\n\n```bash\nnpm run concerto -- install --mode user --agent opencode\n```\n\nFor a local `concerto` executable:\n\n```bash\nscripts/install.sh\n```\n\nThen run OpenCode in any project and invoke `/concerto` or mention a crack with\n`@sofia`, `@rex`, `@nyx`, etc.\n\n### Gemini CLI\n\n```bash\ngit clone https://github.com/alafourcadev/concerto\nnpm run concerto -- install --mode user --agent gemini\n```\n\nFor extension development:\n\n```bash\ngemini extensions link ./concerto\n```\n\nGemini loads `gemini-extension.json`, `GEMINI.md`, `commands/*.toml`,\n`agents/*.md`, `skills/`, and `hooks/hooks.json`.\n\n## Usage\n\n### Full orchestration (Maestro decides)\n\n```\n/concerto <your request>\n```\n\nThe Maestro classifies the request, announces the plan, and orchestrates the squad.\n\n### Direct phase invocation (bypass Maestro triage)\n\n```\n/concerto:spec    → Sofía (Define)\n/concerto:plan    → Kai (Plan)\n/concerto:build   → Rex (Build)\n/concerto:test    → Iris (Verify)\n/concerto:review  → Viktor (Review)\n/concerto:ship    → Ada (Ship)\n```\n\n### Utility commands\n\n```\n/concerto:call <crack> <task>   → Invoke any crack directly by name\n/concerto:audit                 → Full repo audit by all 13 cracks (writes docs/audits only)\n/concerto:incident <description>→ Incident mode: Ada leads, Helix assists, Iris standby\n/concerto:status                → Weekly squad performance report\n/concerto:memory <read|write|search> [args]  → Interact with squad memory\n/concerto:relax <gate> <reason> → Explicit, user-authorized gate relaxation\n/concerto:learn                 → Extract a lesson from the last correction\n/concerto:warmup                → Load all context without acting (session prep)\n```\n\n## Documentation\n\n- [Getting Started](docs/getting-started.md) — install, first interaction, troubleshooting\n- [Multi-client compatibility](docs/multi-client.md) — Claude Code, OpenCode, Gemini CLI, and Codex adapters\n- [Crack Personas](docs/crack-personas.md) — 13 bios: taglines, superpowers, skills owned\n- [Policy Engine](docs/policy-engine.md) — phases, gates, relaxations, NEVER_SKIPPABLE\n- [Flows](docs/flows.md) — the 4 typical flows: feature, bug fix, hotfix, full audit\n- [Plan Summaries](PLAN_SUMMARIES.md) — the 30-second tour of how Concerto was built\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n\n## Credits\n\nSee [AGRADECIMIENTOS.md](AGRADECIMIENTOS.md) for the public-domain engineering\nideas this project stands on.\n","readmeFilename":"README.md","license":"MIT"}