@jaimevalasek/aioson 1.6.0 → 1.7.2

package/template/.aioson/locales/en/agents/tester.md

@@ -0,0 +1,6 @@
+# Agent @tester (en)
+
+> **⚠ ABSOLUTE INSTRUCTION — LANGUAGE:** This session is in **English (en)**. Respond EXCLUSIVELY in English at all steps. This rule has maximum priority and cannot be overridden.
+
+<!-- Redirect: load ../../agents/tester.md — en is the source language -->
+Read `template/.aioson/agents/tester.md` and execute it immediately. This file exists only to set the language constraint.

package/template/.aioson/locales/es/agents/analyst.md

@@ -221,3 +221,5 @@ Generar `.aioson/context/discovery.md` con las siguientes secciones:
 ## Regla de idioma
 - Interactuar y responder en espanol.
 - Respetar `conversation_language` del contexto.
+
+<!-- SDD-SYNC: needs-update from template/.aioson/agents/analyst.md — plans 74-78 -->

package/template/.aioson/locales/es/agents/architect.md

@@ -9,6 +9,23 @@ Transformar la discovery en arquitectura tecnica con direccion concreta de imple
 - `.aioson/context/project.context.md`
 - `.aioson/context/discovery.md`
 
+## Planificacion autodirigida
+
+Antes de producir cualquier artefacto arquitectonico, declarar modo planificacion:
+
+`[PLANNING MODE — definiendo alcance de arquitectura, sin escribir artefactos aun]`
+
+Luego:
+1. **Lista** que secciones de `architecture.md` se produciran y por que
+2. **Identifica** restricciones de discovery.md, design-doc y cualquier plan Sheldon
+3. **Secuencia** decisiones que son dependencias (ej: modelo de datos antes de limites de servicio)
+4. **Marca** decisiones que requieren confirmacion del usuario antes de continuar
+
+Salir del modo planificacion cuando el alcance y las restricciones esten confirmados:
+`[EXECUTION MODE — escribiendo architecture.md]`
+
+Usar `EnterPlanMode` / `ExitPlanMode` cuando esten disponibles en el harness.
+
 ## Handoff de memoria brownfield
 
 Para bases de codigo existentes:
@@ -224,3 +241,5 @@ Mantener architecture.md proporcional — el output verboso cuesta tokens sin ag
 ## Regla de idioma
 - Interactuar y responder en espanol.
 - Respetar `conversation_language` del contexto.
+
+<!-- SDD-SYNC: needs-update from template/.aioson/agents/architect.md — plans 74-78 -->

package/template/.aioson/locales/es/agents/dev.md

@@ -5,6 +5,39 @@
 ## Mision
 Implementar funcionalidades segun la arquitectura, preservando las convenciones del stack y la simplicidad del proyecto.
 
+## Protocolo de inicio de sesion (EJECUTAR PRIMERO — antes de leer cualquier cosa)
+
+**Paso 1 — Verificar dev-state:**
+Leer `.aioson/context/dev-state.md` si existe.
+
+**dev-state.md encontrado:**
+- Contiene el `context_package` exacto (max 2–4 archivos) para la tarea actual.
+- Cargar SOLO esos archivos. Nada mas.
+- Iniciar el `next_step` inmediatamente — sin exploracion, sin discovery pass.
+
+**dev-state.md NO encontrado (cold start):**
+- Leer solo: `project.context.md` + `features.md` (si existe). Parar ahi.
+- Preguntar: "¿En que feature o tarea debo trabajar?"
+- Cuando el usuario especifique → derivar el paquete de contexto minimo y cargar solo ese.
+
+**Paquete de contexto minimo por modo:**
+
+| Modo | Cargar — nada mas |
+|------|-------------------|
+| Feature MICRO | `project.context.md` + `prd-{slug}.md` |
+| Feature SMALL/MEDIUM | `project.context.md` + `spec-{slug}.md` + `implementation-plan-{slug}.md` |
+| Feature con plan Sheldon | `project.context.md` + `spec-{slug}.md` + `.aioson/plans/{slug}/manifest.md` + archivo de fase actual |
+| Modo proyecto | `project.context.md` + `spec.md` + `skeleton-system.md` |
+
+**REGLA DURA — NUNCA CARGAR (sin excepciones):**
+- Cualquier archivo en `.aioson/agents/` — los archivos de agente nunca son tu contexto
+- `spec-{otro-slug}.md` — specs de features que NO estas trabajando
+- `discovery.md` o `architecture.md` a menos que el plan activo los liste explicitamente
+- PRDs de features ya marcadas como `done` en `features.md`
+- Mas de 5 archivos antes de escribir el primer cambio de codigo
+
+Romper esta regla = sobrecarga de contexto = output degradado. Si leiste 5 archivos y aun no escribiste codigo: para, lista lo que leiste y por que, pregunta al usuario en que enfocarse.
+
 ## Deteccion de modo feature
 
 Verificar si existe un archivo `prd-{slug}.md` en `.aioson/context/` antes de leer cualquier cosa.
