smtp-relay/.metodo/workflows/sesion-exploracion.md
sirxavor 63fa2d68ba chore(metodo): llegan los 3 nucleos de sesion (orquestadora, ejecucion, exploracion)
El metodo de las sesiones deja de estar repartido por frentes: cada nucleo es
la UNION de lo que cada uno aprendio. Los apendices de proyecto NO viajan.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-30 13:52:33 +02:00

111 lines
6.4 KiB
Markdown

# Workflow: sesión de EXPLORACIÓN — núcleo
<!-- metodo:puntero -->
**Antes de tocar nada, lee el Método: [`repos/metodo/metodo.md`](../metodo.md)** — los
raíles transversales, completos y con sus cicatrices. Si trabajas **dentro de un repo**, la copia que
te toca es la suya (`.metodo/metodo.md`), que va sellada y la mide `metodo check`.
⇒ Y **`§7`**: al arrancar se leen `AVISOS.md`, `decisiones.md` y `backlog.md`; **la bitácora NO**, se
consulta por su índice. Arrancar cuesta ~400 k tokens en un frente maduro y **la bitácora es el 79 %**.
*Este bloque existe porque el 2026-08-29 se midió que **7 de los 9 workflows del árbol no llevaban
al Método**, incluidos los dos más usados. Una constitución sólo gobierna si algo lleva a ella: es su
propio raíl `§8` —* ***un aviso que nadie lee no es un mecanismo de contención.***
<!-- /metodo:puntero -->
> **Esto es el NÚCLEO: el método de mirar sin tocar, sin el frente.** Viaja a cada repo con
> `.metodo/`. Qué se mira, con qué herramienta y por dónde se entra vive en su **apéndice**, que
> **no viaja**: se lee sobre este núcleo, no en su lugar.
Para tareas de **lectura, medida y diagnóstico**: inventariar, leer, comparar, aislar una causa —
**sin aplicar ningún cambio real**. Si la tarea sí implica cambiar algo, la que toca es la de
**ejecución** (`sesion-ejecucion.md`), que tiene las salvaguardas que ésta no necesita.
**Solo-lectura no es "portarse bien": es una propiedad que hay que poder demostrar.** Todo lo de
esta fase es reversible **por definición**, y por eso se puede iterar sin pedir permiso en cada
paso — pero en el momento en que algo module estado, aunque sea "para confirmar la hipótesis", ya
**no** es esta sesión (`§12` del Método).
## Cuándo se usa
Cuando la tarea consiste en inventariar, leer, comparar o diagnosticar, y **nunca** en modificar
configuración real. El disparador concreto de cada frente está en su apéndice.
## Qué debe llevar el prompt
1. **Punto de partida obligatorio**: qué leer antes de nada — el `CLAUDE.md` del sitio y el corpus
del frente (`doc/AVISOS.md` **primero**, `doc/decisiones.md`, `doc/backlog.md`), más el
documento de arquitectura o análisis que aplique.
2. **La tarea exacta, copiada literalmente** de donde viva (sección y checkboxes). *«Literalmente»
cierra la puerta a que el prompt parafrasee la tarea, que es de donde salen las premisas
rancias.*
3.**Criterios de validación**: si la fuente no los enumera, **cada sub-checkbox de la sección es
por defecto un criterio**. Es lo que convierte un encargo en algo **evaluable** — sin esto, "he
mirado" y "está comprobado" son indistinguibles.
4.**El encargo negativo, ENUMERANDO LOS VERBOS PROHIBIDOS** — no un genérico «no cambies nada».
Se listan los gestos concretos que en ese frente sí modificarían estado *(instalar, aprobar,
inicializar, aplicar, reiniciar, tocar el firewall…)*, porque un «no cambies nada» abstracto
deja a la sesión decidiendo qué cuenta como cambio. La **forma** es del núcleo; **la lista la
pone el apéndice**.
⇒ Y con su cierre: si detecta algo mejorable, **lo documenta como hallazgo o recomendación, no
lo aplica**.
## Qué hace la sesión
1. Lee lo que el encargo manda leer, **en ese orden**.
2. Explora y mide lo necesario — puede conectarse a lo que haga falta **solo para leer**, nunca
para configurar.
3. **Documenta los hallazgos** donde su frente documente, con el mismo formato que lo que ya hay
ahí (úsalo de plantilla). ⚠️ **No crea documento aparte** salvo que el hallazgo sea **sustancial
y merezca su propio archivo** — un documento nuevo por cada exploración es ruido, no corpus.
4. ⭐ **Evalúa honestamente, contra los criterios, si la tarea está completa, parcial o
bloqueada.** No "ha ido bien": contra los criterios, uno a uno.
5. **Actualiza el backlog**: marca cada checkbox (`[x]` **solo si se verificó de verdad**, `[~]` si
quedó parcial, `[ ]` con el motivo si no se pudo) y enlaza lo que haya escrito.
6.**Si algo descubierto contradice una decisión escrita** —una arquitectura, una `D` cerrada—,
**lo dice explícitamente** en el resumen final, y si la contradice de frente **PARA y reporta**
(`§6` del Método). Nada se actualiza solo.
7. ⛔ **Si lo explorado revela una tarea de configuración que convendría aplicar, la deja
PROPUESTA — no la ejecuta.** Esa propuesta es la semilla de una futura sesión de **ejecución**,
con su propio encargo.
⚠️ **Lo que este núcleo NO trae, y se dice en vez de disimularlo**: predicción, testigo y control
negativo. Ninguno de los workflows de los que sale lo tenía — toda su disciplina es de efectos
secundarios («qué no tocar», «para y pregunta»). Es un hueco **conocido y medido**, no un olvido, y
se cierra por núcleo cuando toque.
## Plantilla de prompt
*El esqueleto. El relleno —qué leer, qué se mira, con qué herramienta, qué verbos están
prohibidos— lo pone el apéndice del frente.*
```
Trabaja en <el sitio>.
Antes de nada, lee:
- <el CLAUDE.md que aplique>
- <doc/AVISOS.md del frente — PRIMERO>, <doc/decisiones.md>, <doc/backlog.md sección "<exacta>">
- <el documento de arquitectura/análisis que aplique>
Tarea a ejecutar (es de EXPLORACIÓN/LECTURA, no de configuración):
<pegar aquí el bloque exacto, copiado literalmente>
Criterios de validación:
<enumerarlos; si no los hay, cada sub-checkbox de la sección es un criterio>
Haz lo siguiente:
1. Explora/mide lo necesario para cubrir cada punto. NO <lista de verbos prohibidos del
frente: instalar, aprobar, inicializar, aplicar, reiniciar, tocar el firewall...> — aunque
detectes algo mejorable, documéntalo como recomendación, no lo apliques.
2. Documenta lo encontrado en <dónde>, siguiendo el formato de lo que ya hay ahí. No crees un
documento aparte salvo que el hallazgo lo merezca.
3. Vuelve a <el backlog> y marca cada checkbox: [x] solo si lo verificaste de verdad, [~] si
quedó parcial, [ ] anotando el motivo. Enlaza lo que hayas escrito.
4. Evalúa contra los criterios si la tarea queda completa, parcial o bloqueada — y dilo.
5. Si algo contradice una decisión escrita, dilo explícitamente; si la contradice de frente,
PARA y repórtamelo.
6. Si descubres una tarea de configuración que convendría aplicar, DÉJALA PROPUESTA. No la
ejecutes.
Al terminar, dame un resumen breve de qué se confirmó, qué se descartó, qué quedó propuesto y
qué quedó pendiente.
```