# Prompts de código que funcionan (debug, refactor, tests)

> Cómo dejar de recibir respuestas genéricas: forzá diff, restricciones y checklist de tests.

Fuente: Promptea — https://www.promptea.me/es/guides/code-prompts-that-work · Idioma: Español · Última actualización: 2026-11-09

## Hacelo concreto

- Pegá el snippet mínimo reproducible + expected vs actual.
- Exigí estructura de salida (pasos, diff, checklist).
- Incluí restricciones (stack/versiones).
- Pedí casos límite + tests.

## Antes → después: un pedido de depuración

- Antes: "Mi función no anda, arreglala." El modelo tiene que adivinar el lenguaje, el síntoma y qué significa 'anda', así que reescribe la función en términos generales.
- Después: "Bug: el total da uno de menos cuando la lista tiene un solo elemento. Entorno: Node 20, TypeScript 5. Esperado: 10. Actual: 9. Reproducción mínima abajo. Devolvé la causa, el arreglo como diff y un test que falle antes y pase después."
- Qué cambió: están dichos el síntoma, el entorno, esperado versus actual, una reproducción mínima y el entregable exacto.

## Revisá la respuesta antes de confiar en ella

- Corré el código y los tests que propone. Una explicación segura de sí misma no prueba que el arreglo funcione.
- Pedí un diff o solo las partes cambiadas, para revisar un cambio chico en vez de un archivo reescrito.
- Cambiá una cosa por pedido. Si pedís un refactor, una función nueva y un arreglo juntos, no podés saber qué cambio rompió qué.
- Preguntale de qué no está seguro ('listá los supuestos que hiciste'): de los supuestos salen los arreglos equivocados.

## Plantillas

### Refactor con invariantes

```text
Refactorizá este código manteniendo el comportamiento idéntico.

Restricciones:
- No cambies la API pública.
- Mantené complejidad <= a la actual.
- Preferí funciones chicas + nombres claros.

Código:
"""[pegá]"""

Devolvé:
1) rationale breve
2) diff/snippet (solo partes cambiadas)
3) checklist de tests (qué cubrir)
```

[Abrir en Promptea](https://www.promptea.me/es/analyzer?prompt=Refactoriz%C3%A1+este+c%C3%B3digo+manteniendo+el+comportamiento+id%C3%A9ntico.%0A%0ARestricciones%3A%0A-+No+cambies+la+API+p%C3%BAblica.%0A-+Manten%C3%A9+complejidad+%3C%3D+a+la+actual.%0A-+Prefer%C3%AD+funciones+chicas+%2B+nombres+claros.%0A%0AC%C3%B3digo%3A%0A%22%22%22%5Bpeg%C3%A1%5D%22%22%22%0A%0ADevolv%C3%A9%3A%0A1%29+rationale+breve%0A2%29+diff%2Fsnippet+%28solo+partes+cambiadas%29%0A3%29+checklist+de+tests+%28qu%C3%A9+cubrir%29&purpose=code&target=claude)

### Depurar con esperado vs actual

```text
Bug: [descripción en una línea]
Entorno: [lenguaje, runtime, versiones del framework]
Esperado: [qué debería pasar]
Actual: [qué pasa; pegá el error o el stack trace]

Reproducción mínima:
"""[código]"""

Devolvé:
1) la causa más probable, en dos oraciones
2) el arreglo mínimo como diff (solo líneas cambiadas)
3) un test que falle antes del arreglo y pase después
4) los supuestos que hiciste, para que yo los revise
```

[Abrir en Promptea](https://www.promptea.me/es/analyzer?prompt=Bug%3A+%5Bdescripci%C3%B3n+en+una+l%C3%ADnea%5D%0AEntorno%3A+%5Blenguaje%2C+runtime%2C+versiones+del+framework%5D%0AEsperado%3A+%5Bqu%C3%A9+deber%C3%ADa+pasar%5D%0AActual%3A+%5Bqu%C3%A9+pasa%3B+peg%C3%A1+el+error+o+el+stack+trace%5D%0A%0AReproducci%C3%B3n+m%C3%ADnima%3A%0A%22%22%22%5Bc%C3%B3digo%5D%22%22%22%0A%0ADevolv%C3%A9%3A%0A1%29+la+causa+m%C3%A1s+probable%2C+en+dos+oraciones%0A2%29+el+arreglo+m%C3%ADnimo+como+diff+%28solo+l%C3%ADneas+cambiadas%29%0A3%29+un+test+que+falle+antes+del+arreglo+y+pase+despu%C3%A9s%0A4%29+los+supuestos+que+hiciste%2C+para+que+yo+los+revise&purpose=code&target=claude)

## Preguntas frecuentes

### ¿Cómo logro un diff real?

Pedí 'solo partes cambiadas' y especificá contexto de archivo. Si podés, incluí nombres de archivos.

### ¿Conviene pegar el archivo completo?

Pegá el fragmento más chico que reproduce el problema más las firmas de las que depende. Un archivo entero agrega ruido y puede sacar de foco las líneas relevantes.

### ¿Cómo evito que reescriba todo?

Declará los invariantes ('no cambies la API pública') y pedí el diff mínimo. Decirle qué debe quedar igual funciona mejor que pedirle que 'tenga cuidado'.