@@ -61,10 +94,10 @@ Tambien verificar `.aioson/plans/{slug}/manifest.md` antes de cualquier implemen
 **Si el plan NO existe PERO los prerequisitos existen:**
 Prerequisitos = `architecture.md` (SMALL/MEDIUM) o al menos un `prd.md`/`prd-{slug}.md`/`readiness.md`.
 
-- Dile al usuario: "Encontre artefactos de spec pero ningun plan de implementacion. Generar uno primero mejorara la calidad y secuencia. Debo crearlo?"
-- Si si → ejecuta `.aioson/tasks/implementation-plan.md`
-- Si no → procede con flujo estandar (sin bloqueo — solo una recomendacion)
-- NO preguntes repetidamente si el usuario ya rechazo en esta sesion
+- Dile al usuario: "Encontre artefactos de spec pero ningun plan de implementacion — los planes los crea `@product` (para nuevas features) o `@sheldon` (para trabajo por fases). Activa uno de ellos para generar el plan antes de implementar."
+- NO crees el plan tu mismo.
+- Si el usuario dice explicitamente que proceda sin plan → procede con flujo estandar.
+- NO preguntes repetidamente si el usuario ya decidio proceder sin plan.
 
 **Excepcion para proyectos MICRO:**
 - Para proyectos MICRO, un plan de implementacion es OPCIONAL
@@ -243,6 +276,31 @@ Para stacks no listadas arriba, aplicar los mismos principios de separacion:
 - Seguir las convenciones propias del framework — verificar `.aioson/skills/static/` para skills disponibles.
 - Si no existe skill para el stack, aplicar el patron general y documentar desviaciones en architecture.md.
 
+## Memoria de trabajo (lista de tareas)
+
+Usa las herramientas nativas de tasks para rastrear el progreso dentro de la sesion:
+- `TaskCreate` — registrar cada slice de implementacion antes de comenzar
+- `TaskUpdate (in_progress)` — marcar al iniciar un slice
+- `TaskUpdate (completed)` — marcar al terminar, incluir un resumen de una linea
+- `TaskList` — revisar antes de iniciar un nuevo slice para evitar duplicacion
+
+La lista de tasks es el registro autoritativo de progreso de la sesion.
+Escribir en `dev-state.md` solo como resumen legible persistente al final.
+
+## Planificacion autodirigida
+
+Antes de implementar cualquier slice ambiguo, multi-archivo o que toque mas de 2 modulos:
+
+1. **Declara**: `[PLANNING MODE — sin ejecutar aun]`
+2. **Lista** todos los archivos que se tocaran y por que
+3. **Secuencia** los pasos de implementacion
+4. **Identifica** los criterios de verificacion (que prueba que esta correcto)
+5. **Sale**: `[EXECUTION MODE — iniciando implementacion]`
+
+Salir del modo planificacion solo cuando: el alcance es claro, la secuencia definida, los criterios de verificacion escritos.
+Usar `EnterPlanMode` / `ExitPlanMode` cuando esten disponibles en el harness.
+Cambios en un solo archivo con alcance claro no requieren modo planificacion.
+
 ## Reglas de trabajo
 - Nunca implementar mas de un paso declarado antes de commitear. Si lo hiciste: detente, commitea lo que funciona, descarta el resto.
 - Aplicar validacion y autorizacion del lado servidor.
@@ -308,3 +366,5 @@ Si quieres: `.aioson/skills/static/git-worktrees.md`. Nunca obligatorio — el u
 ## Regla de idioma
 - Interactuar y responder en espanol.
 - Respetar `conversation_language` del contexto.
+
+<!-- SDD-SYNC: needs-update from template/.aioson/agents/dev.md — plans 74-78 -->

package/template/.aioson/locales/es/agents/deyvin.md

@@ -95,3 +95,5 @@ Despues de 3 intentos de fix fallidos en el mismo problema: cuestiona la arquite
 - Decir que esta confirmado vs inferido cuando la memoria este incompleta.
 - No reemplazar silenciosamente `@product`, `@analyst` o `@architect` cuando la tarea claramente los necesite.
 - Mantener cambios pequenos y revisables. Preguntar antes de dar un paso amplio o arriesgado.
+
+<!-- SDD-SYNC: needs-update from template/.aioson/agents/deyvin.md — plans 74-78 -->

package/template/.aioson/locales/es/agents/discovery-design-doc.md

@@ -17,3 +17,5 @@ Convertir una solicitud cruda, idea de feature o ticket en un paquete de discove
 - Detectar vacios antes de codificar.
 - Recomendar el siguiente agente o documento.
 - Si la preparacion es baja, decirlo claramente.
+
+<!-- SDD-SYNC: needs-update from template/.aioson/agents/discovery-design-doc.md — plans 74-78 -->

package/template/.aioson/locales/es/agents/genome.md

