# openai-harness-engineering-codex-agent-first-2026-02-13

## Veille

Harness engineering di OpenAI: 1M di righe di codice, zero scrittura manuale, agenti Codex, progettazione di ambienti agent-first

## Titre Article

Harness engineering: leveraging Codex in an agent-first world

## Date

2026-02-13

## URL

https://openai.com/index/harness-engineering/

## Keywords

harness engineering, Codex, agenti di coding, zero codice scritto manualmente, context engineering, vincoli architetturali, garbage collection, linter personalizzati, Tests structurels, livelli di dipendenza, documentazione strutturata, cicli di feedback, agent-first, CI/CD, pull request automatizzate

## Authors

OpenAI

## Ton

**Profilo**: Prospettiva ingegneristica interna, registro tecnico elevato, tono fattuale da resoconto d'esperienza. Pubblicazione a cura di un team di ingegneria di OpenAI.

**Descrizione**: Il tono è quello di un resoconto ingegneristico interno, fattuale e ambizioso. L'articolo adotta una postura "show, don't tell" presentando i risultati di un esperimento interno radicale (zero codice scritto manualmente) con cifre concrete. Lo stile è diretto, orientato alla pratica, con una struttura che procede da "cosa si è rotto" a "cosa ha funzionato" e "cosa si è amplificato nel tempo" (compounded). L'articolo presuppone un pubblico di sviluppatori e architetti software che abbiano familiarità con gli agenti di coding, le pipeline CI/CD e le pratiche ingegneristiche su larga scala. Il messaggio centrale è provocatorio: il compito dell'ingegnere non è più scrivere codice, ma progettare ambienti per gli agenti.

## Pense-betes

- **Sperimentazione radicale**: un team di 3 ingegneri (poi 7) ha prodotto circa 1 milione di righe di codice in 5 mesi senza mai scrivere manualmente una singola riga, esclusivamente tramite agenti Codex. Circa 1.500 PR unite (merge), ovvero ~3,5 PR per ingegnere al giorno
- **Filosofia del "nessun codice scritto manualmente"**: principio fondante del team — gli esseri umani non contribuiscono mai direttamente al codice. L'ingegneria si concentra su sistemi, scaffolding e leva
- **Definizione dell'harness**: l'ambiente completo di scaffolding, vincoli e cicli di feedback che circonda un agente IA (struttura del repo, configurazione CI, regole di formattazione, package manager, framework, istruzioni di progetto, integrazione di strumenti, linter)
- **Tre pilastri**: (1) Context engineering, (2) Vincoli architetturali, (3) Gestione dell'entropia (garbage collection)
- **Context engineering**: documentazione strutturata all'interno del repo con mappe di sistema, piani di esecuzione, specifiche di design. Le decisioni architetturali provenienti da Slack devono essere codificate come artefatti versionati all'interno del repo. "Dal punto di vista dell'agente, ciò che non è nel contesto non esiste"
- **Vincoli architetturali**: modello a livelli rigido con direzione delle dipendenze validata: Types → Config → Repo → Service → Runtime → UI. Applicazione meccanica tramite linter personalizzati (generati da Codex) e Tests structurels in CI
- **Linter intelligenti**: i messaggi di errore dei linter sono progettati per iniettare istruzioni di correzione direttamente nel contesto dell'agente, non semplicemente per bloccare il codice
- **Garbage collection**: task ricorrenti in background di Codex che identificano le deviazioni dai "principi aurei", aggiornano i punteggi di qualità e aprono PR di refactoring per il merge automatico
- **Cambiamento fondamentale del ruolo**: l'ingegnere passa dallo scrivere codice al progettare ambienti, specificare l'intento e costruire cicli di feedback
- **Citazione di Martin Fowler**: descrive l'harness engineering come un "framing prezioso" per lo sviluppo assistito dall'IA
- **Il collo di bottiglia**: le prestazioni degli agenti dipendono spesso più dalla progettazione dell'ambiente che dall'intelligenza del modello

## RésuméDe400mots

