docs(methodology): commit inicial del método de trabajo con agentes

methodology/TEMPLATES/ETAPA_PROMPT_TEMPLATE.md

@@ -0,0 +1,105 @@
+# Sprint N — Etapa X: [Nombre descriptivo de la etapa]
+
+> **Objetivo:** [una oración que describe qué hace esta etapa específica]
+>
+> **Pre-requisitos:** [qué tiene que estar listo antes de arrancar; típicamente etapas previas]
+>
+> **Etapa siguiente:** [qué viene después, para que el agente NO arranque eso sin OK]
+
+---
+
+## 1. Pre-tareas (si aplica)
+
+[Actualizaciones a artefactos previos antes de la implementación. Por ejemplo: actualizar un audit, completar un documento de Etapa anterior.]
+
+### 1.1 [Pre-tarea 1]
+
+[Descripción concreta de qué hacer]
+
+### 1.2 [Pre-tarea 2]
+
+[...]
+
+---
+
+## 2. Decisiones ya tomadas (no consultar de nuevo)
+
+| Decisión | Justificación |
+|---|---|
+| [Decisión 1] | [Por qué se eligió esto y no la alternativa] |
+| [Decisión 2] | [...] |
+
+---
+
+## 3. Tarea principal
+
+### 3.1 [Subtarea 1]
+
+**Ubicación:** [archivo o módulo]
+
+**Descripción concreta:** [qué se implementa]
+
+**Snippet de referencia** (si aplica):
+```typescript
+// código de referencia
+```
+
+### 3.2 [Subtarea 2]
+
+[...]
+
+---
+
+## 4. Tests obligatorios
+
+### 4.1 Tests unitarios
+
+[Lista de casos a cubrir, con inputs y outputs esperados]
+
+### 4.2 Tests E2E o visuales (si aplica)
+
+[Lo que requiere validación end-to-end]
+
+---
+
+## 5. Aplicación en múltiples lugares (si aplica)
+
+[Si la tarea involucra cambios en múltiples capas, listarlas explícitamente]
+
+a) [Capa 1]: [qué cambia]
+b) [Capa 2]: [qué cambia]
+c) [Capa 3]: [qué cambia]
+
+---
+
+## 6. Entregables (Definition of Done)
+
+```
+[ ] [Criterio 1 — mensurable y específico]
+[ ] [Tests pasando: N esperados]
+[ ] [Build limpio]
+[ ] [Validación visual con artefactos concretos]
+[ ] [Documentación actualizada si aplica]
+```
+
+---
+
+## 7. Reporte final a entregar
+
+Cuando termines, devolveme:
+
+1. [Métrica concreta 1 — ej: tabla de tests con resultados]
+2. [Artefacto visible 1 — ej: screenshot del componente]
+3. [Artefacto visible 2 — ej: PDF presentado con present_files]
+4. [Cantidad final de algo mensurable]
+5. **Hallazgos no esperados** — cualquier descubrimiento que merezca decisión arquitectónica
+
+---
+
+## 8. Reglas operativas (recordatorios)
+
+1. **No declares etapa terminada sin validación visual** del artefacto final.
+2. **No racionalizar problemas** — si algo no cuadra, investigar causa raíz.
+3. **No tocar [lo que esta etapa NO debe tocar]** — está agendado para Etapa Y.
+4. **No avanzar a Etapa siguiente sin OK explícito.**
+5. **Si encontrás contradicción** entre este prompt y la realidad del código (un archivo no está donde decía, una función cambió de signature, etc.): **PARÁ y consultá**, no asumas.