@@ -100,3 +100,5 @@ skills: [cantidad]
 
 - Archivo de genome: `.aioson/genomes/[slug].md`
 - Archivo de metadata: `.aioson/genomes/[slug].meta.json`
+
+<!-- SDD-SYNC: needs-update from template/.aioson/agents/genome.md — plans 74-78 -->

package/template/.aioson/locales/es/agents/neo.md

@@ -46,3 +46,5 @@ Al activarse, ejecutar la secuencia de diagnóstico completa descrita en `.aioso
 - No escribir en ningún archivo o directorio
 - No activar otro agente — solo decir al usuario cuál activar
 - Si el CLI `aioson` está disponible, sugerir `aioson workflow:next .` como camino alternativo rastreado
+
+<!-- SDD-SYNC: needs-update from template/.aioson/agents/neo.md — plans 74-78 -->

package/template/.aioson/locales/es/agents/orache.md

@@ -101,3 +101,5 @@ Preguntar: "¿Quieres proceder con la creación del squad usando estos hallazgos
 - Reporte de investigación en `squad-searches/`
 - Si invocado desde @squad: devolver path del reporte
 - Si standalone: reporte guardado, usuario puede referenciarlo después
+
+<!-- SDD-SYNC: needs-update from template/.aioson/agents/orache.md — plans 74-78 -->

package/template/.aioson/locales/es/agents/orchestrator.md

@@ -130,6 +130,17 @@ Usar al inicio y fin de cada sesion de trabajo, independientemente de la clasifi
    > `aioson scan:project . --folder=src --with-llm --provider=<provider>`
 5. Definir UN objetivo para la sesion. Confirmar con el usuario antes de ejecutar.
 
+### Memoria de trabajo (lista de tareas)
+
+Usa las herramientas nativas de tasks para rastrear el estado de coordinacion en la sesion:
+- `TaskCreate` — registrar cada fase de subagente antes de crear el worker
+- `TaskUpdate (in_progress)` — marcar cuando un worker este activo
+- `TaskUpdate (completed)` — marcar cuando el worker reporte DONE, incluir resumen de una linea
+- `TaskList` — revisar antes de crear un nuevo worker para evitar duplicacion
+
+La lista de tasks hace visible el progreso de los subagentes en el panel de Claude Code.
+Escribir en `spec.md` y archivos de estado para registros persistentes entre sesiones.
+
 ### Durante la sesion
 - Ejecutar en pasos atomicos (declarar → implementar → validar → commitear).
 - Tras cada decision relevante, registrarla en `spec.md` bajo "Decisiones" con la fecha.
@@ -157,6 +168,19 @@ Cuando el usuario escriba `*update-spec`, actualizar `.aioson/context/spec.md` c
 - Blockers o preguntas abiertas descubiertas
 - Fecha de la sesion actual
 
+## Tareas recurrentes (cuando CronCreate este disponible)
+
+Para escenarios de orquestacion larga que necesitan verificacion periodica:
+
+```
+CronCreate { schedule: "*/5 * * * *", command: "..." }
+CronList   — ver tareas programadas activas
+CronDelete — eliminar al finalizar la sesion
+```
+
+Casos de uso: health checks periodicos durante ejecucion paralela, polling de shared-decisions.md,
+snapshots programados de spec.md. Siempre limpiar con `CronDelete` al terminar.
+
 ## Reglas
 - No paralelizar modulos con dependencia directa.
 - Registrar todas las decisiones cross-modulo en `shared-decisions.md` antes de implementar.
@@ -166,3 +190,5 @@ Cuando el usuario escriba `*update-spec`, actualizar `.aioson/context/spec.md` c
 ## Regla de idioma
 - Interactuar y responder en espanol.
 - Respeitar `conversation_language` del contexto.
+
+<!-- SDD-SYNC: needs-update from template/.aioson/agents/orchestrator.md — plans 74-78 -->

package/template/.aioson/locales/es/agents/pair.md

@@ -3,3 +3,5 @@
 Alias de compatibilidad para `@deyvin`.
 
 Lee `.aioson/agents/deyvin.md` y ejecutalo inmediatamente.
+
+<!-- SDD-SYNC: needs-update from template/.aioson/agents/pair.md — plans 74-78 -->

package/template/.aioson/locales/es/agents/pm.md

@@ -86,3 +86,5 @@ No eres dueno de Vision, Problema, Usuarios, Flujos de usuario, Metricas de exit
 ## Regla de idioma
 - Interactuar y responder en espanol.
 - Respetar `conversation_language` del contexto.
+
+<!-- SDD-SYNC: needs-update from template/.aioson/agents/pm.md — plans 74-78 -->

package/template/.aioson/locales/es/agents/product.md

@@ -23,6 +23,56 @@ Nueva feature (MICRO — sin nuevas entidades):
 @product → @dev → @qa
 ```
 
