Verbara Templates (T1–T10)
Verbara Templates (T1–T10)
Section titled “Verbara Templates (T1–T10)”Plantillas canónicas del ecosistema Verbara. Fuente de verdad versionada por PR.
Accesibles vía Read directo (Claude Code), Obsidian Templater, o el sitio Starlight.
Cuándo usar cada una
Section titled “Cuándo usar cada una”| # | Template | Cuándo | Quién la genera |
|---|---|---|---|
| T1 | Research | Investigar opciones antes de decidir | Manual / Claude |
| T2 | Spec | Definir QUÉ construir (RFC 2119 + producto) | OpenSpec /opsx:propose + extensiones Verbara |
| T3 | Plan | Definir CÓMO construir | Claude Code Plan Mode |
| T4 | ADR | Decisión técnica duradera (“cómo”) | Manual / Claude → docs/decisions/ |
| T5 | Release Checklist | Antes/durante/después de un release | Manual por release |
| T6 | Bug Report | Tracking de bug cross-repo | Manual / Claude |
| T7 | Dependabot Triage | Triage mensual de PRs de dependencias | Mensual |
| T8 | Onboarding Checklist | Onboarding de nuevo dev | Por dev nuevo |
| T9 | Retrospective | Post-milestone, mejora continua | Por milestone |
| T10 | PDR | Decisión de producto (“qué construir / NO”) | Manual → docs/product-decisions/ |
ADR vs PDR
Section titled “ADR vs PDR”- ADR (T4) responde “¿cómo lo construimos?” (técnico). Vive en
docs/decisions/. - PDR (T10) responde “¿qué elegimos construir / NO construir y por qué?” (producto).
Vive en
docs/product-decisions/. Evita re-litigar decisiones de producto.
Tier por tamaño (evita burocracia en cambios pequeños)
Section titled “Tier por tamaño (evita burocracia en cambios pequeños)”| Tier | Cuándo | Capas obligatorias |
|---|---|---|
| GRANDE | Cross-repo, >3 días, o decisión de producto | Vision→Roadmap→Problem→Spec→Plan→Implement→Verify→Ship→Retro |
| MEDIANO | 1 repo, 1-3 días | Roadmap item→Spec→Plan→Implement→Verify→Ship |
| PEQUEÑO | Bug fix, <1 día | Spec (light)→Implement→Verify→Ship |
Relación con OpenSpec
Section titled “Relación con OpenSpec”OpenSpec genera la base de T2 (Requirements + Scenarios) y T3. Las extensiones Verbara
(frontmatter de producto, Problem, Architectural Risk) se inyectan vía rules: en
openspec/config.yaml. T1 y T4–T10 son íntegramente Verbara — OpenSpec no cubre research,
ADRs, PDRs, releases, bugs, triage, onboarding ni retros.