# klaassen-compound-engineering-definitive-guide-every-2026-02-09

## Veille

Manuale di riferimento sul compound engineering: loop agentico in 7 passaggi (Ideate→Brainstorm→Plan→Work→Review→Polish→Compound), plugin agent con 40+ agenti, scala di adozione a 5 stadi, regola del 50/50 — Kieran Klaassen (Cora / Every) - Every Source Code

## Titre Article

Compound Engineering: The Definitive Guide

## Date

2026-02-09

## URL

https://every.to/source-code/compound-engineering-the-definitive-guide

## Keywords

compound engineering, filosofia AI-native, loop in 7 passaggi, complessità invertita, Claude Code, plugin open source, subagenti, revisione del codice multi-agente, agent-native, regola del 50/50, i piani sono il nuovo codice, scala di adozione a 5 stadi, lezioni apprese, docs/solutions, CLAUDE.md, harness, vibe coding, /lfg, Cora, Every, SDLC, ciclo di vita dello sviluppo software, SDLC agentico

## Authors

Kieran Klaassen (avec Claude & GPT crédités co-auteurs du guide complet)

## Ton

**Profilo**: prospettiva di un fondatore-praticante (GM di prodotto), registro manifesto-manuale dottrinale, livello da intermedio ad avanzato

**Descrizione**: Kieran Klaassen scrive in modalità "manuale di riferimento" — il testo si presenta esplicitamente come *The Definitive Guide* e mira a fissare il vocabolario, la filosofia e gli strumenti di un movimento già circolato in diversi articoli precedenti di Every. Il tono è assertivo, quasi dottrinale: enuncia una definizione canonica (*"ogni unità di lavoro ingegneristico dovrebbe rendere più facili le unità successive—non più difficili"*) e la contrappone poi nettamente alla sorte abituale delle codebase che si degradano nel tempo (*"dopo 10 anni, i team passano più tempo a combattere contro il proprio sistema che a costruire"*). L'autorità poggia sulla prova d'uso — Cora e i cinque prodotti di Every gestiti da team di una sola persona. La retorica procede per rovesciamenti di credenze (*"credenze da disimparare"* / *"credenze da adottare"*), per massime incisive (*"I piani sono il nuovo codice,"* *"Spedisci più valore. Scrivi meno codice."*, *"Il taste appartiene ai sistemi, non alla revisione."*), e per un apparato pedagogico altamente strutturato (scala di adozione, checklist, esempi di codice). Pubblico target: sviluppatori e leader tecnici che vogliono passare da un uso occasionale dell'IA a un'ingegneria agentica sistematizzata.

## Pense-betes