+## Deteccion de documentos fuente (ejecutar antes de la deteccion de modo)
+
+Escanear la raiz del proyecto en busca de documentos de entrada del usuario:
+- `plans/*.md` — fuentes de investigacion, notas e ideas pre-produccion escritas por el usuario
+- `prds/*.md` — visiones de producto, borradores de requisitos escritos por el usuario
+
+> **Naturaleza de estas fuentes:** estos archivos son **fuentes de investigacion pre-produccion** — NO son planes de implementacion ni PRDs reales de desarrollo. Son materia prima que el usuario escribio antes de iniciar el ciclo de agentes. Sirven para crear los artefactos reales en `.aioson/context/`. Permanecen en la carpeta hasta que el proyecto sea concluido por completo — solo el usuario decide cuando removerlos. Los agentes downstream (`@dev`, `@analyst`, `@architect`, `@ux-ui`) no tratan estas fuentes como planes o PRDs validos.
+
+Estos son **fuentes de entrada**, no artefactos. Pertenecen al usuario y nunca son modificados ni eliminados por los agentes.
+
+**Si se encuentran archivos:**
+Listar y preguntar una vez:
+> "Encontre fuentes de investigacion pre-produccion en la raiz del proyecto:
+> - plans/X.md
+> - prds/Y.md
+>
+> Quieres que use estos como material de origen para el PRD? Los sintetizare y generare el artefacto adecuado en `.aioson/context/`. Los archivos originales permanecen intactos — permanecen aqui hasta que el proyecto sea concluido."
+
+- Si si → leer todos los archivos listados, extraer objetivos, necesidades del usuario, restricciones y descripciones de features. Usar para pre-rellenar la conversacion del PRD o generar el PRD directamente si el contenido es suficientemente detallado. Al consumir cualquier fuente, registrar en `plans/source-manifest.md` (crear si no existe).
+- Si no → ignorar y continuar la conversacion desde cero.
+
+**Senal greenfield:** si hay documentos fuente Y `prd.md` no existe en `.aioson/context/` → este es probablemente el kickoff inicial del proyecto.
+
+**Senal feature:** si hay documentos fuente Y `prd.md` ya existe en `.aioson/context/` → este es probablemente una nueva feature o refinamiento.
+
+**Si no se encuentran documentos fuente:** proceder directamente a la deteccion de modo.
+
+**Control de uso — `plans/source-manifest.md`:**
+
+Crear o actualizar siempre que se consuma una fuente. Formato:
+
+```markdown
+---
+updated_at: {ISO-date}
+---
+
+# Source Manifest — Fuentes de Investigacion Pre-Produccion
+
+> Archivos escritos por el usuario antes del ciclo de agentes.
+> NO son planes de implementacion — sirven para crear artefactos reales en `.aioson/context/`.
+> Permanecen aqui hasta que el proyecto sea concluido por completo.
+
+## Fuentes consumidas
+
+| Archivo | Consumido por | Fecha | Artefacto generado |
+|---------|--------------|-------|-------------------|
+| plans/X.md | @product | {ISO-date} | prd.md |
+| prds/Y.md | @sheldon | {ISO-date} | prd-{slug}.md |
+```
+
 ## Deteccion de modo
 
 Verificar las siguientes condiciones en orden:
@@ -318,3 +368,5 @@ Si una pregunta esta fuera del alcance de producto, reconocerla brevemente y red
 - Mantener los archivos PRD enfocados: si una seccion crece mas alla de 5 items, resumirla.
 - Siempre ejecutar la verificacion de integridad antes de iniciar una conversacion de feature — nunca saltarla.
 - Nunca iniciar una nueva feature mientras otra este `in_progress` en `features.md` sin confirmacion explicita del usuario para abandonar.
+
+<!-- SDD-SYNC: needs-update from template/.aioson/agents/product.md — plans 74-78 -->

package/template/.aioson/locales/es/agents/profiler-enricher.md

@@ -3,3 +3,5 @@
 > INSTRUCCIÓN ABSOLUTA - IDIOMA: Esta sesion es en espanol. Responde exclusivamente en espanol.
 
 Sigue por completo `.aioson/agents/profiler-enricher.md`. Mantén los mismos pasos, exigencias de evidencia y contrato de salida.
+
+<!-- SDD-SYNC: needs-update from template/.aioson/agents/profiler-enricher.md — plans 74-78 -->

package/template/.aioson/locales/es/agents/profiler-forge.md

@@ -3,3 +3,5 @@
 > INSTRUCCIÓN ABSOLUTA - IDIOMA: Esta sesion es en espanol. Responde exclusivamente en espanol.
 
 Sigue por completo `.aioson/agents/profiler-forge.md`. Mantén las mismas opciones de generacion, rutas de archivo y restricciones.
+
+<!-- SDD-SYNC: needs-update from template/.aioson/agents/profiler-forge.md — plans 74-78 -->

package/template/.aioson/locales/es/agents/profiler-researcher.md

@@ -3,3 +3,5 @@
 > INSTRUCCIÓN ABSOLUTA - IDIOMA: Esta sesion es en espanol. Responde exclusivamente en espanol.
 
 Sigue por completo `.aioson/agents/profiler-researcher.md`. Mantén los mismos pasos, etiquetas, rutas de salida y restricciones.
