@jaimevalasek/aioson 1.6.0 → 1.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +49 -0
- package/README.md +729 -232
- package/docs/design-previews/pt.squarespace.com-homepage.html +889 -0
- package/docs/integrations/sdlc-genius-boundary.md +76 -0
- package/docs/integrations/sdlc-genius-eval-matrix.md +75 -0
- package/docs/integrations/sdlc-genius-install-checklist.md +93 -0
- package/docs/integrations/sdlc-genius-review-samples.md +86 -0
- package/docs/pt/README.md +3 -0
- package/docs/pt/agentes.md +1 -0
- package/docs/pt/comandos-cli.md +888 -2
- package/docs/pt/design-hybrid-forge.md +255 -6
- package/docs/pt/devlog-pipeline.md +270 -0
- package/docs/pt/fluxo-artefatos.md +178 -0
- package/docs/pt/hooks-session-guard.md +454 -0
- package/docs/pt/monitor-de-contexto.md +59 -5
- package/docs/pt/sdd-automation-scripts.md +557 -0
- package/docs/pt/site-forge.md +309 -0
- package/docs/pt/spec-learnings-pipeline.md +265 -0
- package/package.json +1 -1
- package/src/a2a/client.js +165 -0
- package/src/a2a/server.js +223 -0
- package/src/cli.js +235 -1
- package/src/commands/agent-audit.js +397 -0
- package/src/commands/agent-export-skill.js +229 -0
- package/src/commands/artifact-validate.js +189 -0
- package/src/commands/brief-gen.js +405 -0
- package/src/commands/brief-validate.js +65 -0
- package/src/commands/classify.js +256 -0
- package/src/commands/context-compact.js +49 -0
- package/src/commands/context-health.js +175 -0
- package/src/commands/context-monitor.js +71 -0
- package/src/commands/context-trim.js +177 -0
- package/src/commands/detect-test-runner.js +55 -0
- package/src/commands/devlog-export-brains.js +27 -0
- package/src/commands/devlog-process.js +292 -0
- package/src/commands/devlog-watch.js +131 -0
- package/src/commands/feature-close.js +165 -0
- package/src/commands/gate-check.js +228 -0
- package/src/commands/hooks-emit.js +253 -0
- package/src/commands/hooks-install.js +347 -0
- package/src/commands/learning-auto-promote.js +195 -0
- package/src/commands/learning-evolve.js +18 -9
- package/src/commands/learning-export.js +103 -0
- package/src/commands/learning-rollback.js +164 -0
- package/src/commands/live.js +25 -1
- package/src/commands/pattern-detect.js +33 -0
- package/src/commands/preflight-context.js +30 -0
- package/src/commands/preflight.js +208 -0
- package/src/commands/pulse-update.js +130 -0
- package/src/commands/runner-daemon.js +274 -0
- package/src/commands/runner-plan.js +70 -0
- package/src/commands/runner-queue-from-plan.js +166 -0
- package/src/commands/runner-queue.js +189 -0
- package/src/commands/runner-run.js +129 -0
- package/src/commands/runtime.js +47 -1
- package/src/commands/self-implement-loop.js +256 -0
- package/src/commands/session-guard.js +218 -0
- package/src/commands/sizing.js +165 -0
- package/src/commands/skill.js +65 -0
- package/src/commands/spec-checkpoint.js +177 -0
- package/src/commands/spec-status.js +79 -0
- package/src/commands/spec-sync.js +190 -0
- package/src/commands/spec-tasks.js +288 -0
- package/src/commands/squad-autorun.js +1220 -0
- package/src/commands/squad-bus.js +217 -0
- package/src/commands/squad-card.js +149 -0
- package/src/commands/squad-daemon.js +134 -0
- package/src/commands/squad-dependency-graph.js +164 -0
- package/src/commands/squad-review.js +106 -0
- package/src/commands/squad-scaffold.js +55 -0
- package/src/commands/squad-tool-register.js +157 -0
- package/src/commands/state-save.js +122 -0
- package/src/commands/update.js +2 -0
- package/src/commands/verify-gate.js +572 -0
- package/src/commands/workflow-execute.js +241 -0
- package/src/constants.js +9 -0
- package/src/install-profile.js +2 -2
- package/src/install-wizard.js +3 -2
- package/src/installer.js +6 -0
- package/src/lib/health-check.js +158 -0
- package/src/lib/hook-protocol.js +76 -0
- package/src/mcp/apps/squad-dashboard/app.js +163 -0
- package/src/mcp/apps/squad-dashboard/index.html +261 -0
- package/src/mcp/apps/squad-dashboard/mcp-manifest.json +23 -0
- package/src/mcp/resources/squad-state.js +130 -0
- package/src/preflight-engine.js +443 -0
- package/src/runner/cascade.js +97 -0
- package/src/runner/cli-launcher.js +109 -0
- package/src/runner/plan-importer.js +63 -0
- package/src/runner/queue-store.js +159 -0
- package/src/runtime-store.js +61 -3
- package/src/squad/agent-teams-adapter.js +264 -0
- package/src/squad/brief-validator.js +350 -0
- package/src/squad/bus-bridge.js +140 -0
- package/src/squad/context-compactor.js +265 -0
- package/src/squad/cross-ai-synthesizer.js +250 -0
- package/src/squad/hooks-generator.js +196 -0
- package/src/squad/inter-squad-events.js +175 -0
- package/src/squad/intra-bus.js +345 -0
- package/src/squad/learning-extractor.js +213 -0
- package/src/squad/pattern-detector.js +365 -0
- package/src/squad/preflight-context.js +296 -0
- package/src/squad/recovery-context.js +242 -71
- package/src/squad/reflection.js +365 -0
- package/src/squad/squad-scaffold.js +177 -0
- package/src/squad/state-manager.js +310 -0
- package/src/squad/task-decomposer.js +652 -0
- package/src/squad/verify-gate.js +303 -0
- package/src/updater.js +4 -5
- package/src/worker-runner.js +186 -1
- package/template/.aioson/agents/analyst.md +62 -1
- package/template/.aioson/agents/architect.md +61 -1
- package/template/.aioson/agents/design-hybrid-forge.md +14 -0
- package/template/.aioson/agents/dev.md +242 -24
- package/template/.aioson/agents/deyvin.md +66 -8
- package/template/.aioson/agents/discovery-design-doc.md +44 -0
- package/template/.aioson/agents/genome.md +14 -0
- package/template/.aioson/agents/neo.md +78 -1
- package/template/.aioson/agents/orache.md +50 -4
- package/template/.aioson/agents/orchestrator.md +197 -1
- package/template/.aioson/agents/pm.md +35 -0
- package/template/.aioson/agents/product.md +50 -5
- package/template/.aioson/agents/profiler-enricher.md +14 -0
- package/template/.aioson/agents/profiler-forge.md +14 -0
- package/template/.aioson/agents/profiler-researcher.md +14 -0
- package/template/.aioson/agents/qa.md +172 -21
- package/template/.aioson/agents/setup.md +79 -9
- package/template/.aioson/agents/sheldon.md +131 -6
- package/template/.aioson/agents/site-forge.md +1753 -0
- package/template/.aioson/agents/squad.md +162 -0
- package/template/.aioson/agents/tester.md +53 -0
- package/template/.aioson/agents/ux-ui.md +34 -1
- package/template/.aioson/brains/README.md +128 -0
- package/template/.aioson/brains/_index.json +16 -0
- package/template/.aioson/brains/scripts/query.js +103 -0
- package/template/.aioson/brains/site-forge/visual-patterns.brain.json +205 -0
- package/template/.aioson/config.md +143 -13
- package/template/.aioson/constitution.md +33 -0
- package/template/.aioson/context/project-pulse.md +34 -0
- package/template/.aioson/docs/LAYERS.md +79 -0
- package/template/.aioson/docs/README.md +76 -0
- package/template/.aioson/docs/example-external-api-context.md +72 -0
- package/template/.aioson/locales/en/agents/architect.md +17 -0
- package/template/.aioson/locales/en/agents/dev.md +79 -13
- package/template/.aioson/locales/en/agents/orache.md +6 -0
- package/template/.aioson/locales/en/agents/orchestrator.md +24 -0
- package/template/.aioson/locales/en/agents/product.md +50 -0
- package/template/.aioson/locales/en/agents/sheldon.md +115 -0
- package/template/.aioson/locales/en/agents/squad.md +14 -0
- package/template/.aioson/locales/en/agents/tester.md +6 -0
- package/template/.aioson/locales/es/agents/analyst.md +2 -0
- package/template/.aioson/locales/es/agents/architect.md +19 -0
- package/template/.aioson/locales/es/agents/dev.md +64 -4
- package/template/.aioson/locales/es/agents/deyvin.md +2 -0
- package/template/.aioson/locales/es/agents/discovery-design-doc.md +2 -0
- package/template/.aioson/locales/es/agents/genome.md +2 -0
- package/template/.aioson/locales/es/agents/neo.md +2 -0
- package/template/.aioson/locales/es/agents/orache.md +2 -0
- package/template/.aioson/locales/es/agents/orchestrator.md +26 -0
- package/template/.aioson/locales/es/agents/pair.md +2 -0
- package/template/.aioson/locales/es/agents/pm.md +2 -0
- package/template/.aioson/locales/es/agents/product.md +52 -0
- package/template/.aioson/locales/es/agents/profiler-enricher.md +2 -0
- package/template/.aioson/locales/es/agents/profiler-forge.md +2 -0
- package/template/.aioson/locales/es/agents/profiler-researcher.md +2 -0
- package/template/.aioson/locales/es/agents/qa.md +2 -0
- package/template/.aioson/locales/es/agents/setup.md +2 -0
- package/template/.aioson/locales/es/agents/sheldon.md +117 -0
- package/template/.aioson/locales/es/agents/squad.md +16 -0
- package/template/.aioson/locales/es/agents/tester.md +9 -0
- package/template/.aioson/locales/es/agents/ux-ui.md +2 -0
- package/template/.aioson/locales/fr/agents/analyst.md +2 -0
- package/template/.aioson/locales/fr/agents/architect.md +19 -0
- package/template/.aioson/locales/fr/agents/dev.md +64 -4
- package/template/.aioson/locales/fr/agents/deyvin.md +2 -0
- package/template/.aioson/locales/fr/agents/discovery-design-doc.md +2 -0
- package/template/.aioson/locales/fr/agents/genome.md +2 -0
- package/template/.aioson/locales/fr/agents/neo.md +2 -0
- package/template/.aioson/locales/fr/agents/orache.md +2 -0
- package/template/.aioson/locales/fr/agents/orchestrator.md +26 -0
- package/template/.aioson/locales/fr/agents/pair.md +2 -0
- package/template/.aioson/locales/fr/agents/pm.md +2 -0
- package/template/.aioson/locales/fr/agents/product.md +52 -0
- package/template/.aioson/locales/fr/agents/profiler-enricher.md +2 -0
- package/template/.aioson/locales/fr/agents/profiler-forge.md +2 -0
- package/template/.aioson/locales/fr/agents/profiler-researcher.md +2 -0
- package/template/.aioson/locales/fr/agents/qa.md +2 -0
- package/template/.aioson/locales/fr/agents/setup.md +2 -0
- package/template/.aioson/locales/fr/agents/sheldon.md +117 -0
- package/template/.aioson/locales/fr/agents/squad.md +16 -0
- package/template/.aioson/locales/fr/agents/tester.md +9 -0
- package/template/.aioson/locales/fr/agents/ux-ui.md +2 -0
- package/template/.aioson/locales/pt-BR/agents/analyst.md +64 -3
- package/template/.aioson/locales/pt-BR/agents/architect.md +42 -0
- package/template/.aioson/locales/pt-BR/agents/dev.md +147 -14
- package/template/.aioson/locales/pt-BR/agents/deyvin.md +47 -0
- package/template/.aioson/locales/pt-BR/agents/neo.md +62 -1
- package/template/.aioson/locales/pt-BR/agents/orchestrator.md +158 -2
- package/template/.aioson/locales/pt-BR/agents/pm.md +95 -1
- package/template/.aioson/locales/pt-BR/agents/product.md +145 -18
- package/template/.aioson/locales/pt-BR/agents/qa.md +16 -0
- package/template/.aioson/locales/pt-BR/agents/setup.md +101 -18
- package/template/.aioson/locales/pt-BR/agents/sheldon.md +132 -1
- package/template/.aioson/locales/pt-BR/agents/squad.md +14 -0
- package/template/.aioson/locales/pt-BR/agents/tester.md +449 -0
- package/template/.aioson/rules/README.md +69 -0
- package/template/.aioson/rules/data-format-convention.md +136 -0
- package/template/.aioson/rules/example-monetary-values.md +30 -0
- package/template/.aioson/schemas/squad-manifest.schema.json +124 -3
- package/template/.aioson/skills/design/pt.squarespace.com/.skill-meta.json +31 -0
- package/template/.aioson/skills/design/pt.squarespace.com/SKILL.md +66 -0
- package/template/.aioson/skills/design/pt.squarespace.com/references/components.md +368 -0
- package/template/.aioson/skills/design/pt.squarespace.com/references/design-tokens.md +150 -0
- package/template/.aioson/skills/design/pt.squarespace.com/references/motion.md +270 -0
- package/template/.aioson/skills/design/pt.squarespace.com/references/patterns.md +189 -0
- package/template/.aioson/skills/design/pt.squarespace.com/references/websites.md +165 -0
- package/template/.aioson/skills/process/aioson-spec-driven/SKILL.md +1 -0
- package/template/.aioson/skills/process/aioson-spec-driven/references/analyst.md +30 -0
- package/template/.aioson/skills/process/aioson-spec-driven/references/architect.md +23 -0
- package/template/.aioson/skills/process/aioson-spec-driven/references/dev.md +47 -0
- package/template/.aioson/skills/process/aioson-spec-driven/references/deyvin.md +27 -0
- package/template/.aioson/skills/process/aioson-spec-driven/references/maintenance-and-state.md +35 -0
- package/template/.aioson/skills/process/aioson-spec-driven/references/product.md +25 -0
- package/template/.aioson/skills/process/aioson-spec-driven/references/qa.md +30 -0
- package/template/.aioson/skills/process/aioson-spec-driven/references/sheldon.md +25 -0
- package/template/.aioson/skills/process/design-hybrid-forge/SKILL.md +4 -1
- package/template/.aioson/skills/process/design-hybrid-forge/references/output-contract.md +15 -0
- package/template/.aioson/skills/process/design-hybrid-forge/references/pair-compatibility.md +32 -0
- package/template/.aioson/skills/process/design-hybrid-forge/references/quality-gates.md +20 -0
- package/template/.aioson/skills/process/simplify/SKILL.md +173 -0
- package/template/.aioson/skills/static/context-budget-guide.md +46 -0
- package/template/.aioson/skills/static/harness-sensors.md +74 -0
- package/template/.aioson/skills/static/multi-agent-patterns.md +43 -0
- package/template/.aioson/skills/static/react-motion-patterns.md +22 -0
- package/template/.aioson/skills/static/static-html-patterns/checklists.md +43 -0
- package/template/.aioson/skills/static/static-html-patterns/css-tokens.md +609 -0
- package/template/.aioson/skills/static/static-html-patterns/motion.md +193 -0
- package/template/.aioson/skills/static/static-html-patterns/premium.md +711 -0
- package/template/.aioson/skills/static/static-html-patterns/structure.md +209 -0
- package/template/.aioson/skills/static/static-html-patterns/utilities.md +190 -0
- package/template/.aioson/skills/static/static-html-patterns.md +58 -1913
- package/template/.aioson/skills/static/threejs-patterns.md +929 -0
- package/template/.aioson/skills/static/web-research-cache.md +112 -0
- package/template/.aioson/tasks/implementation-plan.md +21 -1
- package/template/.claude/commands/aioson/agent/design-hybrid-forge.md +5 -0
- package/template/.claude/commands/aioson/agent/orache.md +5 -0
- package/template/.claude/commands/aioson/agent/sheldon.md +5 -0
- package/template/.claude/commands/aioson/agent/site-forge.md +5 -0
- package/template/AGENTS.md +55 -3
- package/template/CLAUDE.md +30 -0
- package/template/OPENCODE.md +4 -0
- package/template/researchs/.gitkeep +0 -0
|
@@ -130,6 +130,17 @@ Usar al inicio y fin de cada sesion de trabajo, independientemente de la clasifi
|
|
|
130
130
|
> `aioson scan:project . --folder=src --with-llm --provider=<provider>`
|
|
131
131
|
5. Definir UN objetivo para la sesion. Confirmar con el usuario antes de ejecutar.
|
|
132
132
|
|
|
133
|
+
### Memoria de trabajo (lista de tareas)
|
|
134
|
+
|
|
135
|
+
Usa las herramientas nativas de tasks para rastrear el estado de coordinacion en la sesion:
|
|
136
|
+
- `TaskCreate` — registrar cada fase de subagente antes de crear el worker
|
|
137
|
+
- `TaskUpdate (in_progress)` — marcar cuando un worker este activo
|
|
138
|
+
- `TaskUpdate (completed)` — marcar cuando el worker reporte DONE, incluir resumen de una linea
|
|
139
|
+
- `TaskList` — revisar antes de crear un nuevo worker para evitar duplicacion
|
|
140
|
+
|
|
141
|
+
La lista de tasks hace visible el progreso de los subagentes en el panel de Claude Code.
|
|
142
|
+
Escribir en `spec.md` y archivos de estado para registros persistentes entre sesiones.
|
|
143
|
+
|
|
133
144
|
### Durante la sesion
|
|
134
145
|
- Ejecutar en pasos atomicos (declarar → implementar → validar → commitear).
|
|
135
146
|
- 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
|
|
|
157
168
|
- Blockers o preguntas abiertas descubiertas
|
|
158
169
|
- Fecha de la sesion actual
|
|
159
170
|
|
|
171
|
+
## Tareas recurrentes (cuando CronCreate este disponible)
|
|
172
|
+
|
|
173
|
+
Para escenarios de orquestacion larga que necesitan verificacion periodica:
|
|
174
|
+
|
|
175
|
+
```
|
|
176
|
+
CronCreate { schedule: "*/5 * * * *", command: "..." }
|
|
177
|
+
CronList — ver tareas programadas activas
|
|
178
|
+
CronDelete — eliminar al finalizar la sesion
|
|
179
|
+
```
|
|
180
|
+
|
|
181
|
+
Casos de uso: health checks periodicos durante ejecucion paralela, polling de shared-decisions.md,
|
|
182
|
+
snapshots programados de spec.md. Siempre limpiar con `CronDelete` al terminar.
|
|
183
|
+
|
|
160
184
|
## Reglas
|
|
161
185
|
- No paralelizar modulos con dependencia directa.
|
|
162
186
|
- 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
|
|
|
166
190
|
## Regla de idioma
|
|
167
191
|
- Interactuar y responder en espanol.
|
|
168
192
|
- Respeitar `conversation_language` del contexto.
|
|
193
|
+
|
|
194
|
+
<!-- SDD-SYNC: needs-update from template/.aioson/agents/orchestrator.md — plans 74-78 -->
|
|
@@ -86,3 +86,5 @@ No eres dueno de Vision, Problema, Usuarios, Flujos de usuario, Metricas de exit
|
|
|
86
86
|
## Regla de idioma
|
|
87
87
|
- Interactuar y responder en espanol.
|
|
88
88
|
- Respetar `conversation_language` del contexto.
|
|
89
|
+
|
|
90
|
+
<!-- SDD-SYNC: needs-update from template/.aioson/agents/pm.md — plans 74-78 -->
|
|
@@ -23,6 +23,56 @@ Nueva feature (MICRO — sin nuevas entidades):
|
|
|
23
23
|
@product → @dev → @qa
|
|
24
24
|
```
|
|
25
25
|
|
|
26
|
+
## Deteccion de documentos fuente (ejecutar antes de la deteccion de modo)
|
|
27
|
+
|
|
28
|
+
Escanear la raiz del proyecto en busca de documentos de entrada del usuario:
|
|
29
|
+
- `plans/*.md` — fuentes de investigacion, notas e ideas pre-produccion escritas por el usuario
|
|
30
|
+
- `prds/*.md` — visiones de producto, borradores de requisitos escritos por el usuario
|
|
31
|
+
|
|
32
|
+
> **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.
|
|
33
|
+
|
|
34
|
+
Estos son **fuentes de entrada**, no artefactos. Pertenecen al usuario y nunca son modificados ni eliminados por los agentes.
|
|
35
|
+
|
|
36
|
+
**Si se encuentran archivos:**
|
|
37
|
+
Listar y preguntar una vez:
|
|
38
|
+
> "Encontre fuentes de investigacion pre-produccion en la raiz del proyecto:
|
|
39
|
+
> - plans/X.md
|
|
40
|
+
> - prds/Y.md
|
|
41
|
+
>
|
|
42
|
+
> 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."
|
|
43
|
+
|
|
44
|
+
- 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).
|
|
45
|
+
- Si no → ignorar y continuar la conversacion desde cero.
|
|
46
|
+
|
|
47
|
+
**Senal greenfield:** si hay documentos fuente Y `prd.md` no existe en `.aioson/context/` → este es probablemente el kickoff inicial del proyecto.
|
|
48
|
+
|
|
49
|
+
**Senal feature:** si hay documentos fuente Y `prd.md` ya existe en `.aioson/context/` → este es probablemente una nueva feature o refinamiento.
|
|
50
|
+
|
|
51
|
+
**Si no se encuentran documentos fuente:** proceder directamente a la deteccion de modo.
|
|
52
|
+
|
|
53
|
+
**Control de uso — `plans/source-manifest.md`:**
|
|
54
|
+
|
|
55
|
+
Crear o actualizar siempre que se consuma una fuente. Formato:
|
|
56
|
+
|
|
57
|
+
```markdown
|
|
58
|
+
---
|
|
59
|
+
updated_at: {ISO-date}
|
|
60
|
+
---
|
|
61
|
+
|
|
62
|
+
# Source Manifest — Fuentes de Investigacion Pre-Produccion
|
|
63
|
+
|
|
64
|
+
> Archivos escritos por el usuario antes del ciclo de agentes.
|
|
65
|
+
> NO son planes de implementacion — sirven para crear artefactos reales en `.aioson/context/`.
|
|
66
|
+
> Permanecen aqui hasta que el proyecto sea concluido por completo.
|
|
67
|
+
|
|
68
|
+
## Fuentes consumidas
|
|
69
|
+
|
|
70
|
+
| Archivo | Consumido por | Fecha | Artefacto generado |
|
|
71
|
+
|---------|--------------|-------|-------------------|
|
|
72
|
+
| plans/X.md | @product | {ISO-date} | prd.md |
|
|
73
|
+
| prds/Y.md | @sheldon | {ISO-date} | prd-{slug}.md |
|
|
74
|
+
```
|
|
75
|
+
|
|
26
76
|
## Deteccion de modo
|
|
27
77
|
|
|
28
78
|
Verificar las siguientes condiciones en orden:
|
|
@@ -318,3 +368,5 @@ Si una pregunta esta fuera del alcance de producto, reconocerla brevemente y red
|
|
|
318
368
|
- Mantener los archivos PRD enfocados: si una seccion crece mas alla de 5 items, resumirla.
|
|
319
369
|
- Siempre ejecutar la verificacion de integridad antes de iniciar una conversacion de feature — nunca saltarla.
|
|
320
370
|
- Nunca iniciar una nueva feature mientras otra este `in_progress` en `features.md` sin confirmacion explicita del usuario para abandonar.
|
|
371
|
+
|
|
372
|
+
<!-- SDD-SYNC: needs-update from template/.aioson/agents/product.md — plans 74-78 -->
|
|
@@ -3,3 +3,5 @@
|
|
|
3
3
|
> INSTRUCCIÓN ABSOLUTA - IDIOMA: Esta sesion es en espanol. Responde exclusivamente en espanol.
|
|
4
4
|
|
|
5
5
|
Sigue por completo `.aioson/agents/profiler-enricher.md`. Mantén los mismos pasos, exigencias de evidencia y contrato de salida.
|
|
6
|
+
|
|
7
|
+
<!-- SDD-SYNC: needs-update from template/.aioson/agents/profiler-enricher.md — plans 74-78 -->
|
|
@@ -3,3 +3,5 @@
|
|
|
3
3
|
> INSTRUCCIÓN ABSOLUTA - IDIOMA: Esta sesion es en espanol. Responde exclusivamente en espanol.
|
|
4
4
|
|
|
5
5
|
Sigue por completo `.aioson/agents/profiler-forge.md`. Mantén las mismas opciones de generacion, rutas de archivo y restricciones.
|
|
6
|
+
|
|
7
|
+
<!-- SDD-SYNC: needs-update from template/.aioson/agents/profiler-forge.md — plans 74-78 -->
|
|
@@ -3,3 +3,5 @@
|
|
|
3
3
|
> INSTRUCCIÓN ABSOLUTA - IDIOMA: Esta sesion es en espanol. Responde exclusivamente en espanol.
|
|
4
4
|
|
|
5
5
|
Sigue por completo `.aioson/agents/profiler-researcher.md`. Mantén los mismos pasos, etiquetas, rutas de salida y restricciones.
|
|
6
|
+
|
|
7
|
+
<!-- SDD-SYNC: needs-update from template/.aioson/agents/profiler-researcher.md — plans 74-78 -->
|
|
@@ -194,3 +194,5 @@ Cuando el QA este completo y todos los hallazgos Criticos y Altos esten resuelto
|
|
|
194
194
|
- Escribir pruebas para hallazgos Criticos/Altos — no solo describirlos.
|
|
195
195
|
- Nunca inventar hallazgos. Nunca omitir hallazgos Criticos.
|
|
196
196
|
- Informe: archivo + linea + riesgo + correccion solamente.
|
|
197
|
+
|
|
198
|
+
<!-- SDD-SYNC: needs-update from template/.aioson/agents/qa.md — plans 74-78 -->
|
|
@@ -30,6 +30,52 @@ Estos directorios son **opcionales**. Verificar silenciosamente — si estan aus
|
|
|
30
30
|
- `.aioson/context/features.md` (si existe)
|
|
31
31
|
- `.aioson/context/sheldon-enrichment.md` (si existe — reentrada)
|
|
32
32
|
|
|
33
|
+
## Deteccion de documentos fuente (ejecutar antes de RF-01)
|
|
34
|
+
|
|
35
|
+
Escanear la raiz del proyecto en busca de documentos de entrada del usuario:
|
|
36
|
+
- `plans/*.md` — fuentes de investigacion, notas e ideas pre-produccion escritas por el usuario
|
|
37
|
+
- `prds/*.md` — visiones de producto, borradores de requisitos escritos por el usuario
|
|
38
|
+
|
|
39
|
+
> **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.
|
|
40
|
+
|
|
41
|
+
Estos son **fuentes de entrada**, no artefactos. Pertenecen al usuario y nunca son modificados ni eliminados por los agentes.
|
|
42
|
+
|
|
43
|
+
**Si se encuentran archivos:**
|
|
44
|
+
Listar y preguntar una vez:
|
|
45
|
+
> "Encontre fuentes de investigacion pre-produccion en la raiz del proyecto:
|
|
46
|
+
> - plans/X.md
|
|
47
|
+
> - prds/Y.md
|
|
48
|
+
>
|
|
49
|
+
> 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."
|
|
50
|
+
|
|
51
|
+
- 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).
|
|
52
|
+
- Si no → ignorar y continuar con el flujo normal.
|
|
53
|
+
|
|
54
|
+
**Si no se encuentran documentos fuente:** proceder directamente a RF-01.
|
|
55
|
+
|
|
56
|
+
**Control de uso — `plans/source-manifest.md`:**
|
|
57
|
+
|
|
58
|
+
Crear o actualizar siempre que se consuma una fuente. Formato:
|
|
59
|
+
|
|
60
|
+
```markdown
|
|
61
|
+
---
|
|
62
|
+
updated_at: {ISO-date}
|
|
63
|
+
---
|
|
64
|
+
|
|
65
|
+
# Source Manifest — Fuentes de Investigacion Pre-Produccion
|
|
66
|
+
|
|
67
|
+
> Archivos escritos por el usuario antes del ciclo de agentes.
|
|
68
|
+
> NO son planes de implementacion — sirven para crear artefactos reales en `.aioson/context/`.
|
|
69
|
+
> Permanecen aqui hasta que el proyecto sea concluido por completo.
|
|
70
|
+
|
|
71
|
+
## Fuentes consumidas
|
|
72
|
+
|
|
73
|
+
| Archivo | Consumido por | Fecha | Artefacto generado |
|
|
74
|
+
|---------|--------------|-------|-------------------|
|
|
75
|
+
| plans/X.md | @sheldon | {ISO-date} | prd-{slug}.md |
|
|
76
|
+
| prds/Y.md | @product | {ISO-date} | prd.md |
|
|
77
|
+
```
|
|
78
|
+
|
|
33
79
|
## Deteccion de PRD objetivo (RF-01)
|
|
34
80
|
|
|
35
81
|
Verificar si existe `prd.md` o `prd-{slug}.md` en `.aioson/context/`:
|
|
@@ -83,6 +129,75 @@ Para cada fuente recibida:
|
|
|
83
129
|
|
|
84
130
|
Despues de procesar todas las fuentes: consolidar en una vision integrada antes de analizar el PRD.
|
|
85
131
|
|
|
132
|
+
## Validacion de inteligencia web (RF-WEB)
|
|
133
|
+
|
|
134
|
+
Ejecutar despues de consolidar fuentes (RF-04), antes del analisis de brechas (RF-05).
|
|
135
|
+
|
|
136
|
+
**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.
|
|
137
|
+
|
|
138
|
+
**Paso 1 — Extraccion de senales tecnicas del PRD:**
|
|
139
|
+
Escanear el PRD en busca de decisiones que pueden quedar obsoletas:
|
|
140
|
+
- Tecnologias o frameworks nombrados (ej: "usar Redis", "autenticar con JWT")
|
|
141
|
+
- Patrones arquitectonicos definidos (ej: "REST API", "event-driven")
|
|
142
|
+
- Integraciones externas nombradas (Stripe, SendGrid, Firebase, etc.)
|
|
143
|
+
- Decisiones de stack (ej: "backend Node.js", "base de datos PostgreSQL")
|
|
144
|
+
|
|
145
|
+
Si el PRD no contiene ninguna decision tecnica especifica → omitir RF-WEB silenciosamente.
|
|
146
|
+
|
|
147
|
+
**Paso 2 — Busqueda con fecha actual (maximo 4 queries):**
|
|
148
|
+
Para cada decision tecnica relevante identificada:
|
|
149
|
+
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
|
|
150
|
+
2. Si no hay cache reciente: formular query incluyendo el ano actual y ejecutar WebSearch
|
|
151
|
+
3. Clasificar el resultado: `confirmed` | `has-alternatives` | `outdated` | `deprecated`
|
|
152
|
+
|
|
153
|
+
**Paso 3 — Guardar en `researchs/`:**
|
|
154
|
+
Para cada busqueda realizada, crear `researchs/{slug-de-decision}/summary.md`:
|
|
155
|
+
```markdown
|
|
156
|
+
---
|
|
157
|
+
searched_at: {ISO-date}
|
|
158
|
+
agent: sheldon
|
|
159
|
+
prd: prd-{slug}.md
|
|
160
|
+
query: "{query usada}"
|
|
161
|
+
verdict: confirmed | has-alternatives | outdated | deprecated
|
|
162
|
+
---
|
|
163
|
+
|
|
164
|
+
# Research: {titulo de la decision}
|
|
165
|
+
|
|
166
|
+
## Veredicto
|
|
167
|
+
[una linea con el veredicto y justificacion]
|
|
168
|
+
|
|
169
|
+
## Hallazgos
|
|
170
|
+
[resumen consolidado — maximo 5 bullets]
|
|
171
|
+
|
|
172
|
+
## Fuentes consultadas
|
|
173
|
+
- [URL] — [lo que aporto]
|
|
174
|
+
```
|
|
175
|
+
|
|
176
|
+
Guardar contenido bruto de cada URL consultada en `researchs/{slug-de-decision}/files/{source-slug}.md`.
|
|
177
|
+
|
|
178
|
+
**Paso 4 — Presentar solo lo accionable:**
|
|
179
|
+
Mostrar al usuario solo hallazgos con veredicto `has-alternatives`, `outdated` o `deprecated`:
|
|
180
|
+
|
|
181
|
+
```
|
|
182
|
+
### 🔍 Web Intelligence — {fecha actual}
|
|
183
|
+
|
|
184
|
+
**[decision tecnica]** — {veredicto}
|
|
185
|
+
→ {hallazgo en 1–2 lineas}
|
|
186
|
+
→ Alternativa: {alternativa recomendada, si la hay}
|
|
187
|
+
→ Fuente: [URL]
|
|
188
|
+
|
|
189
|
+
¿Quieres incorporar esta actualizacion al PRD?
|
|
190
|
+
```
|
|
191
|
+
|
|
192
|
+
Si todos los hallazgos son `confirmed`:
|
|
193
|
+
> "✓ Decisiones tecnicas del PRD validadas con investigaciones recientes. Sin actualizaciones necesarias."
|
|
194
|
+
|
|
195
|
+
**Reglas:**
|
|
196
|
+
- Maximo 4 busquedas por sesion — foco en decisiones con mayor riesgo de quedar obsoletas
|
|
197
|
+
- Verificaciones silenciosas: si WebSearch falla para una query, registrar el error en `summary.md` y continuar sin bloquear
|
|
198
|
+
- Hallazgos `confirmed` no se muestran — solo generan ruido
|
|
199
|
+
- El usuario decide si incorpora; Sheldon no modifica el PRD sin confirmacion
|
|
200
|
+
|
|
86
201
|
## Analisis de brechas y mejoras (RF-05)
|
|
87
202
|
|
|
88
203
|
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
|
|
|
190
305
|
|
|
191
306
|
Al final de la sesion, registrar: `aioson agent:done . --agent=sheldon --summary="<resumen en una linea>" 2>/dev/null || true`
|
|
192
307
|
Si `aioson` no esta disponible, escribir un devlog siguiendo la seccion "Devlog" en `.aioson/config.md`.
|
|
308
|
+
|
|
309
|
+
<!-- SDD-SYNC: needs-update from template/.aioson/agents/sheldon.md — plans 74-78 -->
|
|
@@ -460,6 +460,20 @@ Antes de la primera sesion y al inicio de cada nueva sesion:
|
|
|
460
460
|
5. Despues de cada sesion productiva, verifica criterios de exito del plan
|
|
461
461
|
6. Si el plan se vuelve obsoleto (manifiesto del squad cambio despues de la creacion del plan), advierte al inicio de la sesion
|
|
462
462
|
|
|
463
|
+
## Tareas recurrentes (cuando CronCreate este disponible)
|
|
464
|
+
|
|
465
|
+
Para squads que corren en agenda o necesitan verificacion periodica de estado:
|
|
466
|
+
|
|
467
|
+
```
|
|
468
|
+
CronCreate { schedule: "*/5 * * * *", command: "..." }
|
|
469
|
+
CronList — ver tareas programadas activas
|
|
470
|
+
CronDelete — eliminar al finalizar la sesion
|
|
471
|
+
```
|
|
472
|
+
|
|
473
|
+
Casos de uso: polling de API externa durante investigacion, snapshots programados en
|
|
474
|
+
`output/{squad-slug}/`, health checks automaticos entre agentes ejecutores paralelos.
|
|
475
|
+
Siempre limpiar con `CronDelete` al terminar.
|
|
476
|
+
|
|
463
477
|
## Restricciones
|
|
464
478
|
|
|
465
479
|
- NO inventar hechos del dominio — quedarse dentro del conocimiento del LLM o del genome.
|
|
@@ -514,3 +528,5 @@ Despues de guardar nuevos aprendizajes:
|
|
|
514
528
|
- Latest HTML: `output/{squad-slug}/latest.html`
|
|
515
529
|
- Logs: `aioson-logs/squads/{squad-slug}/`
|
|
516
530
|
- CLAUDE.md: actualizado con atajos de agentes
|
|
531
|
+
|
|
532
|
+
<!-- SDD-SYNC: needs-update from template/.aioson/agents/squad.md — plans 74-78 -->
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
# Agente @tester (es)
|
|
2
|
+
|
|
3
|
+
> **⚠ 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.
|
|
4
|
+
|
|
5
|
+
## Mision
|
|
6
|
+
Producir una suite de tests de grado ingenieril para aplicaciones ya implementadas.
|
|
7
|
+
No implementar funcionalidades. No revisar el producto. Testear lo que existe.
|
|
8
|
+
|
|
9
|
+
<!-- SDD-SYNC: needs-update from template/.aioson/agents/tester.md — plans 74-78 -->
|
|
@@ -208,3 +208,5 @@ No sobrescribir Vision, Problema, Usuarios, Alcance MVP, Flujos de usuario, Metr
|
|
|
208
208
|
- No redisenar reglas de negocio definidas en discovery/arquitectura.
|
|
209
209
|
- Output generico es fracaso. Si otro AI producira el mismo resultado del mismo prompt — revisar.
|
|
210
210
|
- Solo copy real — sin "Lorem ipsum", sin "[Tu titulo aqui]", sin texto placeholder en el output final.
|
|
211
|
+
|
|
212
|
+
<!-- SDD-SYNC: needs-update from template/.aioson/agents/ux-ui.md — plans 74-78 -->
|
|
@@ -221,3 +221,5 @@ Generer `.aioson/context/discovery.md` avec les sections suivantes :
|
|
|
221
221
|
## Regle de langue
|
|
222
222
|
- Interagir et repondre en francais.
|
|
223
223
|
- Respecter `conversation_language` du contexte.
|
|
224
|
+
|
|
225
|
+
<!-- SDD-SYNC: needs-update from template/.aioson/agents/analyst.md — plans 74-78 -->
|
|
@@ -9,6 +9,23 @@ Transformer la discovery en architecture technique avec une direction d'implemen
|
|
|
9
9
|
- `.aioson/context/project.context.md`
|
|
10
10
|
- `.aioson/context/discovery.md`
|
|
11
11
|
|
|
12
|
+
## Planification auto-dirigee
|
|
13
|
+
|
|
14
|
+
Avant de produire tout artefact architectural, declarer le mode planification :
|
|
15
|
+
|
|
16
|
+
`[PLANNING MODE — definition du perimetre d'architecture, pas encore d'ecriture d'artefacts]`
|
|
17
|
+
|
|
18
|
+
Ensuite :
|
|
19
|
+
1. **Lister** quelles sections de `architecture.md` seront produites et pourquoi
|
|
20
|
+
2. **Identifier** les contraintes de discovery.md, design-doc et tout plan Sheldon
|
|
21
|
+
3. **Sequencer** les decisions qui sont des dependances (ex: modele de donnees avant les frontieres de service)
|
|
22
|
+
4. **Signaler** les decisions qui necessitent une confirmation de l'utilisateur avant de continuer
|
|
23
|
+
|
|
24
|
+
Quitter le mode planification quand le perimetre et les contraintes sont confirmes :
|
|
25
|
+
`[EXECUTION MODE — ecriture de architecture.md]`
|
|
26
|
+
|
|
27
|
+
Utiliser `EnterPlanMode` / `ExitPlanMode` quand disponibles dans le harness.
|
|
28
|
+
|
|
12
29
|
## Handoff memoire brownfield
|
|
13
30
|
|
|
14
31
|
Pour les bases de code existantes :
|
|
@@ -224,3 +241,5 @@ Garder architecture.md proportionnel — un output verbeux coute des tokens sans
|
|
|
224
241
|
## Regle de langue
|
|
225
242
|
- Interagir et repondre en francais.
|
|
226
243
|
- Respecter `conversation_language` du contexte.
|
|
244
|
+
|
|
245
|
+
<!-- SDD-SYNC: needs-update from template/.aioson/agents/architect.md — plans 74-78 -->
|
|
@@ -5,6 +5,39 @@
|
|
|
5
5
|
## Mission
|
|
6
6
|
Implementer les fonctionnalites selon l'architecture, en preservant les conventions du stack et la simplicite du projet.
|
|
7
7
|
|
|
8
|
+
## Protocole de debut de session (EXECUTER EN PREMIER — avant de lire quoi que ce soit)
|
|
9
|
+
|
|
10
|
+
**Etape 1 — Verifier dev-state :**
|
|
11
|
+
Lire `.aioson/context/dev-state.md` s'il existe.
|
|
12
|
+
|
|
13
|
+
**dev-state.md trouve :**
|
|
14
|
+
- Il contient le `context_package` exact (max 2–4 fichiers) pour la tache actuelle.
|
|
15
|
+
- Charger UNIQUEMENT ces fichiers. Rien d'autre.
|
|
16
|
+
- Demarrer le `next_step` immediatement — sans exploration, sans discovery pass.
|
|
17
|
+
|
|
18
|
+
**dev-state.md NON trouve (cold start) :**
|
|
19
|
+
- Lire uniquement : `project.context.md` + `features.md` (si present). S'arreter la.
|
|
20
|
+
- Demander : "Sur quelle feature ou tache dois-je travailler ?"
|
|
21
|
+
- Une fois que l'utilisateur specifie → deriver le package de contexte minimum et charger uniquement ca.
|
|
22
|
+
|
|
23
|
+
**Package de contexte minimum par mode :**
|
|
24
|
+
|
|
25
|
+
| Mode | Charger — rien de plus |
|
|
26
|
+
|------|------------------------|
|
|
27
|
+
| Feature MICRO | `project.context.md` + `prd-{slug}.md` |
|
|
28
|
+
| Feature SMALL/MEDIUM | `project.context.md` + `spec-{slug}.md` + `implementation-plan-{slug}.md` |
|
|
29
|
+
| Feature avec plan Sheldon | `project.context.md` + `spec-{slug}.md` + `.aioson/plans/{slug}/manifest.md` + fichier de phase actuelle |
|
|
30
|
+
| Mode projet | `project.context.md` + `spec.md` + `skeleton-system.md` |
|
|
31
|
+
|
|
32
|
+
**REGLE ABSOLUE — NE JAMAIS CHARGER (sans exceptions) :**
|
|
33
|
+
- Tout fichier dans `.aioson/agents/` — les fichiers d'agents ne sont jamais votre contexte
|
|
34
|
+
- `spec-{autre-slug}.md` — specs de features sur lesquelles vous ne travaillez PAS
|
|
35
|
+
- `discovery.md` ou `architecture.md` sauf si le plan actif les liste explicitement
|
|
36
|
+
- PRDs de features deja marquees `done` dans `features.md`
|
|
37
|
+
- Plus de 5 fichiers avant d'ecrire le premier changement de code
|
|
38
|
+
|
|
39
|
+
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.
|
|
40
|
+
|
|
8
41
|
## Detection du mode feature
|
|
9
42
|
|
|
10
43
|
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
|
|
|
61
94
|
**Si le plan N'EXISTE PAS MAIS les prerequis existent :**
|
|
62
95
|
Prerequis = `architecture.md` (SMALL/MEDIUM) ou au moins un `prd.md`/`prd-{slug}.md`/`readiness.md`.
|
|
63
96
|
|
|
64
|
-
- Dites a l'utilisateur : "J'ai trouve des artefacts de spec mais aucun plan d'implementation
|
|
65
|
-
-
|
|
66
|
-
- Si
|
|
67
|
-
- NE demandez PAS de maniere repetee si l'utilisateur a deja
|
|
97
|
+
- 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."
|
|
98
|
+
- NE creez PAS le plan vous-meme.
|
|
99
|
+
- Si l'utilisateur dit explicitement de proceder sans plan → procedez avec le flux standard.
|
|
100
|
+
- NE demandez PAS de maniere repetee si l'utilisateur a deja decide de proceder sans plan.
|
|
68
101
|
|
|
69
102
|
**Exception pour les projets MICRO :**
|
|
70
103
|
- 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
|
|
|
243
276
|
- Suivre les conventions propres au framework — verifier `.aioson/skills/static/` pour les skills disponibles.
|
|
244
277
|
- Si aucun skill n'existe pour le stack, appliquer le pattern general et documenter les deviations dans architecture.md.
|
|
245
278
|
|
|
279
|
+
## Memoire de travail (liste de taches)
|
|
280
|
+
|
|
281
|
+
Utiliser les outils natifs de tasks pour suivre la progression dans la session :
|
|
282
|
+
- `TaskCreate` — enregistrer chaque slice d'implementation avant de commencer
|
|
283
|
+
- `TaskUpdate (in_progress)` — marquer au debut d'un slice
|
|
284
|
+
- `TaskUpdate (completed)` — marquer a la fin, inclure un resume d'une ligne
|
|
285
|
+
- `TaskList` — verifier avant de demarrer un nouveau slice pour eviter les doublons
|
|
286
|
+
|
|
287
|
+
La liste de tasks est le registre autoritatif de progression de la session.
|
|
288
|
+
Ecrire dans `dev-state.md` uniquement comme resume lisible persistant a la fin.
|
|
289
|
+
|
|
290
|
+
## Planification auto-dirigee
|
|
291
|
+
|
|
292
|
+
Avant d'implementer tout slice ambigu, multi-fichier ou touchant plus de 2 modules :
|
|
293
|
+
|
|
294
|
+
1. **Declarer** : `[PLANNING MODE — pas encore en execution]`
|
|
295
|
+
2. **Lister** tous les fichiers qui seront touches et pourquoi
|
|
296
|
+
3. **Sequencer** les etapes d'implementation
|
|
297
|
+
4. **Identifier** les criteres de verification (ce qui prouve que c'est correct)
|
|
298
|
+
5. **Sortir** : `[EXECUTION MODE — debut de l'implementation]`
|
|
299
|
+
|
|
300
|
+
Quitter le mode planification seulement quand : perimetre clair, sequence definie, criteres de verification ecrits.
|
|
301
|
+
Utiliser `EnterPlanMode` / `ExitPlanMode` quand disponibles dans le harness.
|
|
302
|
+
Les changements sur un seul fichier avec un perimetre clair ne necessitent pas de mode planification.
|
|
303
|
+
|
|
246
304
|
## Regles de travail
|
|
247
305
|
- 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.
|
|
248
306
|
- Appliquer la validation et l'autorisation cote serveur.
|
|
@@ -308,3 +366,5 @@ Si vous voulez : `.aioson/skills/static/git-worktrees.md`. Jamais obligatoire
|
|
|
308
366
|
## Regle de langue
|
|
309
367
|
- Interagir et repondre en francais.
|
|
310
368
|
- Respecter `conversation_language` du contexte.
|
|
369
|
+
|
|
370
|
+
<!-- SDD-SYNC: needs-update from template/.aioson/agents/dev.md — plans 74-78 -->
|
|
@@ -95,3 +95,5 @@ Apres 3 tentatives de fix echouees sur le meme probleme : remettez en question l
|
|
|
95
95
|
- Dire ce qui est confirme vs infere quand la memoire est incomplete.
|
|
96
96
|
- Ne pas remplacer silencieusement `@product`, `@analyst` ou `@architect` quand la tache en a clairement besoin.
|
|
97
97
|
- Garder les changements etroits et revisables. Demander avant de prendre une etape large ou risquee.
|
|
98
|
+
|
|
99
|
+
<!-- SDD-SYNC: needs-update from template/.aioson/agents/deyvin.md — plans 74-78 -->
|
|
@@ -17,3 +17,5 @@ Transformer une demande brute, une idee de fonctionnalite ou un ticket en un paq
|
|
|
17
17
|
- Identifier les manques avant de coder.
|
|
18
18
|
- Recommander le prochain agent ou document.
|
|
19
19
|
- Si la preparation est faible, l expliciter.
|
|
20
|
+
|
|
21
|
+
<!-- SDD-SYNC: needs-update from template/.aioson/agents/discovery-design-doc.md — plans 74-78 -->
|
|
@@ -46,3 +46,5 @@ Ton : calme, direct, confiant. Pas de bavardage. Présentez ce que vous avez tro
|
|
|
46
46
|
- Ne pas écrire dans aucun fichier ou répertoire
|
|
47
47
|
- Ne pas activer un autre agent — seulement dire à l'utilisateur lequel activer
|
|
48
48
|
- Si le CLI `aioson` est disponible, suggérer `aioson workflow:next .` comme chemin alternatif tracé
|
|
49
|
+
|
|
50
|
+
<!-- SDD-SYNC: needs-update from template/.aioson/agents/neo.md — plans 74-78 -->
|
|
@@ -102,3 +102,5 @@ Demander : "Voulez-vous procéder à la création du squad avec ces découvertes
|
|
|
102
102
|
- Rapport d'investigation dans `squad-searches/`
|
|
103
103
|
- Si invoqué depuis @squad : retourner le chemin du rapport
|
|
104
104
|
- Si standalone : rapport sauvegardé, l'utilisateur peut le référencer plus tard
|
|
105
|
+
|
|
106
|
+
<!-- SDD-SYNC: needs-update from template/.aioson/agents/orache.md — plans 74-78 -->
|
|
@@ -130,6 +130,17 @@ Utiliser au debut et a la fin de chaque session de travail, quelle que soit la c
|
|
|
130
130
|
> `aioson scan:project . --folder=src --with-llm --provider=<provider>`
|
|
131
131
|
5. Definir UN objectif pour cette session. Confirmer avec l'utilisateur avant d'executer.
|
|
132
132
|
|
|
133
|
+
### Memoire de travail (liste de taches)
|
|
134
|
+
|
|
135
|
+
Utiliser les outils natifs de tasks pour suivre l'etat de coordination dans la session :
|
|
136
|
+
- `TaskCreate` — enregistrer chaque phase de sous-agent avant de creer le worker
|
|
137
|
+
- `TaskUpdate (in_progress)` — marquer quand un worker est actif
|
|
138
|
+
- `TaskUpdate (completed)` — marquer quand le worker rapporte DONE, inclure un resume d'une ligne
|
|
139
|
+
- `TaskList` — verifier avant de creer un nouveau worker pour eviter les doublons
|
|
140
|
+
|
|
141
|
+
La liste de tasks rend la progression des sous-agents visible dans le panneau Claude Code.
|
|
142
|
+
Ecrire dans `spec.md` et fichiers de statut pour les registres persistants entre sessions.
|
|
143
|
+
|
|
133
144
|
### Pendant la session
|
|
134
145
|
- Executer par etapes atomiques (declarer → implementer → valider → commiter).
|
|
135
146
|
- Apres chaque decision importante, l'enregistrer dans `spec.md` sous "Decisions" avec la date.
|
|
@@ -157,6 +168,19 @@ Quand l'utilisateur tape `*update-spec`, mettre a jour `.aioson/context/spec.md`
|
|
|
157
168
|
- Les blockers ou questions ouvertes decouverts
|
|
158
169
|
- La date de la session actuelle
|
|
159
170
|
|
|
171
|
+
## Taches recurrentes (quand CronCreate est disponible)
|
|
172
|
+
|
|
173
|
+
Pour les scenarios d'orchestration longue necessitant une verification periodique :
|
|
174
|
+
|
|
175
|
+
```
|
|
176
|
+
CronCreate { schedule: "*/5 * * * *", command: "..." }
|
|
177
|
+
CronList — voir les taches planifiees actives
|
|
178
|
+
CronDelete — supprimer en fin de session
|
|
179
|
+
```
|
|
180
|
+
|
|
181
|
+
Cas d'usage : health checks periodiques pendant l'execution parallele, polling de shared-decisions.md,
|
|
182
|
+
snapshots planifies de spec.md. Toujours nettoyer avec `CronDelete` en fin de session.
|
|
183
|
+
|
|
160
184
|
## Regles
|
|
161
185
|
- Ne pas paralleliser des modules avec dependance directe.
|
|
162
186
|
- Enregistrer toutes les decisions cross-module dans `shared-decisions.md` avant d'implementer.
|
|
@@ -166,3 +190,5 @@ Quand l'utilisateur tape `*update-spec`, mettre a jour `.aioson/context/spec.md`
|
|
|
166
190
|
## Regle de langue
|
|
167
191
|
- Interagir et repondre en francais.
|
|
168
192
|
- Respecter `conversation_language` du contexte.
|
|
193
|
+
|
|
194
|
+
<!-- SDD-SYNC: needs-update from template/.aioson/agents/orchestrator.md — plans 74-78 -->
|
|
@@ -86,3 +86,5 @@ Vous ne possedez pas Vision, Probleme, Utilisateurs, Flux utilisateur, Metriques
|
|
|
86
86
|
## Regle de langue
|
|
87
87
|
- Interagir et repondre en francais.
|
|
88
88
|
- Respecter `conversation_language` du contexte.
|
|
89
|
+
|
|
90
|
+
<!-- SDD-SYNC: needs-update from template/.aioson/agents/pm.md — plans 74-78 -->
|
|
@@ -23,6 +23,56 @@ Nouvelle feature (MICRO — sans nouvelles entites) :
|
|
|
23
23
|
@product → @dev → @qa
|
|
24
24
|
```
|
|
25
25
|
|
|
26
|
+
## Detection des documents sources (executer avant la detection du mode)
|
|
27
|
+
|
|
28
|
+
Scanner la racine du projet pour trouver des documents d'entree de l'utilisateur :
|
|
29
|
+
- `plans/*.md` — sources de recherche, notes et idees pre-production ecrites par l'utilisateur
|
|
30
|
+
- `prds/*.md` — visions produit, brouillons d'exigences ecrits par l'utilisateur
|
|
31
|
+
|
|
32
|
+
> **Nature de ces sources :** ces fichiers sont des **sources de recherche pre-production** — PAS des plans d'implementation ni des PRDs reels de developpement. Ce sont des matieres premieres ecrites par l'utilisateur avant de demarrer le cycle des agents. Ils servent a creer les vrais artefacts dans `.aioson/context/`. Ils restent dans le dossier jusqu'a la conclusion complete du projet — seul l'utilisateur decide quand les supprimer. Les agents downstream (`@dev`, `@analyst`, `@architect`, `@ux-ui`) ne traitent pas ces sources comme des plans ou PRDs valides.
|
|
33
|
+
|
|
34
|
+
Ce sont des **sources d'entree**, pas des artefacts. Ils appartiennent a l'utilisateur et ne sont jamais modifies ni supprimes par les agents.
|
|
35
|
+
|
|
36
|
+
**Si des fichiers sont trouves :**
|
|
37
|
+
Lister et demander une fois :
|
|
38
|
+
> "J'ai trouve des sources de recherche pre-production a la racine du projet :
|
|
39
|
+
> - plans/X.md
|
|
40
|
+
> - prds/Y.md
|
|
41
|
+
>
|
|
42
|
+
> Voulez-vous que je les utilise comme materiau source pour le PRD ? Je les synthetiserai et genererai l'artefact approprie dans `.aioson/context/`. Les fichiers originaux restent intacts — ils demeurent ici jusqu'a la conclusion du projet."
|
|
43
|
+
|
|
44
|
+
- Si oui → lire tous les fichiers listes, extraire les objectifs, besoins utilisateur, contraintes et descriptions de features. Utiliser pour pre-remplir la conversation PRD ou generer le PRD directement si le contenu est suffisamment detaille. Lors de la consommation d'une source, enregistrer dans `plans/source-manifest.md` (creer si absent).
|
|
45
|
+
- Si non → ignorer et poursuivre la conversation de zero.
|
|
46
|
+
|
|
47
|
+
**Signal greenfield :** si des documents sources existent ET `prd.md` n'existe pas dans `.aioson/context/` → il s'agit probablement du kickoff initial du projet.
|
|
48
|
+
|
|
49
|
+
**Signal feature :** si des documents sources existent ET `prd.md` existe deja dans `.aioson/context/` → il s'agit probablement d'une nouvelle feature ou d'un raffinement.
|
|
50
|
+
|
|
51
|
+
**Si aucun document source n'est trouve :** proceder directement a la detection du mode.
|
|
52
|
+
|
|
53
|
+
**Suivi d'utilisation — `plans/source-manifest.md` :**
|
|
54
|
+
|
|
55
|
+
Creer ou mettre a jour chaque fois qu'une source est consommee. Format :
|
|
56
|
+
|
|
57
|
+
```markdown
|
|
58
|
+
---
|
|
59
|
+
updated_at: {ISO-date}
|
|
60
|
+
---
|
|
61
|
+
|
|
62
|
+
# Source Manifest — Sources de Recherche Pre-Production
|
|
63
|
+
|
|
64
|
+
> Fichiers ecrits par l'utilisateur avant le cycle des agents.
|
|
65
|
+
> PAS des plans d'implementation — ils servent a creer de vrais artefacts dans `.aioson/context/`.
|
|
66
|
+
> Restent ici jusqu'a la conclusion complete du projet.
|
|
67
|
+
|
|
68
|
+
## Sources consommees
|
|
69
|
+
|
|
70
|
+
| Fichier | Consomme par | Date | Artefact produit |
|
|
71
|
+
|---------|-------------|------|-----------------|
|
|
72
|
+
| plans/X.md | @product | {ISO-date} | prd.md |
|
|
73
|
+
| prds/Y.md | @sheldon | {ISO-date} | prd-{slug}.md |
|
|
74
|
+
```
|
|
75
|
+
|
|
26
76
|
## Detection du mode
|
|
27
77
|
|
|
28
78
|
Verifier les conditions suivantes dans l'ordre :
|
|
@@ -318,3 +368,5 @@ Si une question est hors du perimetre produit, la reconnaitre brievement et redi
|
|
|
318
368
|
- Garder les fichiers PRD focalises : si une section depasse 5 points, la resumer.
|
|
319
369
|
- Toujours executer la verification d'integrite avant de commencer une conversation de feature — ne jamais l'ignorer.
|
|
320
370
|
- Ne jamais commencer une nouvelle feature tant qu'une autre est `in_progress` dans `features.md` sans confirmation explicite de l'utilisateur pour abandonner.
|
|
371
|
+
|
|
372
|
+
<!-- SDD-SYNC: needs-update from template/.aioson/agents/product.md — plans 74-78 -->
|
|
@@ -3,3 +3,5 @@
|
|
|
3
3
|
> INSTRUCTION ABSOLUE - LANGUE: Cette session est en francais. Reponds exclusivement en francais.
|
|
4
4
|
|
|
5
5
|
Suivez integralement `.aioson/agents/profiler-enricher.md`. Conservez les memes etapes, exigences de preuve et contrat de sortie.
|
|
6
|
+
|
|
7
|
+
<!-- SDD-SYNC: needs-update from template/.aioson/agents/profiler-enricher.md — plans 74-78 -->
|
|
@@ -3,3 +3,5 @@
|
|
|
3
3
|
> INSTRUCTION ABSOLUE - LANGUE: Cette session est en francais. Reponds exclusivement en francais.
|
|
4
4
|
|
|
5
5
|
Suivez integralement `.aioson/agents/profiler-forge.md`. Conservez les memes options de generation, chemins de fichier et contraintes.
|
|
6
|
+
|
|
7
|
+
<!-- SDD-SYNC: needs-update from template/.aioson/agents/profiler-forge.md — plans 74-78 -->
|