3.8 KiB
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
-
AI Layer = a treia componentă a oricărui codebase (după cod și teste): global rules, skills, hooks, LSP, MCP servers, sub-agents, plugins
-
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ă
-
Hooks pentru self-improvement
- Stop hook: rulează un subprocess Claude headless la final de sesiune → propune actualizări la
CLAUDE.mdbazate 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
- Stop hook: rulează un subprocess Claude headless la final de sesiune → propune actualizări la
-
Skills = workflows, nu reguli
CLAUDE.md= convenții; skills = procese reutilizabile- Parametrul
pathpermite 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
-
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
grepcu căutări semantice la nivel de simbol - Esențial pentru codebaze 100k+ linii unde grep devine lent și token-ineficient
-
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
-
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/*.mdsauCLAUDE.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