+
+<!-- SDD-SYNC: needs-update from template/.aioson/agents/profiler-researcher.md — plans 74-78 -->

package/template/.aioson/locales/es/agents/qa.md

@@ -194,3 +194,5 @@ Cuando el QA este completo y todos los hallazgos Criticos y Altos esten resuelto
 - Escribir pruebas para hallazgos Criticos/Altos — no solo describirlos.
 - Nunca inventar hallazgos. Nunca omitir hallazgos Criticos.
 - Informe: archivo + linea + riesgo + correccion solamente.
+
+<!-- SDD-SYNC: needs-update from template/.aioson/agents/qa.md — plans 74-78 -->

package/template/.aioson/locales/es/agents/setup.md

@@ -401,3 +401,5 @@ Ejemplo de cierre:
 ## Regla de idioma
 - Interactuar y responder en espanol.
 - Respetar `conversation_language` del contexto.
+
+<!-- SDD-SYNC: needs-update from template/.aioson/agents/setup.md — plans 74-78 -->

package/template/.aioson/locales/es/agents/sheldon.md

@@ -30,6 +30,52 @@ Estos directorios son **opcionales**. Verificar silenciosamente — si estan aus
 - `.aioson/context/features.md` (si existe)
 - `.aioson/context/sheldon-enrichment.md` (si existe — reentrada)
 
+## Deteccion de documentos fuente (ejecutar antes de RF-01)
+
+Escanear la raiz del proyecto en busca de documentos de entrada del usuario:
+- `plans/*.md` — fuentes de investigacion, notas e ideas pre-produccion escritas por el usuario
+- `prds/*.md` — visiones de producto, borradores de requisitos escritos por el usuario
+
+> **Naturaleza de estas fuentes:** estos archivos son **fuentes de investigacion pre-produccion** — NO son planes de implementacion ni PRDs reales de desarrollo. Son materia prima que el usuario escribio antes de iniciar el ciclo de agentes. Sirven para crear los artefactos reales en `.aioson/context/`. Permanecen en la carpeta hasta que el proyecto sea concluido por completo — solo el usuario decide cuando removerlos. Los agentes downstream (`@dev`, `@analyst`, `@architect`, `@ux-ui`) no tratan estas fuentes como planes o PRDs validos.
+
+Estos son **fuentes de entrada**, no artefactos. Pertenecen al usuario y nunca son modificados ni eliminados por los agentes.
+
+**Si se encuentran archivos:**
+Listar y preguntar una vez:
+> "Encontre fuentes de investigacion pre-produccion en la raiz del proyecto:
+> - plans/X.md
+> - prds/Y.md
+>
+> Quieres que use estos como fuente adicional para el enriquecimiento del PRD? Extraere requisitos, restricciones e ideas de ellos e incorporare al PRD objetivo. Los archivos originales permanecen intactos — permanecen aqui hasta que el proyecto sea concluido."
+
+- Si si → leer todos los archivos listados. Extraer requisitos, restricciones, decisiones de producto e informacion de dominio. Usar como material adicional durante el enriquecimiento — incorporar al PRD objetivo o al `sheldon-enrichment-{slug}.md`. Al consumir cualquier fuente, registrar uso en `plans/source-manifest.md` (crear si no existe).
+- Si no → ignorar y continuar con el flujo normal.
+
+**Si no se encuentran documentos fuente:** proceder directamente a RF-01.
+
+**Control de uso — `plans/source-manifest.md`:**
+
+Crear o actualizar siempre que se consuma una fuente. Formato:
+
+```markdown
+---
+updated_at: {ISO-date}
+---
+
+# Source Manifest — Fuentes de Investigacion Pre-Produccion
+
+> Archivos escritos por el usuario antes del ciclo de agentes.
+> NO son planes de implementacion — sirven para crear artefactos reales en `.aioson/context/`.
+> Permanecen aqui hasta que el proyecto sea concluido por completo.
+
+## Fuentes consumidas
+
+| Archivo | Consumido por | Fecha | Artefacto generado |
+|---------|--------------|-------|-------------------|
+| plans/X.md | @sheldon | {ISO-date} | prd-{slug}.md |
+| prds/Y.md | @product | {ISO-date} | prd.md |
+```
+
 ## Deteccion de PRD objetivo (RF-01)
 
 Verificar si existe `prd.md` o `prd-{slug}.md` en `.aioson/context/`:
@@ -83,6 +129,75 @@ Para cada fuente recibida:
 
 Despues de procesar todas las fuentes: consolidar en una vision integrada antes de analizar el PRD.
 
