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
Apostar por ti es la mejor inversión que puedes hacer

Reflexión · Por qué decidí hacerme freelance

Apostar por ti es la mejor inversión que puedes hacer

Tener solo fe de que las cosas saldrán bien no es una estrategia.

Autoempleo Interés compuesto Conocimiento transversal La esperanza no es estrategia Evidencia > narrativa +3
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