docs: dod_evidence_schema templates + READMEs (issue 0114)

- docs/templates/issue.md and docs/templates/flow.md include the optional dod_evidence_schema: block with realistic example items. - dev/issues/README.md and dev/flows/README.md document the schema, kinds by example, validation rules and the fn doctor dod entrypoint. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-18 18:13:02 +02:00
parent 030e44b027
commit 0f72cc8ad3
4 changed files with 235 additions and 0 deletions
@@ -0,0 +1,78 @@
+---
+id: "NNNN"
+title: "<titulo corto del issue>"
+status: pendiente              # pendiente | in-progress | bloqueado | completado | descartado
+type: feature                  # feature | bugfix | refactor | docs | chore | research | infra
+domain:
+  - <dominio>                  # ver dev/TAXONOMY.md (meta, cpp-stack, kanban, trading, ...)
+scope: registry-only           # registry-only | app:<id> | flow:<NNNN>
+priority: media                # critica | alta | media | baja
+depends: []                    # ["0099", ...] (IDs de issues bloqueantes)
+blocks: []                     # ["0120", ...] (IDs que este issue desbloquea)
+related: []
+created: 2026-05-18
+updated: 2026-05-18
+tags: []
+
+# OPCIONAL (issue 0114): contrato de evidencia DoD canonico.
+# Cada item es una prueba concreta que debe quedar capturada al cerrar el issue.
+# kind in {screenshot, log, url, cmd}. expected NO vacio. id unico.
+dod_evidence_schema:
+  - id: surface_1_board_drag
+    kind: screenshot
+    expected: "kanban_cpp board con card en columna Doing (agent)"
+    required: true
+  - id: backend_health
+    kind: cmd
+    expected: "curl -fsS http://localhost:8403/api/health == 200"
+    required: true
+  - id: timeline_entry
+    kind: url
+    expected: "http://localhost:8486/api/runs?app=kanban_cpp devuelve >=1 run"
+    required: false
+  - id: agent_log
+    kind: log
+    expected: "agent_runs/<run_id>/agent.log contiene 'workflow done'"
+    required: true
+---
+# NNNN — <titulo corto del issue>
+
+**Status:** pendiente
+**Created:** 2026-05-18
+**Type:** feature
+**Priority:** media
+**Domain:** <dominio>
+**Scope:** registry-only
+**Depends:** —
+**Blocks:** —
+
+## Problema
+
+<que esta fallando o que falta y por que importa>
+
+## Objetivo
+
+<criterio observable de cuando el issue esta hecho>
+
+## Plan
+
+1. ...
+2. ...
+
+## Acceptance
+
+- [ ] check 1
+- [ ] check 2
+
+## Definition of Done
+
+- [ ] **Repetibilidad**: pasa N veces consecutivas sin intervencion manual.
+- [ ] **Observabilidad**: queda trazado en call_monitor + dashboard correspondiente.
+- [ ] **User-facing**: <accion concreta del humano + lugar exacto donde ve el output>.
+- [ ] **User-facing repeat**: el humano vuelve manana y ve datos frescos sin conocer el issue.
+- [ ] **User-facing onboarding**: parrafo en `## Notas` que explica "para ver/usar esto: hacer X".
+- [ ] **User-facing latencia**: el humano percibe el cambio en <X segundos|minutos>.
+
+## Notas
+
+<hallazgos, comandos para reproducir, parrafo onboarding>