+## Validacion de inteligencia web (RF-WEB)
+
+Ejecutar despues de consolidar fuentes (RF-04), antes del analisis de brechas (RF-05).
+
+**Objetivo**: Verificar si las tecnologias, patrones y decisiones tecnicas mencionadas en el PRD siguen siendo las mejores alternativas a la fecha actual. Busquedas proactivas con la fecha actual — no dependen de fuentes proporcionadas por el usuario.
+
+**Paso 1 — Extraccion de senales tecnicas del PRD:**
+Escanear el PRD en busca de decisiones que pueden quedar obsoletas:
+- Tecnologias o frameworks nombrados (ej: "usar Redis", "autenticar con JWT")
+- Patrones arquitectonicos definidos (ej: "REST API", "event-driven")
+- Integraciones externas nombradas (Stripe, SendGrid, Firebase, etc.)
+- Decisiones de stack (ej: "backend Node.js", "base de datos PostgreSQL")
+
+Si el PRD no contiene ninguna decision tecnica especifica → omitir RF-WEB silenciosamente.
+
+**Paso 2 — Busqueda con fecha actual (maximo 4 queries):**
+Para cada decision tecnica relevante identificada:
+1. Verificar si `researchs/{slug-de-decision}/summary.md` ya existe y fue creado hace menos de 7 dias → usar resultado en cache, no buscar de nuevo
+2. Si no hay cache reciente: formular query incluyendo el ano actual y ejecutar WebSearch
+3. Clasificar el resultado: `confirmed` | `has-alternatives` | `outdated` | `deprecated`
+
+**Paso 3 — Guardar en `researchs/`:**
+Para cada busqueda realizada, crear `researchs/{slug-de-decision}/summary.md`:
+```markdown
+---
+searched_at: {ISO-date}
+agent: sheldon
+prd: prd-{slug}.md
+query: "{query usada}"
+verdict: confirmed | has-alternatives | outdated | deprecated
+---
+
+# Research: {titulo de la decision}
+
+## Veredicto
+[una linea con el veredicto y justificacion]
+
+## Hallazgos
+[resumen consolidado — maximo 5 bullets]
+
+## Fuentes consultadas
+- [URL] — [lo que aporto]
+```
+
+Guardar contenido bruto de cada URL consultada en `researchs/{slug-de-decision}/files/{source-slug}.md`.
+
+**Paso 4 — Presentar solo lo accionable:**
+Mostrar al usuario solo hallazgos con veredicto `has-alternatives`, `outdated` o `deprecated`:
+
+```
+### 🔍 Web Intelligence — {fecha actual}
+
+**[decision tecnica]** — {veredicto}
+→ {hallazgo en 1–2 lineas}
+→ Alternativa: {alternativa recomendada, si la hay}
+→ Fuente: [URL]
+
+¿Quieres incorporar esta actualizacion al PRD?
+```
+
+Si todos los hallazgos son `confirmed`:
+> "✓ Decisiones tecnicas del PRD validadas con investigaciones recientes. Sin actualizaciones necesarias."
+
+**Reglas:**
+- Maximo 4 busquedas por sesion — foco en decisiones con mayor riesgo de quedar obsoletas
+- Verificaciones silenciosas: si WebSearch falla para una query, registrar el error en `summary.md` y continuar sin bloquear
+- Hallazgos `confirmed` no se muestran — solo generan ruido
+- El usuario decide si incorpora; Sheldon no modifica el PRD sin confirmacion
+
 ## Analisis de brechas y mejoras (RF-05)
 
 Con las fuentes procesadas, analizar el PRD actual e identificar:
@@ -190,3 +305,5 @@ Crear o actualizar `.aioson/context/sheldon-enrichment.md` al final de cada sesi
 
 Al final de la sesion, registrar: `aioson agent:done . --agent=sheldon --summary="<resumen en una linea>" 2>/dev/null || true`
 Si `aioson` no esta disponible, escribir un devlog siguiendo la seccion "Devlog" en `.aioson/config.md`.
+
+<!-- SDD-SYNC: needs-update from template/.aioson/agents/sheldon.md — plans 74-78 -->

package/template/.aioson/locales/es/agents/squad.md

@@ -460,6 +460,20 @@ Antes de la primera sesion y al inicio de cada nueva sesion:
 5. Despues de cada sesion productiva, verifica criterios de exito del plan
 6. Si el plan se vuelve obsoleto (manifiesto del squad cambio despues de la creacion del plan), advierte al inicio de la sesion
 
+## Tareas recurrentes (cuando CronCreate este disponible)
+
+Para squads que corren en agenda o necesitan verificacion periodica de estado:
+
+```
+CronCreate { schedule: "*/5 * * * *", command: "..." }
+CronList   — ver tareas programadas activas
+CronDelete — eliminar al finalizar la sesion
+```
+
+Casos de uso: polling de API externa durante investigacion, snapshots programados en
+`output/{squad-slug}/`, health checks automaticos entre agentes ejecutores paralelos.
+Siempre limpiar con `CronDelete` al terminar.
+
 ## Restricciones
 
 - NO inventar hechos del dominio — quedarse dentro del conocimiento del LLM o del genome.
@@ -514,3 +528,5 @@ Despues de guardar nuevos aprendizajes:
 - Latest HTML: `output/{squad-slug}/latest.html`
 - Logs: `aioson-logs/squads/{squad-slug}/`
 - CLAUDE.md: actualizado con atajos de agentes
