@jaimevalasek/aioson 1.5.1 → 1.7.0

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

@@ -31,7 +31,15 @@ Comportamiento obligatorio para proyectos existentes con contexto inconsistente:
 NO reejecutar el onboarding completo a menos que el usuario lo solicite explicitamente o que la ambiguedad restante realmente requiera respuestas de onboarding.
 
 **Primer acceso (archivo no existe):**
-Continuar con la deteccion y onboarding completo abajo.
+Verificar si el template AIOSON esta instalado (existe el directorio `.aioson/`). Si falta, indicar al usuario que ejecute:
+
+```bash
+npx @jaimevalasek/aioson setup .
+```
+
+Este unico comando instala el template, detecta automaticamente el framework, infiere el idioma del sistema y genera un `project.context.md` inicial. Despues, el usuario activa `@setup` para confirmar o ajustar el contexto generado.
+
+Si el template ya esta instalado pero `project.context.md` no existe, continuar con la deteccion y onboarding completo abajo.
 
 ## Secuencia obligatoria
 1. **Verificacion de entrada** (arriba) — mostrar resumen si project.context.md existe y es valido; hacer auto-reparacion primero si existe pero esta inconsistente; flujo completo si no existe.
@@ -73,6 +81,30 @@ Si el framework no es detectado:
 
 ## Onboarding por perfil
 
+### Paso 0 — Escanear el workspace antes de cualquier pregunta
+
+Antes de hacer cualquier pregunta, ejecutar:
+```bash
+aioson setup:context . --defaults --json
+```
+
+Esto devuelve los valores auto-inferidos (framework, idioma del sistema, nombre del proyecto desde el directorio, clasificacion). Mostrar al usuario como bloque de confirmacion:
+
+> **Auto-detectado:**
+> - Nombre: `{projectName}` (del directorio)
+> - Framework: `{framework}` (detectado en workspace: `{frameworkInstalled}`)
+> - Tipo: `{projectType}` (inferido del framework)
+> - Clasificacion: `{classification}` (puntuacion automatica)
+> - Idioma: `{conversationLanguage}` (del locale del sistema)
+>
+> "¿Es correcto? Dime qué cambiar o confirma para continuar."
+
+Esperar la respuesta. Aplicar correcciones como flags `--option=value` al llamar el comando final `aioson setup:context`.
+
+Si `aioson` no esta disponible, saltar este paso e ir directamente al Paso 1.
+
+> **Nota:** Si el usuario ejecuto `aioson setup .` antes de activar este agente, `project.context.md` ya esta generado. Tratar el Paso 0 como pasada de confirmacion — mostrar el contexto existente y preguntar solo lo que necesite correccion.
+
 ### Paso 1 — Entender el proyecto
 Hacer UNA pregunta abierta. No mostrar formulario:
 > "Describe el proyecto en una o dos frases — ?que hace y para quien es?"
@@ -369,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 -->