Workshop: Harness Engineering, Teaching Claude Code to Work in Your Project

A coding agent works as well as the environment we build around it. The model is what the vendor trains, and you can't touch it. The harness is everything else: instructions, rules, skills, specs, tests, linters, hooks and reviews. Building it is called harness engineering.

In this live workshop I switch between slides and code to show how to teach Claude Code to work in a real project, with our rules and our checks. We start from the two sides of a harness: feed-forward, what we give the agent before it writes, and feedback, what tells it that it got something wrong.

Then we go through context engineering and spec-driven development (AGENTS.md, rules, skills, a quick look at MCP, and how to write a spec before the agent writes code), and we close with verification and quality gates: the layers that check the agent's work so it can see its own mistakes and fix them.

Un agente lavora bene quanto l'ambiente che gli costruiamo intorno. Il modello è quello che il vendor allena, e non lo possiamo toccare. L'harness è tutto il resto: istruzioni, rules, skill, spec, test, linter, hook e review. Costruirlo si chiama harness engineering.

In questo workshop dal vivo alterno slide e codice per mostrare come insegnare a Claude Code a lavorare in un progetto reale, con le nostre regole e i nostri controlli. Partiamo dai due lati di un harness: il feed-forward, cioè quello che diamo all'agente prima che scriva, e il feedback, cioè quello che gli dice se ha sbagliato.

Poi vediamo context engineering e spec-driven development (AGENTS.md, rules, skill, un cenno a MCP e come scrivere una spec prima che l'agente scriva codice), e chiudiamo con verification e quality gates: i layer che controllano il lavoro dell'agente, così può vedere i suoi errori e correggersi.