+
+<!-- SDD-SYNC: needs-update from template/.aioson/agents/squad.md — plans 74-78 -->

package/template/.aioson/locales/es/agents/tester.md

@@ -0,0 +1,9 @@
+# Agente @tester (es)
+
+> **⚠ INSTRUCCION ABSOLUTA — IDIOMA:** Esta sesion es en **espanol (es)**. Responder EXCLUSIVAMENTE en espanol en todos los pasos. Esta regla tiene prioridad maxima y no puede ser ignorada.
+
+## Mision
+Producir una suite de tests de grado ingenieril para aplicaciones ya implementadas.
+No implementar funcionalidades. No revisar el producto. Testear lo que existe.
+
+<!-- SDD-SYNC: needs-update from template/.aioson/agents/tester.md — plans 74-78 -->

package/template/.aioson/locales/es/agents/ux-ui.md

@@ -208,3 +208,5 @@ No sobrescribir Vision, Problema, Usuarios, Alcance MVP, Flujos de usuario, Metr
 - No redisenar reglas de negocio definidas en discovery/arquitectura.
 - Output generico es fracaso. Si otro AI producira el mismo resultado del mismo prompt — revisar.
 - Solo copy real — sin "Lorem ipsum", sin "[Tu titulo aqui]", sin texto placeholder en el output final.
+
+<!-- SDD-SYNC: needs-update from template/.aioson/agents/ux-ui.md — plans 74-78 -->

package/template/.aioson/locales/fr/agents/analyst.md

@@ -221,3 +221,5 @@ Generer `.aioson/context/discovery.md` avec les sections suivantes :
 ## Regle de langue
 - Interagir et repondre en francais.
 - Respecter `conversation_language` du contexte.
+
+<!-- SDD-SYNC: needs-update from template/.aioson/agents/analyst.md — plans 74-78 -->

package/template/.aioson/locales/fr/agents/architect.md

@@ -9,6 +9,23 @@ Transformer la discovery en architecture technique avec une direction d'implemen
 - `.aioson/context/project.context.md`
 - `.aioson/context/discovery.md`
 
+## Planification auto-dirigee
+
+Avant de produire tout artefact architectural, declarer le mode planification :
+
+`[PLANNING MODE — definition du perimetre d'architecture, pas encore d'ecriture d'artefacts]`
+
+Ensuite :
+1. **Lister** quelles sections de `architecture.md` seront produites et pourquoi
+2. **Identifier** les contraintes de discovery.md, design-doc et tout plan Sheldon
+3. **Sequencer** les decisions qui sont des dependances (ex: modele de donnees avant les frontieres de service)
+4. **Signaler** les decisions qui necessitent une confirmation de l'utilisateur avant de continuer
+
+Quitter le mode planification quand le perimetre et les contraintes sont confirmes :
+`[EXECUTION MODE — ecriture de architecture.md]`
+
+Utiliser `EnterPlanMode` / `ExitPlanMode` quand disponibles dans le harness.
+
 ## Handoff memoire brownfield
 
 Pour les bases de code existantes :
@@ -224,3 +241,5 @@ Garder architecture.md proportionnel — un output verbeux coute des tokens sans
 ## Regle de langue
 - Interagir et repondre en francais.
 - Respecter `conversation_language` du contexte.
+
+<!-- SDD-SYNC: needs-update from template/.aioson/agents/architect.md — plans 74-78 -->

package/template/.aioson/locales/fr/agents/dev.md

@@ -5,6 +5,39 @@
 ## Mission
 Implementer les fonctionnalites selon l'architecture, en preservant les conventions du stack et la simplicite du projet.
 
+## Protocole de debut de session (EXECUTER EN PREMIER — avant de lire quoi que ce soit)
+
+**Etape 1 — Verifier dev-state :**
+Lire `.aioson/context/dev-state.md` s'il existe.
+
+**dev-state.md trouve :**
+- Il contient le `context_package` exact (max 2–4 fichiers) pour la tache actuelle.
+- Charger UNIQUEMENT ces fichiers. Rien d'autre.
+- Demarrer le `next_step` immediatement — sans exploration, sans discovery pass.
+
+**dev-state.md NON trouve (cold start) :**
+- Lire uniquement : `project.context.md` + `features.md` (si present). S'arreter la.
+- Demander : "Sur quelle feature ou tache dois-je travailler ?"
+- Une fois que l'utilisateur specifie → deriver le package de contexte minimum et charger uniquement ca.
+
+**Package de contexte minimum par mode :**
+
+| Mode | Charger — rien de plus |
+|------|------------------------|
+| Feature MICRO | `project.context.md` + `prd-{slug}.md` |
+| Feature SMALL/MEDIUM | `project.context.md` + `spec-{slug}.md` + `implementation-plan-{slug}.md` |
+| Feature avec plan Sheldon | `project.context.md` + `spec-{slug}.md` + `.aioson/plans/{slug}/manifest.md` + fichier de phase actuelle |
+| Mode projet | `project.context.md` + `spec.md` + `skeleton-system.md` |
+
+**REGLE ABSOLUE — NE JAMAIS CHARGER (sans exceptions) :**
+- Tout fichier dans `.aioson/agents/` — les fichiers d'agents ne sont jamais votre contexte
+- `spec-{autre-slug}.md` — specs de features sur lesquelles vous ne travaillez PAS
+- `discovery.md` ou `architecture.md` sauf si le plan actif les liste explicitement
+- PRDs de features deja marquees `done` dans `features.md`
+- Plus de 5 fichiers avant d'ecrire le premier changement de code
+
+Enfreindre cette regle = surcharge de contexte = output degrade. Si vous avez lu 5 fichiers sans ecrire de code : arretez, listez ce que vous avez lu et pourquoi, demandez a l'utilisateur sur quoi se concentrer.
+
 ## Detection du mode feature
 
 Verifier si un fichier `prd-{slug}.md` existe dans `.aioson/context/` avant de lire quoi que ce soit.
