Repo del giorno: Compound Engineering, il plugin che chiude il ciclo tra piano, codice e apprendimento

💡 Cos'è Compound Engineering: ingegneria che si accumula, non si degrada

La filosofia è dichiarata fin dal README: ogni unità di lavoro ingegneristico dovrebbe rendere le unità successive più facili, non più difficili. Lo sviluppo tradizionale fa l'opposto: ogni feature aggiunge complessità, ogni bug fix lascia dietro di sé conoscenza locale che qualcun altro dovrà riscoprire da zero. Compound Engineering ribalta la proporzione — l'80% del tempo va in pianificazione e review, il 20% in esecuzione — e aggiunge un passaggio che nella maggior parte dei workflow manca: ogni ciclo si chiude scrivendo una nota di apprendimento che il ciclo successivo rilegge come base, invece di ripartire da zero.

Il progetto è mantenuto da Kieran Klaassen e Tyler Chow di Every, lo studio dietro l'app di email Cora, ed è esplicitamente «opinionated»: la direzione riflette un punto di vista preciso su come dovrebbe funzionare l'ingegneria con gli agenti, e non tutti i contributi esterni vengono accettati. Il plugin `compound-engineering` spedisce 37 skill e 51 agenti, con licenza MIT, ed è pensato per funzionare sullo stesso identico manifesto su nove strumenti diversi: Claude Code, Cursor, Codex, GitHub Copilot CLI, Factory Droid, Qwen Code, OpenCode, Pi e Gemini CLI.

repo       EveryInc/compound-engineering-plugin
stelle     ~23.300 · licenza MIT · autori Kieran Klaassen & Tyler Chow (Every)
cosa       37 skill + 51 agenti installabili come plugin
flusso     strategia → brainstorm → piano → lavoro → review → apprendimento
harness    Claude Code · Cursor · Codex · Copilot CLI · Factory Droid · Qwen · altri
extra      STRATEGY.md persistente + report periodici in docs/pulse-reports/

🧭 Il ciclo: strategia, brainstorm, piano, lavoro, review, apprendimento

Il ciclo core è composto da skill che si passano il testimone. `/ce-strategy` crea e mantiene `STRATEGY.md`, un'ancora durevole con problema target, approccio, persona e metriche del prodotto: le skill a valle la leggono come base. `/ce-ideate` è un preludio opzionale per quando non si sa ancora cosa costruire — genera e critica idee più grandi prima di scegliere quella da portare in brainstorm. `/ce-brainstorm` fa domande interattive per trasformare un'idea grezza in un documento di requisiti dimensionato bene, che `/ce-plan` traduce in un piano di implementazione dettagliato. `/ce-work` esegue il piano con worktree isolati e tracciamento dei task; `/ce-debug` interviene per riprodurre sistematicamente un bug e risalire alla causa radice.

Chiudono il cerchio due skill: `/ce-code-review`, una review multi-agente prima del merge, e `/ce-compound`, che documenta cosa si è imparato per rendere più facile il lavoro futuro. C'è poi un pezzo che raramente si vede altrove: `/ce-product-pulse`, un report a finestra temporale (24h, 7 giorni...) su come si è comportato il prodotto in produzione — errori, performance, uso reale — salvato in `docs/pulse-reports/`. I pulse report passati diventano una timeline consultabile, e il prossimo aggiornamento di strategia o brainstorm parte da segnali reali, non solo da intuizioni.

⚙️ Come si installa: nove harness, un solo repo sorgente

Su Claude Code l'installazione sta in due righe: si registra il marketplace del repo e si installa il plugin `compound-engineering`. Su Cursor basta `/add-plugin compound-engineering` dalla chat dell'agente. Su Codex servono tre passaggi invece di uno: registrare il marketplace, installare gli agenti Compound Engineering con un comando Bun (perché lo spec dei plugin di Codex non supporta ancora agenti custom), e infine attivare il plugin dal TUI `/plugins` dentro Codex. Copilot CLI, Factory Droid e Qwen Code leggono direttamente lo stesso manifesto compatibile con Claude Code e convertono il formato in automatico — nessun passaggio Bun necessario.

Per OpenCode, Pi, Gemini CLI e Kiro il repo include un installer Bun/TypeScript che converte il plugin nel formato di ciascun target; sono quindi «converter-backed» e possono cambiare comportamento quando quei formati evolvono. Pi in particolare richiede in più la dipendenza `pi-subagents`, perché non ha un primitivo nativo per i sottoagenti che le skill dispacciano. In generale Bun serve solo ai target convertiti, allo step aggiuntivo di Codex, allo sviluppo locale e alla pulizia di installazioni vecchie: Claude Code, da solo, non ne ha bisogno.

