Prompt injection, poisoned tools, slopsquatting.Inyección de prompts, herramientas envenenadas, slopsquatting.
Second edition · September 2026Segunda edición · Septiembre 2026
The Agentic Crew
Engineering in the age of AI agentsIngeniería en la era de los agentes de IA
Rasmus Bornhøft Schlünsen
Second edition · September 2026Segunda edición · Septiembre 2026 New chapterCapítulo nuevo The Agent Attack SurfaceLa superficie de ataque del agente New chapterCapítulo nuevo Building Your Own AgentsConstruye tus propios agentes RewrittenReescrito Context engineeringIngeniería de contexto New appendixApéndice nuevo The State of the ToolsEl estado de las herramientas
The first edition came out in March 2026. Six months later, a lot had moved: instruction files converged, cloud agents started sending pull requests, and prompt injection became a string of real incidents. The second edition adds two new chapters — on the agent attack surface and on building your own agents — and moves the perishable details into one dated appendix.La primera edición salió en marzo de 2026. Seis meses después, mucho había cambiado: los archivos de instrucciones convergieron, los agentes en la nube empezaron a enviar pull requests y la inyección de prompts se convirtió en una serie de incidentes reales. La segunda edición añade dos capítulos nuevos — sobre la superficie de ataque del agente y sobre construir tus propios agentes — y mueve los detalles perecederos a un apéndice fechado. Six months is a long time at sea.Seis meses es mucho tiempo en el mar.
Own the loop, the context, and the control flow.Controla el bucle, el contexto y el flujo.
Compaction, sub-agents, AGENTS.md, skills, hooks.Compactación, subagentes, AGENTS.md, skills, hooks.
The perishable details, in one dated place.Los detalles perecederos, en un solo lugar fechado.
The ground is shiftingEl terreno está cambiando Old loopAntes New loopAhora Measured, not feltMedido, no sentido
For two decades, the feedback loop was simple: write code, run it, ship it. AI agents are fundamentally changing that loop.Durante dos décadas, el ciclo fue simple: escribir código, ejecutarlo, desplegarlo. Los agentes de IA están cambiando ese ciclo de raíz. You write code, you ship it. That loop is breaking.Escribes código, lo despliegas. Ese ciclo se está rompiendo.
write → run → shipescribir → ejecutar → desplegar
instruct → review → steerinstruir → revisar → dirigir
In METR’s 2025 trial, experienced developers were ~19% slower with AI — while feeling ~20% faster.En el ensayo de METR de 2025, desarrolladores expertos fueron ~19% más lentos con IA — sintiéndose ~20% más rápidos.
From the forewordDel prólogo
The craft is evolving. The mechanical parts are being automated, but the judgment, taste, and architectural thinking are more important than ever.El oficio está evolucionando. Las partes mecánicas se automatizan, pero el juicio, el gusto y el pensamiento arquitectónico importan más que nunca. The craft isn’t dying. It’s molting.El oficio no está muriendo. Está mudando.
The keystrokes and boilerplate fall away. Systems thinking, taste, and judgement become the whole game.Las pulsaciones y el código repetitivo desaparecen. El pensamiento sistémico, el gusto y el juicio lo son todo.
What is an agent?¿Qué es un agente?
Agents exist on a spectrum. Most practical work today happens at the tool-using agent level, where the agent can call tools, read files, and iterate.Los agentes existen en un espectro. La mayor parte del trabajo práctico hoy ocurre en el nivel del agente con herramientas, que puede llamar herramientas, leer archivos e iterar. Model + tools + loop + harness.Modelo + herramientas + bucle + arnés.
- 00 AutocompleteAutocompletado
Suggests the next line.Sugiere la siguiente línea.
- 01 CopilotCopiloto
Generates on request.Genera cuando se lo pides.
- 02 Tool-using agentAgente con herramientas
Reads, runs, iterates. Most real work happens here.Lee, ejecuta, itera. Aquí ocurre casi todo el trabajo real.
- 03 Background agentAgente en segundo plano
Takes a task, returns a pull request.Toma una tarea y devuelve un pull request.
The Rain Man analogyLa analogía de Rain Man
Think of it like Rain Man. Tom Cruise provides the direction and judgment. Dustin Hoffman provides extraordinary capability but needs guidance.Piénsalo como Rain Man. Tom Cruise aporta la dirección y el juicio. Dustin Hoffman aporta una capacidad extraordinaria, pero necesita guía. You’re Tom Cruise. The agent is Dustin Hoffman.Tú eres Tom Cruise. El agente es Dustin Hoffman.
You — the captainTú — el capitán
Direction and vision · Judgement and taste · Knows when to walk awayDirección y visión · Juicio y gusto · Sabe cuándo retirarse
The agent — the savantEl agente — el savant
Speed and throughput · Tireless execution · Pattern recognition at scaleVelocidad y rendimiento · Ejecución incansable · Reconocimiento de patrones a escala
Three core capabilitiesTres capacidades fundamentales ii PlanningPlanificación iiii Tool useUso de herramientas iiiiii IterationIteración
These are the three core capabilities that make an agent an agent: planning, tool use, and iteration. Without any one of these, you just have a chatbot.Estas son las tres capacidades que hacen que un agente sea un agente: planificación, uso de herramientas e iteración. Sin cualquiera de ellas, solo tienes un chatbot. Without any one of these, it’s just a chatbot.Sin cualquiera de ellas, es solo un chatbot.
Breaks a goal into ordered, verifiable steps.Divide un objetivo en pasos ordenados y verificables.
Reads files, runs commands, calls APIs. The tools are the promotion.Lee archivos, ejecuta comandos, llama APIs. Las herramientas son el ascenso.
Act, observe, adjust — until the tests are green.Actuar, observar, ajustar — hasta que los tests pasen.
When agents failCuando los agentes fallan Fix: tight scopeSolución: alcance acotado Scope creepExpansión del alcance Fix: run the testsSolución: ejecutar los tests Hallucinated APIsAPIs alucinadas Fix: verifySolución: verificar OverconfidenceExceso de confianza Fix: compact, start freshSolución: compactar, empezar de nuevo Context lossPérdida de contexto
Understanding failure modes is critical. These are the four most common ways agents go wrong, and how to mitigate each one.Entender los modos de fallo es crucial. Estas son las cuatro formas más comunes en que los agentes fallan, y cómo mitigar cada una. Every failure mode has a mitigation.Cada modo de fallo tiene una mitigación.
You asked for a bug fix; it refactored thirty files.Pediste un arreglo; refactorizó treinta archivos.
Plausible code against libraries that don’t exist.Código plausible contra librerías que no existen.
A sleep() and a mutex arrive with the same certainty.Un sleep() y un mutex llegan con la misma certeza.
Constraints from an hour ago quietly fade.Las restricciones de hace una hora se desvanecen.
The engineering toolkitEl kit de ingeniería ContextContexto GuardrailsBarandillas TestsTests ConventionsConvenciones MemoryMemoria
These five practices form the engineering toolkit for working with agents effectively. Each one reinforces the others.Estas cinco prácticas forman el kit de ingeniería para trabajar con agentes de forma eficaz. Cada una refuerza a las demás. The boring things win.Lo aburrido gana.
What the agent can see — and reach.Lo que el agente puede ver — y alcanzar.
Permissions, hooks, sandboxes.Permisos, hooks, sandboxes.
The agent’s eyes.Los ojos del agente.
AGENTS.md, skills, structure.AGENTS.md, skills, estructura.
The ship’s log across sessions.El cuaderno de bitácora entre sesiones.
Context engineeringIngeniería de contexto
Context engineering is the discipline of deciding what goes into the model’s window. Bigger windows didn’t remove the tax — performance still degrades as context grows. So research first, then plan, then implement, with a fresh or compacted context between each phase, and use sub-agents to explore without polluting the main window.La ingeniería de contexto es la disciplina de decidir qué entra en la ventana del modelo. Las ventanas más grandes no eliminaron el coste — el rendimiento sigue degradándose a medida que crece el contexto. Así que primero investiga, luego planifica, luego implementa, con un contexto nuevo o compactado entre cada fase, y usa subagentes para explorar sin contaminar la ventana principal. Bigger windows didn’t remove the tax.Las ventanas más grandes no eliminaron el coste.
- i ResearchInvestigar
Sub-agents explore; only a summary comes back.Los subagentes exploran; solo vuelve un resumen.
- ii PlanPlanificar
A written plan you review before any code changes.Un plan escrito que revisas antes de cambiar código.
- iii ImplementImplementar
Fresh, compacted context. Tests as the signal.Contexto nuevo y compactado. Los tests como señal.
The agent attack surfaceLa superficie de ataque del agente
The biggest gap in the first edition was security. An agent that has access to private data, is exposed to untrusted content, and has a way to communicate externally can be tricked into leaking that data. Simon Willison calls it the lethal trifecta. You can’t fully prevent prompt injection yet — so remove at least one leg for any session.La mayor carencia de la primera edición era la seguridad. Un agente con acceso a datos privados, expuesto a contenido no confiable y con una forma de comunicarse hacia fuera puede ser engañado para filtrar esos datos. Simon Willison lo llama la tríada letal. Aún no puedes evitar del todo la inyección de prompts — así que elimina al menos una pata en cada sesión. Remove one leg of the lethal trifecta.Elimina una pata de la tríada letal.
Private dataDatos privados
Untrusted contentContenido no confiable
A way outUna salida al exterior
An agent that reads a stranger’s text with your keys in its pocket works for whoever wrote the text.Un agente que lee el texto de un desconocido con tus llaves en el bolsillo trabaja para quien escribió ese texto.
Agents in the pipelineAgentes en el pipeline Assign an issueAsigna un issue Get a pull requestRecibe un pull request Review is the bottleneckLa revisión es el cuello de botella
The overnight agent the first edition described as a shell script became a product feature. You assign an issue, and a pull request comes back. That makes agent capacity cheap. What isn’t cheap is human attention — a dozen pull requests still need someone who understands every one of them. Plan your work around the reviewer, not the agents.El agente nocturno que la primera edición describía como un script se convirtió en una función de producto. Asignas un issue y vuelve un pull request. Eso abarata la capacidad de los agentes. Lo que no es barato es la atención humana — una docena de pull requests sigue necesitando a alguien que entienda cada uno. Planifica el trabajo en torno al revisor, no a los agentes. Agents are cheap now. Attention isn’t.Los agentes ya son baratos. La atención no.
A cloud agent works in a sandbox.Un agente en la nube trabaja en un sandbox.
Tests, a diff, a summary.Tests, un diff, un resumen.
Plan around the reviewer, not the agents.Planifica en torno al revisor, no a los agentes.
Building your own agentsConstruye tus propios agentes Own the contextControla el contexto Own the control flowControla el flujo Humans as a tool callHumanos como una llamada Evals are your testsLas evals son tus tests
Once you build agents yourself, you see how much of what feels like the model being smart is really the loop around it: what goes into the context, which tools exist, when it stops, and what it is allowed to touch. The loop is small. Everything around it is the work — and that part is engineering.Cuando construyes agentes tú mismo, ves cuánto de lo que parece inteligencia del modelo es en realidad el bucle que lo rodea: qué entra en el contexto, qué herramientas existen, cuándo se detiene y qué puede tocar. El bucle es pequeño. Todo lo que lo rodea es el trabajo — y esa parte es ingeniería. The loop is small. The harness is the work.El bucle es pequeño. El arnés es el trabajo.
You build the prompt every turn.Construyes el prompt en cada turno.
Budgets, stop conditions, escalation.Presupuestos, condiciones de parada, escalado.
Pause, persist, resume when they answer.Pausa, persiste, reanuda cuando respondan.
Run them on every prompt or model change.Ejecútalas en cada cambio de prompt o modelo.
Orchestration in practiceOrquestación en la práctica Session per worktreeUna sesión por worktree Granular permissionsPermisos granulares One view of the crewUna vista de la tripulación
Wee Editor was built to practice what the book preaches: a self-hosted workspace for running many agent sessions in parallel — each in its own worktree, with its own permissions, and with visibility into what every agent is doing. The best way to learn agentic engineering is to build agentic tooling.Wee Editor se construyó para practicar lo que predica el libro: un espacio de trabajo autoalojado para ejecutar muchas sesiones de agentes en paralelo — cada una en su propio worktree, con sus propios permisos y con visibilidad de lo que hace cada agente. La mejor manera de aprender ingeniería agéntica es construir herramientas agénticas. Build the tooling. Learn the craft.Construye las herramientas. Aprende el oficio.
Multi-agent orchestrationOrquestación multiagente
Guardrails in codeBarandillas en código
Solving the visibility problemResolviendo el problema de visibilidad
Wee Editor — my self-hosted workspace for running agent sessions in parallel. wee.catWee Editor — mi espacio de trabajo autoalojado para ejecutar sesiones de agentes en paralelo. wee.cat
Agents as pentestersAgentes como pentesters Never productionNunca en producción Written authorisationAutorización por escrito Human-verify findingsVerificación humana
When your agent IS the threat model, guardrails become existential. Never run on production. Require written authorization. Human-verify every finding.Cuando tu agente ES el modelo de amenaza, las barandillas se vuelven existenciales. Nunca en producción. Exige autorización por escrito. Verifica cada hallazgo con humanos. When your agent is the threat model.Cuando tu agente es el modelo de amenaza.
A SQL injection test against prod isn’t a test. It’s an incident.Un test de inyección SQL contra producción no es un test. Es un incidente.
From whoever controls every system in scope.De quien controle cada sistema en alcance.
Agents hallucinate vulnerabilities, too.Los agentes también alucinan vulnerabilidades.
The crew metaphorLa metáfora de la tripulación
This is the central metaphor of the book. You are the captain. The agents are your crew. The codebase is the ship. The crew is replaceable. The ship is not.Esta es la metáfora central del libro. Tú eres el capitán. Los agentes son tu tripulación. La base de código es el barco. La tripulación es reemplazable. El barco no. The crew is disposable. The ship is not.La tripulación es desechable. El barco no.
- HullCasco
- Your codebaseTu base de código
- RiggingAparejo
- ConventionsConvenciones
- SoundingsSondeos
- TestsTests
- LogBitácora
- MemoryMemoria
- CaptainCapitán
- YouTú
- CrewTripulación
- AgentsAgentes
Go build somethingVe a construir algo
The call to action. Don’t wait. Open your terminal tonight. Pick a real task. Let the agent try. You’ll learn more in one hour than in a week of reading.La llamada a la acción. No esperes. Abre tu terminal esta noche. Elige una tarea real. Deja que el agente lo intente. Aprenderás más en una hora que en una semana de lectura. Tonight — not tomorrow — open your terminal.Esta noche — no mañana — abre tu terminal.
The book is free, in four languages. Second edition, September 2026.El libro es gratuito, en cuatro idiomas. Segunda edición, septiembre de 2026.