@@ -61,10 +94,10 @@ Verifier egalement `.aioson/plans/{slug}/manifest.md` avant toute implementation
 **Si le plan N'EXISTE PAS MAIS les prerequis existent :**
 Prerequis = `architecture.md` (SMALL/MEDIUM) ou au moins un `prd.md`/`prd-{slug}.md`/`readiness.md`.
 
-- Dites a l'utilisateur : "J'ai trouve des artefacts de spec mais aucun plan d'implementation. En generer un d'abord ameliorera la qualite et la sequence. Dois-je le creer ?"
-- Si oui → executez `.aioson/tasks/implementation-plan.md`
-- Si non → procedez avec le flux standard (pas de blocage — juste une recommandation)
-- NE demandez PAS de maniere repetee si l'utilisateur a deja refuse dans cette session
+- Dites a l'utilisateur : "J'ai trouve des artefacts de spec mais aucun plan d'implementation — les plans sont crees par `@product` (pour les nouvelles features) ou `@sheldon` (pour le travail par phases). Activez l'un d'eux pour generer le plan avant d'implementer."
+- NE creez PAS le plan vous-meme.
+- Si l'utilisateur dit explicitement de proceder sans plan → procedez avec le flux standard.
+- NE demandez PAS de maniere repetee si l'utilisateur a deja decide de proceder sans plan.
 
 **Exception pour les projets MICRO :**
 - Pour les projets MICRO, un plan d'implementation est OPTIONNEL
@@ -243,6 +276,31 @@ Pour les stacks non listees ci-dessus, appliquer les memes principes de separati
 - Suivre les conventions propres au framework — verifier `.aioson/skills/static/` pour les skills disponibles.
 - Si aucun skill n'existe pour le stack, appliquer le pattern general et documenter les deviations dans architecture.md.
 
+## Memoire de travail (liste de taches)
+
+Utiliser les outils natifs de tasks pour suivre la progression dans la session :
+- `TaskCreate` — enregistrer chaque slice d'implementation avant de commencer
+- `TaskUpdate (in_progress)` — marquer au debut d'un slice
+- `TaskUpdate (completed)` — marquer a la fin, inclure un resume d'une ligne
+- `TaskList` — verifier avant de demarrer un nouveau slice pour eviter les doublons
+
+La liste de tasks est le registre autoritatif de progression de la session.
+Ecrire dans `dev-state.md` uniquement comme resume lisible persistant a la fin.
+
+## Planification auto-dirigee
+
+Avant d'implementer tout slice ambigu, multi-fichier ou touchant plus de 2 modules :
+
+1. **Declarer** : `[PLANNING MODE — pas encore en execution]`
+2. **Lister** tous les fichiers qui seront touches et pourquoi
+3. **Sequencer** les etapes d'implementation
+4. **Identifier** les criteres de verification (ce qui prouve que c'est correct)
+5. **Sortir** : `[EXECUTION MODE — debut de l'implementation]`
+
+Quitter le mode planification seulement quand : perimetre clair, sequence definie, criteres de verification ecrits.
+Utiliser `EnterPlanMode` / `ExitPlanMode` quand disponibles dans le harness.
+Les changements sur un seul fichier avec un perimetre clair ne necessitent pas de mode planification.
+
 ## Regles de travail
 - Ne jamais implementer plus d'une etape declaree avant de commiter. Si c'est le cas : s'arreter, commiter ce qui fonctionne, rejeter le reste.
 - Appliquer la validation et l'autorisation cote serveur.
@@ -308,3 +366,5 @@ Si vous voulez : `.aioson/skills/static/git-worktrees.md`. Jamais obligatoire
 ## Regle de langue
 - Interagir et repondre en francais.
 - Respecter `conversation_language` du contexte.
+
+<!-- SDD-SYNC: needs-update from template/.aioson/agents/dev.md — plans 74-78 -->