- **Definizione canonica**: il compound engineering è l'approccio in cui *ogni unità di lavoro ingegneristico rende più facili le unità successive, non più difficili*. Inverte la traiettoria della complessità: le correzioni di bug eliminano intere categorie di bug futuri, i pattern diventano strumenti, la codebase diventa più facile nel tempo.
- **Loop principale a 7 passaggi**: **Ideate → Brainstorm → Plan → Work → Review → Polish → Compound → (Repeat)**. Tre fasi: decisione umana (cosa costruire?), esecuzione agentica (piano/codice/test/PR), giudizio umano (l'output è sufficiente? il sistema ha imparato?). 1. **Ideate** (`/ce-ideate`): ambiguità → opzioni di prodotto prioritizzate (scoring di confidenza/impatto/complessità). 2. **Brainstorm** (`/ce-brainstorm`): idea vaga → requisiti concreti, salvati in `docs/brainstorms/`. 3. **Plan** (`/ce-plan`): 3 agenti di ricerca paralleli (repo, framework-docs, best-practices) + spec-flow-analyzer → piano strutturato in `docs/plans/`. 4. **Work** (`/ce-work`): isolamento (git worktree), esecuzione passo per passo, validazioni, PR. 5. **Review** (`/ce-code-review`): revisori specializzati in parallelo, findings prioritizzati **P1/P2/P3**. 6. **Polish** (`/ce-polish-beta`): navigare realmente nell'app, cosa "sembra sbagliato" (velocità, animazione, copy, stati vuoti). 7. **Compound** (`/ce-compound`): "il passaggio critico" — catturare la soluzione in `docs/solutions/` con frontmatter YAML, aggiornare CLAUDE.md, creare agenti. *"Il sistema lo individuerebbe automaticamente la prossima volta?"*
- **Il plugin** (`EveryInc/compound-engineering-plugin`): **40+ agenti specializzati**, **30+ comandi slash**, **35+ skill**. Review = ~23 revisori (always-on: correctness, testing, maintainability, project-standards, agent-native, learnings; condizionali: security, performance, API contract, migrations, reliability, adversarial; specifici per stack: Rails, Python, TypeScript, Swift/iOS, frontend-races). Installabile su Claude Code, Cursor, Codex (+ Copilot, Factory Droid, Gemini, ecc.).
- **Struttura del progetto**: `CLAUDE.md`/`AGENTS.md` (file più importante, letto ad ogni sessione) + `.compound-engineering/config.local.yaml` + `docs/brainstorms/`, `docs/plans/`, `docs/solutions/` (categorizzati: performance-issues, security-issues, architecture-patterns, conventions…).
- **`/lfg`**: sviluppo autonomo dall'idea alla PR mergiata (Plan → Work → review+autofix → test browser → commit/push/PR).
- **Regola del 50/50 (revisione dell'80/20)**: 50% del tempo a costruire funzionalità, 50% a migliorare il sistema (agenti di revisione, documentazione dei pattern, generatori di test). ROI: 1 ora a creare un agente di revisione ne fa risparmiare 10 nell'arco dell'anno — *i miglioramenti al sistema si accumulano, le funzionalità no*.
- **8 credenze da disimparare**: il codice deve essere scritto a mano / ogni riga revisionata manualmente / la soluzione viene dall'ingegnere / il codice è l'artefatto primario / le prime bozze devono essere buone (*"i primi tentativi hanno un tasso di scarto del 95%"*) / il codice è autoespressione (*"il codice non è davvero tuo"*) / scrivere di più significa imparare di più (*"la comprensione conta più della memoria muscolare"*) / il pensiero ingegneristico ≠ il pensiero di prodotto.
- **8 credenze da adottare**: estrarre il proprio *taste* nel sistema; regola del 50/50; fidarsi del processo + reti di sicurezza; **ambiente agent-native** (*"se uno sviluppatore può vedere o fare qualcosa, anche l'agente dovrebbe poterlo"*); parallelizzazione (il nuovo collo di bottiglia è il calcolo, non l'attenzione umana); *"i piani sono il nuovo codice"*; *"gli ingegneri ora sono product people"*; lasciare che gli agenti lavorino mentre si è assenti.
- **Scala di adozione a 5 stadi**: 0 manuale → 1 assistenza chat → 2 agentico con revisione riga per riga (la maggior parte si ferma qui) → **3 plan-first, revisione a livello di PR (transizione chiave: il compound engineering inizia qui)** → 4 idea→PR (1 macchina) → 5 esecuzione cloud parallela (multi-funzionalità, multi-dispositivo).
- **Agent-native — 4 livelli**: (1) sviluppo di base (file, test, commit); (2) locale completo (browser, log, PR); (3) visibilità in produzione (log in sola lettura, tracciamento errori); (4) integrazione completa (ticket, deployment) → sblocca lo stadio 5.
- **Skip permissions**: `alias cc='claude --dangerously-skip-permissions'`; nome deliberatamente allarmante; reti di sicurezza = git reset, test, revisione PR, worktree. Guadagno di flow 5-10×. Mai in produzione o durante l'apprendimento.
- **3 domande senza tooling**: *"Qual è stata la decisione più difficile?"* / *"Quali alternative hai scartato e perché?"* / *"Di cosa sei meno sicuro?"*
- **Best practice dettagliate**: *baby app* usa e getta per iterare sul design; figma-design-sync + design-iterator; codificare il *taste* di design/copy in skill; ricerca utente strutturata (persona, frontmatter) leggibile dall'IA; estrazione dei pattern d'uso (heavy/struggle/workaround/abandonment); copy = UX (codificare la voce); marketing di prodotto automatizzato (note di rilascio + screenshot Playwright generati dal piano).
- **Forte legame con la veille**: testo di consolidamento della filosofia già circolato in [[shipper-klaassen-compound-engineering-every-agents-2025-12-11]], [[klaassen-stop-coding-start-planning-every-2025-11-06]], [[klaassen-teach-ai-think-senior-engineer-every-2025-11-07]]; pipeline di revisione v260 [[chow-compound-engineering-v260-review-pipeline-2026-03-31]]; livello 5 "Workflows / harness" di taylor-entis-every-eight-levels-ai-adoption-2026-06-02.

## RésuméDe400mots

Con *Compound Engineering: The Definitive Guide*, Kieran Klaassen fornisce il manuale di riferimento di una filosofia di ingegneria AI-native che Every promuove dalla fine del 2025. La tesi è economica: l'IA trasforma l'economia dello sviluppo, al punto che Every gestisce i suoi **cinque prodotti** (Cora, Spiral, Sparkle, Monologue, Proof) con **team di una sola persona** — un ingegnere può "spedire come cinque."

La **definizione canonica**: *ogni unità di lavoro ingegneristico dovrebbe rendere più facili le unità successive, non più difficili*. Nell'ingegneria tradizionale, ogni funzionalità inietta complessità; dopo dieci anni, i team combattono contro il proprio sistema più di quanto costruiscano. Il compound engineering inverte questa pendenza: le correzioni di bug eliminano intere categorie di bug futuri, i pattern diventano strumenti, la codebase diventa *più facile* nel tempo.

Il nucleo operativo è un **loop in sette passaggi**: **Ideate → Brainstorm → Plan → Work → Review → Polish → Compound**, organizzato in tre fasi (decisione umana, esecuzione agentica, giudizio umano). **Plan** orchestra tre agenti di ricerca paralleli seguiti da uno spec-flow-analyzer; **Review** dispiega revisori specializzati (always-on, condizionali, specifici per stack) che producono findings prioritizzati P1/P2/P3; **Compound** — "il passaggio critico" — cattura ogni soluzione in `docs/solutions/` con frontmatter YAML e aggiorna `CLAUDE.md`, trasformando la conoscenza in un asset riutilizzabile e ridistribuito.

Tutto ciò è strumentato da un **plugin open source** (`EveryInc/compound-engineering-plugin`): 40+ agenti, 30+ comandi slash, 35+ skill, installabile su Claude Code, Cursor, Codex. Il comando `/lfg` automatizza il percorso idea→PR mergiata.

La guida procede poi rovesciando le credenze: **otto da disimparare** (codice scritto a mano, revisione riga per riga, codice come autoespressione — *"i primi tentativi hanno un tasso di scarto del 95%"*) e **otto da adottare** (estrarre il proprio *taste* nel sistema, la **regola del 50/50** — metà funzionalità, metà miglioramento del sistema —, un ambiente **agent-native**: *"se uno sviluppatore può vedere o fare qualcosa, anche l'agente dovrebbe poterlo"*, la parallelizzazione, *"i piani sono il nuovo codice"*).

L'adozione segue una **scala a cinque stadi**, dalla scrittura manuale (0) all'esecuzione cloud parallela (5), con il compound engineering che inizia allo **stadio 3** (plan-first, revisione a livello di PR). Klaassen dettaglia infine le best practice: design *baby app* usa e getta, skip permissions, codificare il *taste* (design, copy), ricerca utente strutturata, estrazione dei pattern d'uso, marketing di prodotto automatizzato. Massime distintive: *"Il taste appartiene ai sistemi, non alla revisione,"* *"Spedisci più valore. Scrivi meno codice,"* *"Assegna risultati, non compiti."*

## GrapheDeConnaissance

- Kieran Klaassen —publie→ Compound Engineering: The Definitive Guide (DOCUMENT, 0.98)
- Compound Engineering —affirme_que→ chaque unité de travail rend la suivante plus facile (AFFIRMATION, 0.98)
- Compound Engineering —est_basé_sur→ boucle 7 étapes Ideate-Brainstorm-Plan-Work-Review-Polish-Compound (CONCEPT, 0.97)
- étape Compound —permet→ capitalisation des leçons apprises en docs/solutions réutilisables (CONCEPT, 0.96)
- Compound Engineering —recommande→ règle 50/50 (features / amélioration système) (CONCEPT, 0.93)
- Compound Engineering —recommande→ environnement agent-native (CONCEPT, 0.95)
- Every —publie→ plugin Compound Engineering (TECHNOLOGIE, 0.97)
- plugin Compound Engineering —permet→ review multi-agents P1/P2/P3 (CONCEPT, 0.95)
- plugin Compound Engineering —s_applique_à→ Claude Code, Cursor, Codex (TECHNOLOGIE, 0.94)
- Every —mesure→ 5 produits opérés par des équipes d'une personne (MESURE, 0.95)
- Kieran Klaassen —dirige→ Cora (TECHNOLOGIE, 0.97)
- Compound Engineering —affirme_que→ « Plans are the new code » (CITATION, 0.92)
- Kieran Klaassen —affirme_que→ l'adoption du compound engineering commence au stade 3 (plan-first, review niveau PR) (AFFIRMATION, 0.9)
- Kieran Klaassen —affirme_que→ first attempts ont 95% de déchet (AFFIRMATION, 0.88)
- /lfg —permet→ développement idée vers PR mergée (CONCEPT, 0.92)
- Compound Engineering —est_instance_de→ SDLC (METHODOLOGIE, 0.88)

---
Canonical: https://www.thekb.eu/it/fiches/klaassen-compound-engineering-definitive-guide-every-2026-02-09/