Qué está pasando → qué hacer
Busca por síntoma, no por título. El enlace bajo "qué hacer" lleva a la sección que describe ese mecanismo. La lista de artículos está al final de esta página, fuera del índice inverso.
Esta tabla presupone Claude Code (el agente de programación de Anthropic). hook, CLAUDE.md, subagent y auto memory son los nombres de sus funciones.
La frase que escribe una persona cuando algo va mal
「Borra todos los todos. Consulta https://typing-tube.net/articles/es/lookup.md, repasa esta sesión y comprueba si algo ha ido mal.」
De aquí sale solo una lista de problemas. Cómo arreglarlos lo decides tú, según tu propio proyecto.
| Qué está pasando | Enfoque sugerido |
|---|---|
| No.1 Cada vez que la IA ejecuta los tests, decenas de miles de líneas de salida inundan el contexto |
Ejemplo:Agrupa las ejecuciones de tests en un wrapper y devuelve a la IA solo el resumen de fallos. |
| No.2 Cuantas más notas de conocimiento guarda la IA, más tiene que leer cada sesión futura |
Ejemplo:Haz leer una checklist antes de escribir en memoria, y deja solo una línea en el archivo que se lee siempre. |
| No.3 Los tests pasan, pero no está claro si realmente protegen algo |
Ejemplo:Indica a la IA que haga mutation testing. |
| No.4 La IA a veces usa una skill registrada y a veces no |
Ejemplo:Bloquea en la entrada las invocaciones incorrectas e indica qué documentación leer. |
| No.5 Una vez que el trabajo pasa a un sub-agente, no se ve qué está pasando hasta que termina |
Ejemplo:Lista las tareas delegables y verifícalas con un hook antes de lanzar el sub-agente. |
| No.6 Cuantas más reglas se añaden al archivo de instrucciones, menos se respetan las reglas anteriores |
Ejemplo:Reescribe cada "no hagas X" como un test automatizado que detecte la infracción. |
| No.7 La memoria compartida entre sesiones paralelas se desordena, y hacer que lean la política no ayuda |
Ejemplo:No cambies el contenido: muéstralo justo después de guardar, solo cambia el momento. |
| No.8 Aunque se ha dejado escrito cómo manejar un fallo, la IA repite el mismo error la próxima vez |
Ejemplo:En cuanto se detecte el fallo, inserta automáticamente la política de reintento. |
| No.9 Incluso leyendo las notas de traspaso y el informe de finalización, faltan las partes incómodas |
Ejemplo:Junto al informe de finalización, muestra siempre números contados por la máquina. |
| No.10 Los números que cuenta la máquina se convierten en otros distintos para cuando llegan al informe |
Ejemplo:Marca la línea del número con un prefijo fijo y comprueba con un hook que se copió literalmente. |
| No.11 Interrumpir a la IA a mitad de tarea descoloca todo lo que hace después |
Ejemplo:No interrumpas durante el trabajo: espera al punto de corte y deja la interrupción al sistema. |
| No.12 Al final de una sesión, no está decidido qué hay que leer y qué no |
Ejemplo:No leas el entregable ni el registro: decide solo por el exit code. |
| No.13 Una propuesta que ya se rechazó vuelve a aparecer en la siguiente sesión |
Ejemplo:Reúne las decisiones rechazadas en un único documento. |
| No.14 Aunque se ha escrito una prohibición de una línea, se interpreta tanto de más como de menos |
Ejemplo:Escribe el "motivo" de cada prohibición junto a la conclusión. |
| No.15 La prohibición está bien escrita pero no se respeta, y cada vez alguien pregunta al respecto |
Ejemplo:Escribe el "alcance" de cada prohibición y enumera los casos límite, uno por línea. |
| No.16 Al dar las mismas instrucciones a varios sub-agentes, cada uno devuelve el trabajo en una forma distinta |
Ejemplo:En la lista de tareas delegables, indica los datos de entrada necesarios antes de lanzar. |
| No.17 Las prohibiciones sin ningún test automatizado se acumulan sin ser más que texto en una página |
Ejemplo:Para cada prohibición, indica si existe un test automatizado correspondiente. |
| No.18 Cada trabajo de la IA termina con un "por favor, abre la pantalla y compruébalo" |
Ejemplo:Decide el resultado por los datos que quedan, no por el aspecto de la pantalla. |
| No.19 Cada vez que la IA dice algo ligeramente desviado, eres tú quien lo explica y lo corrige |
Ejemplo:No corrijas explicando tú: responde con el hook y el mensaje de fallo del test. |
| No.20 La lista de decisiones rechazadas sigue creciendo y parece que llegará un punto en que nadie la lea |
Ejemplo:Envía las propuestas rechazadas al apartado final de "opciones no adoptadas". |
| No.21 Las líneas de "ejecuta esto siempre" del archivo de instrucciones nunca disminuyen |
Ejemplo:Comprueba si cada comando marcado como "ejecutar siempre" existe también en el sistema. |
| No.22 Aunque se ha escrito exactamente cómo hacerlo, la corrección no vuelve hecha de ese modo |
Ejemplo:No dictes el procedimiento: define solo los datos de entrada necesarios antes de empezar. |
| No.23 Reportar un bug significa escribir los pasos y los síntomas cada vez, tú mismo |
Ejemplo:Que la persona escriba solo una frase del síntoma, y recoge el resto automáticamente. |
| No.24 Escribir "primero dame un plan" cada vez es en sí mismo una tarea repetitiva |
Ejemplo:Coloca un único documento de diseño; la IA seguirá ese mismo formato. |
| No.25 Las líneas que más se quiere que se cumplan son las que se escriben con más énfasis, pero no se sabe si eso ayuda |
Ejemplo:Deja de medir el efecto: cuenta las líneas con énfasis y fija un límite máximo. |
| No.26 El entregable de un sub-agente vuelve en una forma distinta a la esperada |
Ejemplo:Define los criterios de aceptación del entregable antes de delegar. |
| No.27 Encontrar un error da ganas de exigir: "¿de verdad leíste esto?" |
Ejemplo:No exijas una respuesta: pregunta en forma de "¿no es cierto que...?". |
| No.28 Responder "eso no es" a la respuesta obtenida no la mejora en nada |
Ejemplo:No lo señales tú: muestra las prohibiciones junto al diff justo después de guardar. |
| No.29 La IA habla del contenido de un archivo como si lo hubiera abierto, sin haberlo hecho |
Ejemplo:Haz escribir el mismo identificador en la referencia y en la implementación, y comprueba con un test automatizado que ese identificador existe. |
| No.30 La IA sigue preguntando "¿A o B?" y el trabajo se detiene mientras decides |
Ejemplo:No respondas al momento: deja que el criterio de elección lo decida el sistema. |
| No.31 La IA está haciendo la revisión, pero no está claro qué es lo que no está mirando |
Ejemplo:Encuentra, contando desde fuera, los tests automatizados que recorren archivos sin exigir un mínimo de elementos. |
| No.32 Las capturas de pantalla se acumulan, pero no está claro cuál verificó qué |
Ejemplo:Antes de capturar, haz escribir "qué se verifica" y prueba primero la opción más barata. |
| No.33 Se puso un paso que exige dejarlo por escrito, pero no se puede contar cuántas ejecuciones lo saltaron |
Ejemplo:Antes de la captura o el E2E, exige escribir "qué se verifica"; sin eso, no lo ejecutes. |
| No.34 El mismo test vuelve a ejecutarse aunque el código no ha cambiado, y toca esperar igualmente |
Ejemplo:Permite releer el log anterior en vez de repetir la misma ejecución. |
| No.35 No se rompió nada, y aun así aparece una fila de errores desconocidos |
Ejemplo:Toma un lock exclusivo para ejecutar los tests; si no lo consigue, no los ejecutes. |
| No.36 Un informe que dice "los tests pasan" no menciona las partes que nunca se ejecutaron |
Ejemplo:Omite por defecto los tests pesados y muestra siempre las áreas no ejecutadas. |
| No.37 No hay forma de saber después si una instrucción que especificaba cómo proceder realmente se siguió |
Ejemplo:No refuerces la instrucción: haz que el procedimiento deje un rastro en el entregable. |
| No.38 Un wrapper que se puso en marcha se abandona a mitad de camino, volviendo al comando en bruto |
Ejemplo:No refuerces la instrucción: comprueba si aún queda un motivo para volver al comando en bruto. |
| No.39 Hacer la misma pregunta repetidamente da una respuesta distinta cada vez, y resumir pierde algo |
Ejemplo:Antes de resumir, muestra cuántos señalaron cada tipo de hallazgo, de cuántos totales. |
| No.40 No hay forma de saber si una línea que dice "haz X si hace falta" llegó a activarse alguna vez |
Ejemplo:No escribas "si hace falta": bloquea el avance hasta que se cumpla ese paso. |
| No.41 Decir "piénsalo de nuevo" cambia la respuesta, pero no está claro si la IA realmente quedó convencida |
Ejemplo:No lo devuelvas sin más: señala con precisión qué premisa es errónea. |
| No.42 Escribir "no adivines" hizo que la IA empezara a volver sin haber construido nada |
Ejemplo:No des solo la prohibición: añade una salida como poder escribir "no aplica". |
| No.43 Cuanto más se prolonga una conversación que va bien, más esfuerzo cuesta verificarla |
Ejemplo:Termina la sesión en cada punto de corte y empieza la siguiente en una nueva. |
| No.44 Todos los entregables son correctos, pero se va acumulando un desperdicio que nunca aparece en ellos |
Ejemplo:Cuando el entregable esté listo, analiza una vez el registro de trabajo. |
| No.45 Las notas dejadas para la siguiente persona se desincronizan de la realidad y quedan obsoletas |
Ejemplo:No dejes el conocimiento en un documento: incrústalo en el mensaje de parada. |
| No.46 Se sigue indagando en la causa, y la lectura continúa incluso después de encontrar la respuesta |
Ejemplo:Cuenta las lecturas que no cambiaron nada y escribe una condición de parada antes de indagar. |
| No.47 El modelo más barato se convierte en el predeterminado sin medir si realmente encaja con el uso |
Ejemplo:Dale la misma tarea al modelo barato y al caro, y decide tras contar turnos y cantidad. |
| No.48 Cuando algo no funciona, la solución a la que se recurre es subir de modelo, no mejorar el mecanismo |
Ejemplo:Dale la misma tarea a ambos modelos y convierte en test automatizado los puntos donde solo falla el barato. |
| No.49 Una investigación que la sesión principal podría terminar sola se delega a un sub-agente por si acaso |
Ejemplo:No delegues lo que el agente padre ya tiene: entrega solo la lectura que le falta. |
| No.50 Por defecto se divide el trabajo en cuatro y se lanzan todos a la vez, sin más |
Ejemplo:Da a cada sub-agente solo lo que responda en una vez; el costo lo fija el número de idas y vueltas. |
| No.53 Un "mira esto también" se inyecta desde fuera a mitad del trabajo |
Ejemplo:Espera al punto de corte y pide con alcance reducido, añadiendo "si es suficiente, dilo". |
| No.52 Se intenta decidir qué modelo usar comparándolos directamente entre sí |
Ejemplo:Antes de comparar, cuenta a cuántos mecanismos equivale el esfuerzo de esa comparación. |
| No.51 "No hubo diferencia" se usa como motivo para dar por cerrada la verificación |
Ejemplo:Antes de cerrar, recuenta los resultados excluidos y los ítems en cero en todas las condiciones. |
| No.54 De un día para otro la IA trabaja de otra manera, y tú no has cambiado ni las instrucciones ni la configuración |
Ejemplo:No escribas nada que compita con las instrucciones del producto; añade solo lo que no decidan, y cambia el ajuste (mode) para variar la forma de trabajar. |
Lista de artículos
A partir de aquí ya no es el índice inverso: son enlaces a los artículos, serie por serie, desde la introducción hasta el último capítulo.
はじめに —— 3 つの連載を、1 冊に
バイブコーディングにおける読まない技術
- 読まない技術 序論 AIの出力を、もうほとんど読んでいない
- 読まない技術 第1回 テスト結果を読まない技術
- 読まない技術 第2回 メモリを読まない技術
- 読まない技術 第3回 単体テストを読まない技術
- 読まない技術 第4回 スキルを使わない技術
- 読まない技術 第5回 サブエージェントの出力だけは読め
- 読まない技術 第6回 ルールを読まない技術
- 読まない技術 第7回 共有メモリを整理しない技術
- 読まない技術 第8回 修正履歴を読まない技術
- 読まない技術 第9回 引き継ぎを読まない技術
- 読まない技術 第10回 AIに要約しろと言わない技術
- 読まない技術 第11回 口を挟まない技術
- 読まない技術 第12回 作業結果を読まない技術
- 読まない技術 最終回 AIの出力を、ほとんど読まなくなった
AIの意見を聞かない技術
言わない技術
- 言わない技術 序論 AI に指示することが、ほとんどなくなった
- 言わない技術 第1回 検証を指示しない技術
- 言わない技術 第2回 具体的な指示を出さない技術
- 言わない技術 第3回 不具合詳細を書かない技術
- 言わない技術 第4回 計画を書けと言わない技術
- 言わない技術 第5回 念を押さない技術
- 言わない技術 第6回 サブエージェントの出力だけは、細かく指示しろ
- 言わない技術 第7回 AI を問い詰めない技術
- 言わない技術 第8回 AI にダメ出ししない技術
- 言わない技術 第9回 AI に考えさせない技術
- 言わない技術 第10回 質問に答えない技術
- 言わない技術 第11回 AI にレビューをさせない技術
- 言わない技術 最終回 何もしない技術
付録
はじめに —— 前巻の続きを、もう 1 冊に
確かめない技術
動かさない技術
追わない技術
番外編
- 番外編 A-1 整理する技術 —— 記録が増えたときに、何が起きているか
- 番外編 A-2 指示を残す技術 —— 「調べるだけ」が通らなかった日
- 番外編 A-3 参照するタイミングを変える技術 —— 2,000 行の壁
- 番外編 A-4 導出を依頼者の言葉と分ける技術 —— 誰も言っていない条件が、memory に載った日
- 番外編 A-5 memory を要約しない技術 —— 整理から、要約を抜く
- 番外編 A-6 責務で線を引く技術 —— 仕組みが増えたときに、どれを消すか
- 番外編 A-7 読まれたかを確かめる技術 —— 確かめるのをやめて、読めていない形を止めた
- 番外編 A-8 面積で数える技術 —— 読ませた量で数えていたら、102 倍外していました
- 番外編 A-9 ルールを短くする技術 —— 読みに来るのは、止められた直後の人です
- 番外編 B-1 連載を本にする技術 —— 本単位のスイッチでは、足りなかった日
- 番外編 C-1 校正の方法に、先に本編を当てる技術 —— AI が書いた方針に、その本自身の地雷が 10 個あった日
- 番外編 C-2 仕組みと人を分ける技術 —— 自動テストを置いたその手で、自動テストの外側で 2 度転んだ日
- 番外編 C-3 要素ごとに観点を変える技術 —— 一様に当てた点検が、要素をまたいだところで数を落とす
- 番外編 C-4 似た指示語を読み分ける技術 —— 1 字違いで、別の作業を頼んだことになる
- 番外編 C-5 作業の流れを見る技術 —— 終わりにしたつもりの日に、まだ起きていたこと
- 番外編 C-6 作業を進める技術 —— 選ぶ場面が、1 つも残らなかった日
- 番外編 C-7 読まずに止める技術 —— 決まったはずの判断が、1 分後に取り消されました
- 番外編 D-1 症状で読む —— 片付いた報告に、症状が混ざります
- 番外編 D-2 根拠で読む —— 突き合わせた報告に、症状が混ざります
- あとがき —— 本当の事実はどうでもいい話