▸ matriz_de_prompts

El mismo objetivo, tres niveles de prompt.

Elige un modelo y un nivel. Verás la anatomía del prompt coloreada por partes, por qué funciona y qué resultado esperar. Cópialo y úsalo hoy.

Arquitectura de software, código limpio, refactorización y agentes en terminal.

Leyenda

  • Rol
  • Tarea
  • Formato
▸ claude.nivel_1.prompt · Refactorizar una función desordenada
Eres un programador senior de Python.Refactoriza esta función para que sea más legible y añade type hints:

def calc(l):
    t=0
    for i in l:
        if i['activo']==True: t=t+i['precio']*i['cant']
    return tDevuelve solo el código y una línea explicando el cambio principal.
<xml> estructura{{variable}} lo rellenas túregla negativa lo que no debe hacer

Playground de variables

Este nivel no usa variables: es un prompt cerrado. Los niveles 2 y 3 sí las tienen.

Por qué funciona

Instrucción directa de una sola capa. Ideal para tareas rápidas de menos de 30 segundos donde no necesitas formato estricto.

[Rol simple] + [Tarea directa] + [Formato de salida básico]

Resultado esperado

def total_activos(items: list[dict]) -> float:
    return sum(i["precio"] * i["cant"] for i in items if i["activo"])

# Cambio principal: bucle sustituido por sum() con generador y nombres descriptivos.

Falla cuando…

  • Si el código depende de otros archivos, inventa nombres de funciones que no existen.
  • No sabe tus convenciones (dataclasses, Pydantic, estilo de errores).
  • En refactors grandes cambia comportamiento sin avisar porque nadie le pidió conservarlo.

→ Perfecto para fragmentos aislados. En cuanto el código vive dentro de un proyecto, necesitas contexto y reglas.

comparativa · Claude (Sonnet / Opus) · Claude Code

Output Nivel 1 vs Output Nivel 3

✗ NIVEL 1 · Operador Básico3 bloques

Refactorizar una función desordenada

def total_activos(items: list[dict]) -> float:
    return sum(i["precio"] * i["cant"] for i in items if i["activo"])

# Cambio principal: bucle sustituido por sum() con generador y nombres descriptivos.

Se rompe cuando: Si el código depende de otros archivos, inventa nombres de funciones que no existen.

✓ NIVEL 3 · Arquitecto de Sistemas5 bloques

Agente de refactor para Claude Code / CI

{
  "status": "ok",
  "patch": "--- a/app/totales.py\n+++ b/app/totales.py\n@@ -1,5 +1,3 @@ ...",
  "changes": [{"line": 1, "reason": "Tipado y Decimal"}],
  "risk": "low"
}

Un prompt agéntico es un contrato: entra un archivo, sale un JSON que otra máquina entiende. Así se automatiza de verdad.