# Anthropic Just Dropped a Masterclass on Building Agent Harnesses (for Large Codebases)

**Sursa:** https://youtu.be/efRIrLXoOVA?si=nygOxdoMyftTlKdN
**Data:** 2026-05-21
**Durata:** 28:10
**Tags:** @work #claude-code #ai-layer #coding-agents #codebase #productivity

---

## TL;DR

Anthropic a publicat un ghid despre cum să lucrezi cu Claude Code în codebaze mari. Mesajul central: **harness-ul (AI layer) contează la fel de mult ca modelul**. Videoul acoperă 7 componente ale "AI layer"-ului cu demo-uri practice și un plugin open-source pentru a le integra rapid în orice proiect.

---

## Puncte cheie

1. **AI Layer = a treia componentă a oricărui codebase** (după cod și teste): global rules, skills, hooks, LSP, MCP servers, sub-agents, plugins

2. **Global rules: lean & layered**
   - NU fă fișiere de mii de linii — studiile arată că diluează performanța agentului
   - Folosește `CLAUDE.md` în subdirectoare: regulile se încarcă progresiv pe măsură ce navighezi
   - Inițializează Claude Code direct din subdirectorul relevant → honing pe acea zonă

3. **Hooks pentru self-improvement**
   - **Stop hook**: rulează un subprocess Claude headless la final de sesiune → propune actualizări la `CLAUDE.md` bazate pe ce s-a schimbat
   - **Start hook**: încarcă context dinamic (git status, documentație Confluence per echipă/rol)
   - Asta face ca regulile să evolueze automat odată cu codul

4. **Skills = workflows, nu reguli**
   - `CLAUDE.md` = convenții; skills = procese reutilizabile
   - Parametrul `path` permite scoparea unui skill la un subdirector specific → activare automată când lucrezi acolo
   - Progressive disclosure: nu încarci totul, ci doar ce e relevant pentru task-ul curent

5. **LSP + MCP = navigare de nivel IDE**
   - LSP (Language Server Protocol) îi dă lui Claude aceleași capabilități de navigare pe care le ai în VS Code (go to definition, find references)
   - Înlocuiește/completeaza `grep` cu căutări semantice la nivel de simbol
   - Esențial pentru codebaze 100k+ linii unde grep devine lent și token-ineficient

6. **Sub-agents: separă explorarea de editare**
   - Trimite explorarea (research web, analiză codebase) la sub-agent cu propriul context window
   - Primești doar summary-ul înapoi → context window principal rămâne curat
   - Claude Code are deja Explorer sub-agent built-in

7. **Ownership organizational**
   - Desemnează 1-2 persoane să construiască AI layer-ul standard pentru echipă
   - "Quiet investment period" → buildout → rollout → adoptare consistentă
   - Evită: oameni dezamăgiți la primul contact (fără AI layer) și fragmentare (fiecare cu AI layer propriu)

---

## Quote-uri

> "The harness matters as much as the model. A lot of people get hyperfixated on model benchmarks... But honestly, what matters even more is the ecosystem built around the model."

> "Global rules are your conventions. Your skills are the workflows."

> "Not all expertise needs to be present in every session — same reason why we have different CLAUDE.md files in subdirectories."

> "Use sub-agents to split exploration from editing. By the time we get to the actual editing, we're already going to have this extremely bloated context window."

---

## Idei aplicabile direct pentru Echo Core / roa2web

- [ ] **Subdirectory CLAUDE.md** pentru `src/adapters/`, `dashboard/`, `tools/` — reguli specifice per zonă @work
- [ ] **Stop hook self-improving** — subprocess Claude la final de sesiune care propune update-uri la `personality/*.md` sau `CLAUDE.md` @work
- [ ] **Start hook** — încarcă automat git status + ultimele commits la pornire sesiune @work
- [ ] **Skill path-scoped** — ex: skill "adaugă handler dashboard" scoped la `dashboard/handlers/` @work
- [ ] **MCP search îmbunătățit** — dacă roa2web crește mult, LSP MCP pentru navigare mai bună @work