Blog

Notas sobre mi día a día como ingeniero, mi historia y los aprendizajes puntuales que voy recogiendo por el camino. Para entregables y trabajo de cliente, pásate por Proyectos.

Comentarios de código en la era de los agentes de IA

Opinión técnica · El porqué, no el qué

Comentarios de código en la era de los agentes de IA

El código ya se produce en masa y quien más tiempo pasa leyéndolo es un agente de IA. Construí una app entera con uno, en un lenguaje que no domino, y el resultado me obligó a repensar la vieja regla de «el código no se comenta».

Claude Code Swift · SwiftUI Comentarios de porqué ADRs Valla de Chesterton +1
Ver detalles
Por qué aposté por mí y me hice freelance

Historia · Por qué trabajo por mi cuenta

Por qué aposté por mí y me hice freelance

No lo busqué, la oportunidad me llegó de rebote. Pero cuando miro atrás, todo apuntaba aquí: apostar por mí mismo y subir mi tolerancia al riesgo en lugar de comprar una falsa sensación de estabilidad.

Freelance Castro Solutions Creatividad Tolerancia al riesgo Consistencia > talento +1
Ver detalles
The four cells of the harness A 2×2 matrix. Rows are Feedforward (before the step) and Feedback (after the step). Columns are Computational (the code decides) and Inferential (the model decides). Each cell carries a combined label in bold and a spoken motto in italics at the bottom: guides · deterministic "this is always done this way", guides · semantic "think about it this way", sensors · deterministic "this is broken — look here", sensors · semantic "this smells off — are you sure?". Each cell also lists concrete instances in monospace. The four cells of the harness Computational Inferential Feedforward Feedback guides · deterministic PreToolUse hooks allowed-tools per agent permission allowlists schema · scope guards "this is always done this way" guides · semantic CLAUDE.md · project rules ADRs · decision records skills · agent frontmatter specs (OpenSpec, etc.) "think about it this way" sensors · deterministic build & tests type-check · lint PostToolUse hooks spec validate "this is broken — look here" sensors · semantic adversarial review reviewer subagent structured diagnostics lesson capture "this smells off — are you sure?"

Cómo llevo agentes hoy · hooks, specs, subagentes

Harness Engineering: el código que rodea al agente

Un LLM es no-determinista, así que las reglas críticas tienen que vivir fuera del agente, en código que el agente no puede reescribir.

Claude Code Hooks (PreToolUse / PostToolUse) Subagentes OpenSpec Skills +2
Ver detalles