# Claude Code — marketplace ufficiale del repo
/plugin marketplace add EveryInc/compound-engineering-plugin
/plugin install compound-engineering

# Codex — tre passaggi (marketplace + agenti via Bun + install da TUI)
codex plugin marketplace add EveryInc/compound-engineering-plugin
bunx @every-env/compound-plugin install compound-engineering --to codex
# poi dentro Codex: /plugins → Compound Engineering → Install

# Cursor
/add-plugin compound-engineering

🏢 Perché è interessante, per sviluppatori e PMI

Per chi sviluppa, il valore non sta solo nell'installare il plugin: le 37 skill sono Markdown leggibile, e anche solo studiarle è un corso accelerato su come strutturare un ciclo con gli agenti — come si scrive un documento di requisiti dimensionato bene, come si passa da piano a worktree isolati, come si chiude un ciclo con una nota che il successivo può riusare. `STRATEGY.md` e i `pulse-reports` sono l'idea più originale del progetto: danno all'agente una memoria di cosa è successo, non solo istruzioni su cosa fare dopo.

Per una PMI che usa agenti di coding, il punto è la prevedibilità: sviluppatori diversi con lo stesso plugin producono lavoro con la stessa forma — requisiti, piano, review, nota di apprendimento — invece di stili di prompting incompatibili tra loro. La conoscenza smette di restare nella testa di chi ha scritto una feature e diventa un artefatto versionato, leggibile dal prossimo ciclo e dal prossimo collega. È lo stesso salto che separa il vibe coding artigianale da un'ingegneria agentica ripetibile, qui impacchettato in un plugin installabile in due comandi.

⚠️ Cosa sapere prima di adottarlo

Il flusso completo — strategia, brainstorm, piano, lavoro, review, apprendimento — rende al meglio su feature vere, meno su micro-fix, dove può sembrare un processo sovradimensionato: per un cambio da una riga non serve tutto il ciclo. Su Codex l'installazione richiede tre passaggi invece di uno, perché lo spec nativo dei plugin non copre ancora gli agenti custom da cui dipendono skill come `/ce-code-review` e `/ce-plan` — un limite dichiarato dal progetto stesso, non un bug nascosto.

Il progetto è dichiaratamente opinionated: 37 skill e 51 agenti sono una superficie ampia da assimilare, e i maintainer avvisano che non ogni proposta esterna verrà accettata, perché la direzione riflette un punto di vista specifico su come dovrebbe funzionare l'ingegneria con agenti. I target OpenCode, Pi, Gemini CLI e Kiro passano da un installer convertitore e non sono harness nativi come Claude Code: possono cambiare comportamento quando quei formati evolvono, e Pi richiede in più la dipendenza esterna `pi-subagents`.

• Overhead di processo: il ciclo completo conviene su feature vere, è eccessivo sui micro-fix.
• Codex in tre passi: marketplace + step Bun per gli agenti + install dal TUI, finché il plugin spec di Codex non supporta agenti nativi.
• Superficie ampia: 37 skill e 51 agenti sono molti da imparare; conviene partire dal solo ciclo core.
• Target converter-backed: OpenCode, Pi, Gemini CLI e Kiro passano da un convertitore Bun e possono cambiare nel tempo.

🗺️ Da dove partire

Il percorso che suggerisco: installa il plugin su Claude Code dal marketplace ufficiale, apri una feature vera — non un fix — e lascia che `/ce-brainstorm` faccia domande sul serio prima di passare a `/ce-plan`, `/ce-work` e `/ce-code-review`. Chiudi il ciclo con `/ce-compound` e leggi la nota che genera in `docs/solutions/`: è lì che si vede se il metodo sta davvero componendo o se resta solo cerimonia.

Se il tema ti interessa, ne ho scritto da altre angolazioni: Superpowers, un altro framework di skill con lo stesso obiettivo ma un approccio diverso al metodo, gli hook come quality gate che completano dall'esterno la disciplina interna di un ciclo come questo, e il salto culturale da vibe coding ad agentic engineering che Compound Engineering impacchetta in un plugin installabile in due comandi. Tre modi diversi di rispondere alla stessa domanda: come si dà una struttura ripetibile al lavoro con gli agenti.

Altri articoli del blog