Files
fn_registry/docs/templates/issue.md
T
egutierrez 581d0f0a0e 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

79 lines
2.4 KiB
Markdown

---
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>