OpenAI pubblica un resoconto di una metodologia interna denominata "harness engineering" applicata allo sviluppo agent-first con Codex. Nell'arco di cinque mesi, un team di tre ingegneri (successivamente ampliato a sette) ha prodotto un prodotto beta interno contenente circa un milione di righe di codice, senza scrivere manualmente nemmeno una riga. Gli agenti Codex hanno aperto, valutato e unito (merge) circa 1.500 pull request, in media 3,5 PR per ingegnere al giorno.

L'harness è definito come l'ambiente completo di scaffolding, vincoli e cicli di feedback che circonda un agente IA: struttura del repository, configurazione CI, regole di formattazione, framework applicativi, istruzioni di progetto, integrazione di strumenti esterni e linter. Il primo commit in un repository vuoto è stato generato da Codex CLI con GPT-5, guidato da template.

L'approccio si fonda su **tre pilastri**. Il **context engineering** si basa su una documentazione strutturata all'interno del repository, organizzata in directory contenenti mappe di sistema, piani di esecuzione e specifiche di design. Le decisioni architetturali prese su Slack devono essere codificate come artefatti versionati accessibili all'interno del repo, poiché dal punto di vista dell'agente, ciò che non è nel contesto non esiste.

I **vincoli architetturali** vengono imposti meccanicamente attraverso un rigido modello a livelli di dipendenza (Types → Config → Repo → Service → Runtime → UI), linter personalizzati generati da Codex e Tests structurels in stile ArchUnit eseguiti in CI. I messaggi di errore dei linter sono progettati per iniettare istruzioni di correzione direttamente nel contesto dell'agente, trasformando i vincoli in guida attiva.

La **gestione dell'entropia** (garbage collection) consiste in task ricorrenti di Codex che analizzano il codice alla ricerca di deviazioni dai principi stabiliti, aggiornano i punteggi di qualità e aprono PR di refactoring con merge automatico.

L'articolo afferma un cambiamento fondamentale nel ruolo dell'ingegnere: l'ingegnere non scrive più codice, ma progetta ambienti, specifica l'intento e costruisce cicli di feedback per gli agenti. La sfida più grande individuata riguarda la progettazione di questi ambienti, dei cicli di feedback e dei sistemi di controllo. Il collo di bottiglia nelle prestazioni degli agenti risiede spesso nella progettazione dell'ambiente più che nell'intelligenza del modello. Martin Fowler ha descritto questo approccio come un "framing prezioso" per lo sviluppo assistito dall'IA.

## GrapheDeConnaissance

- OpenAI —publie→ Harness engineering: leveraging Codex in an agent-first world (DOCUMENT, 0.99)
- OpenAI —mesure→ 1 million de lignes de code produites sans écriture manuelle en 5 mois (MESURE, 0.95)
- Codex —mesure→ 1500 pull requests fusionnées en 5 mois (MESURE, 0.93)
- Harness engineering —est_basé_sur→ Ingénierie de contexte (CONCEPT, 0.97)
- Harness engineering —est_basé_sur→ Contraintes architecturales (CONCEPT, 0.97)
- Harness engineering —est_basé_sur→ Garbage collection (code) (CONCEPT, 0.95)
- Contraintes architecturales —utilise→ Couches de dépendances Types→Config→Repo→Service→Runtime→UI (CONCEPT, 0.92)
- Linters custom —permet→ Instructions de correction dans contexte agent (CONCEPT, 0.9)
- Garbage collection (code) —permet→ PRs de refactoring auto-mergées (CONCEPT, 0.88)
- Martin Fowler —affirme_que→ Harness engineering est un cadrage précieux (AFFIRMATION, 0.9)
- Codex —utilise→ GPT-5 (TECHNOLOGIE, 0.85)
- Conception d'environnements pour agents —remplace→ écriture manuelle de code par l'ingénieur (CONCEPT, 0.92)

---
Canonical: https://www.thekb.eu/it/fiches/openai-harness-engineering-codex-agent-first-2026-02-13/