dai ayuda a los equipos a desarrollar software en menos tiempo y con más calidad — sacándose de encima la burocracia para enfocarse en lo que importa: pensar, documentar y construir. La IA acelera; dai mantiene el control y la trazabilidad.
Desarrollar con IA es rápido, pero sin método el código se desconecta del por qué se escribió, aparece el vibe coding, y el qué (negocio) se mezcla con el cómo (técnica). dai es una metodología asistida por IA que ataca eso combinando tres piezas:
- 🖥️ El CLI
dai— un comando para cada fase del desarrollo (definir, linkear, verificar, revisar, publicar). Mantiene atado el requerimiento al código, del principio al fin. - 🧩 OpenSpec — convierte el qué en un cómo (diseño + tareas) con ayuda de agentes de IA, sin que nadie escriba la burocracia técnica a mano.
- 🤖 La IA — para debatir, analizar, conectarse a tus herramientas por MCP (Jira, ClickUp, GitHub, Gitlab) y automatizar el papeleo, para que te enfoques en documentar y construir.
Juntas hacen que la IA potencie tu desarrollo sin perder el control: todo lo que se construye queda linkeado a por qué se construyó, y la máquina te avisa sola cuando algo se desincroniza. Del solo developer a un equipo entero de desarrollo — el mismo método, con Claude, Copilot o Cursor.
- Separa el QUÉ del CÓMO, con dueños distintos, linkeados ida y vuelta.
- El link se autora una sola vez (en el código,
implements.yaml); la cobertura inversa se genera, nunca se mantiene a mano. @version= número + hash de criterios: cuando el QUÉ cambia, los CÓMO atrasados se marcan solos.
Requiere Node ≥ 18 (el CLI no tiene dependencias). Elige tu rol:
Trabajas en tu asistente (Claude Desktop / Copilot en el IDE), no en la terminal. Una vez, deja las skills disponibles:
npm i -g @dforce2055/dai # el CLI
dai install # skills de IA → Claude y Cursor (global por defecto)Y después, en el chat del asistente, según lo que tengas:
/grill-user-story # una historia → te interroga y la publica en el tracker
/grill-epic # algo grande → una épica partida en varias US
/doc-to-backlog <PDF/Word> # un documento de análisis → backlog candidato de épicas + US
/grill-intent # (opcional) Gate 0: ¿es el problema correcto, antes de escribir?
Las skills te interrogan hasta que la historia es testeable (nunca inventan requerimientos: los sacan a preguntas), y la publican en el tracker que configuraste (
DAI_PMen el.env): por el MCP de Jira/ClickUp si está conectado, o condai publish <us.md>si no (crea el issue vía token). Tú respondes y decides.
Una vez, preparas el repo:
npm i -g @dforce2055/dai
cd mi-repo && dai init # bootstrap: skills + tracker + OpenSpec + PR template
# completa el token del tracker en .env (o DAI_PM=md para probar sin credenciales)
dai doctor # verifica que todo quedó en su lugarY por cada US, el ciclo completo:
dai link-us <ID> # trae la US del tracker → branch + implements.yaml/opsx:explore → /opsx:propose # exploras la solución y armas el diseño + tareas
/opsx:apply · /tdd # implementas con tests primero → genera los commits
dai check # ¿tu código sigue al día con la US? ✅ / ⚠️ atrasado
# revisas tu propio código + smoke test local antes de la PR
dai pr --assignee <compañero> # crea la PR precargada y se la asigna a un compañero/dai-review <PR> # tu compañero deja un review estándar; un humano aprueba
dai stamp # al mergear: estampa la cobertura en el trackerGuía completa con salidas reales en docs/PROBAR.md; un caso narrado en
docs/EJEMPLO-END-TO-END.md.
flowchart TD
subgraph QUE["🟡 EL QUÉ · funcional (PO / analista)"]
A["💡 Idea / problema"] -->|"/grill-user-story 🤖"| B["📋 US testeable"]
B -->|"dai publish ⚙️ · o MCP"| C[("🎯 US en el tracker (Jira / ClickUp)")]
end
subgraph COMO["🔵 EL CÓMO · técnico (dev)"]
C -->|"dai link-us ⚙️"| D["🌿 branch + implements.yaml"]
D -->|"/opsx:propose 🤖"| E["📐 design + tasks"]
E -->|"/tdd 🤖"| F["🧪 código + tests"]
F -->|"dai check ⚙️"| G{"¿al día?"}
G -->|"✅ sí"| H["🔀 dai pr ⚙️"]
H -->|"/dai-review 🤖 + 👤 firma"| I["✅ merge"]
I -->|"dai stamp ⚙️"| J[("🎯 cobertura estampada")]
end
G -.->|"⚠️ el QUÉ cambió (@version)"| C
Leyenda: 🤖 skill de IA · ⚙️ comando
dai· 👤 un humano firma · 🎯 el tracker. La línea punteada es la detección de drift: si el PO edita la US,dai checklo marca⚠️ y volvés a sincronizar. (El diagrama se renderiza en GitHub; el detalle, en la tabla.)
| # | Fase | Cómo | Quién |
|---|---|---|---|
| 1 | Instalar el CLI | npm i -g @dforce2055/dai (o npm link en dev) · dai --version |
dev |
| 2 | Bootstrap del repo | dai init → .dai + Claude/Copilot/Cursor + config + PR template |
dev/lead |
| 3a | Definir el QUÉ | /grill-user-story (una US) · /grill-epic (algo grande) · /doc-to-backlog (un doc) — te interrogan hasta una US testeable |
PO / analista |
| 3b | Publicar la US | la skill la sube al tracker vía MCP, o con dai publish <us.md> (crea el issue vía token, sin MCP) → devuelve el key |
PO / IA |
| 4 | Linkear la US | dai link-us <ID> → branch + openspec/changes/<id>/implements.yaml |
dev |
| 5 | Verificar / listar | dai check (¿al día?) · dai ls (qué implementa el repo) |
dev |
| 6 | Resincronizar (si el PO editó la US) | dai link-us <ID> --resync |
dev |
| 7 | Diseñar el CÓMO | en el asistente: /opsx:explore → /opsx:propose → design + tasks |
dev + IA |
| 8 | Implementar | /opsx:apply → implementa la US con TDD y genera los commits |
dev + IA |
| 9 | Code review propio | revisas tu implementación (correctitud + calidad) antes de la PR | dev |
| 10 | Smoke test | pides al agente un smoke local del flujo | dev + IA |
| 11 | Crear la PR | dai pr → pregunta la branch base, arma el texto, lo muestra, confirma, pushea y crea la PR/MR |
dev |
| 12 | Review de un partner | skill /dai-review <PR> deja un comentario estándar; un humano aprueba |
partner |
| 13 | Merge + estampar | al mergear: dai stamp → cobertura inversa en el tracker |
dev / CI |
| 14 | Cerrar la US | dai done → vuelve a la base, actualiza y borra la branch local (si está mergeada) |
dev |
Paso 3b (publicar): el MCP crea el issue interactivamente;
dai publishnecesita el token del tracker en.env(Jira ademásDAI_JIRA_PROJECT, ClickUpDAI_CLICKUP_LIST_ID).Paso 7 (OpenSpec):
dai initte ofrece instalarlo e inicializarlo solo. Si los comandos/opsx:*no aparecen en el asistente, reinicia el IDE (se cargan al arrancar).Paso 11 (PR): necesita un remoto git (
origin) ygh/glabautenticado. Sin remoto, dai no crea la PR (te deja el texto listo igual).
| Comando | Qué hace |
|---|---|
dai init [<repo>] |
scaffolder interactivo del repo. Flags: --for claude|copilot|both|cursor|all (asistente, default all) · --pm md|jira|clickup (tracker) · --openspec |
dai install [--global | --local <repo>] [--force] [--dry-run] [--for claude|cursor|all] |
instala/actualiza skills de IA en Claude y/o Cursor (--for all por defecto). --force re-copia aunque ya existan. Ej: dai install --local . --for cursor --force · dai install --global --for all --force |
dai sync [--dry-run] [--for <asistentes>] |
refresca skills, constitución, templates y PR template a la versión del CLI — aditivo (no pisa tu CLAUDE.md), no toca el .env ni OpenSpec. Detecta los asistentes del repo o pasás --for. --dry-run muestra qué cambiaría (ADR-0010) |
dai publish <us.md> |
crea la US en el tracker (Jira/ClickUp/md) desde un .md y devuelve el key. Es el fallback del MCP para publicar sin el asistente |
dai link-us <ID> [--us <md>] |
crea branch + implements.yaml; sin --us trae la US del tracker |
dai link-us <ID> --resync |
re-estampa el ac_hash contra la US viva (tras un |
dai check |
compara tu código vs la US viva → ✅ al día / |
dai ls [--json] |
lista las US que implementa el repo + su link al tracker |
dai pr [--assignee u] [--base b] [--draft] [--yes] |
crea TU PR/MR precargada: pregunta la branch base (default main), muestra el texto y confirma antes de publicar |
dai stamp |
estampa la cobertura inversa en el tracker (branch + commit-ancla) |
dai done [--base main] [--force] |
cierra la US: vuelve a la base, fetch --prune + pull, y borra la branch local si está mergeada (chequeo estricto; --force la borra igual). Redes: no estar en la base, sin cambios sueltos, sin commits sin pushear |
dai archive [<change>] [--skip-specs] |
funde los delta specs del change en las specs canónicas (openspec/specs/) y lo archiva. Lo corre el aprobador de la PR (gate de aprobación, ADR-0011); detecta el change activo o le pasás el nombre. Envuelve openspec archive |
dai forge comment <ref> --body-file <f> · dai forge pr <ref> |
comentar / leer una PR/MR (GitHub/GitLab) |
dai ac-hash <us.md> |
calcula el hash de los criterios de aceptación de una US |
dai doctor · dai docs <dest> · dai version |
diagnóstico del entorno (incluye version-drift del scaffold) · copiar la doc · versión (dai version avisa si tu repo quedó atrás) |
🆕 Mantené tu repo al día —
dai sync. Las skills, la constitución y los templates son un caché derivable del CLI. Cuando actualizásdai(npm i -g @dforce2055/dai),dai doctorydai versionte avisan solos si tu scaffold quedó atrás — con color y un⬆️—, ydai synclo refresca: aditivo (conserva tuCLAUDE.mdpropio), sin tocar el.envni OpenSpec. Probá sin riesgo condai sync --dry-run. El versionado es semver: patch/minor no rompen nada; solo un major pediría migración. (ADR-0010)
Skills (se invocan en el asistente): /doc-to-backlog · /grill-intent · /grill-epic · /grill-user-story · /link-us ·
/tdd · /dai-review. Config del tracker (md|jira|clickup) y tokens: en .env —
ver .env.example. Auth (SSH + tokens): ADR-0007.
dai init genera los archivos que hacen que las skills de IA (grill-user-story,
link-us, etc.) estén disponibles en tu asistente. --for elige para cuál:
| Valor | Genera | Elígelo si… |
|---|---|---|
--for claude |
.claude/skills/ + CLAUDE.md |
tu equipo usa Claude (Code / Desktop) |
--for copilot |
.github/prompts/*.prompt.md + .github/copilot-instructions.md |
tu equipo usa GitHub Copilot (en VS Code / JetBrains) |
--for cursor |
.cursor/skills/ + .cursor/rules/dai-constitution.mdc |
tu equipo usa Cursor Agent |
--for both |
Claude + Copilot | equipo mixto sin Cursor |
--for all (default) |
Claude + Copilot + Cursor | quieres dejar el repo listo para cualquier asistente |
- Combinables: pasá un subconjunto separado por coma —
--for claude,cursoro--for copilot.all= los tres ·both= Claude+Copilot. (Igual endai install, aunque ahí Copilot no aplica: no tiene skills instalables.) - Es aditivo, no destructivo: los conjuntos conviven sin pisarse (viven en carpetas distintas). La misma skill se transforma al formato de cada asistente.
- Si ejecutas
dai initsin flag, te lo pregunta de forma interactiva. - No afecta el CLI:
dai link-us/check/stampfuncionan igual con cualquier--for(o ninguno) — el flag solo prepara la invocación de skills en el asistente. - Ante la duda,
--for all: cubre a todo el equipo y no cuesta nada.
Después de dai init (con --for all):
mi-repo/
├── CLAUDE.md · Constitución del proyecto (auto-cargada por Claude)
├── .env · configurado con tu tracker (gitignored, completa el token)
├── .claude/skills/ · Las skills, locales al repo (el equipo las hereda)
│ └── doc-to-backlog · grill-intent · grill-epic · grill-user-story · link-us · tdd · dai-review
├── .github/
│ ├── copilot-instructions.md · La constitución, auto-inyectada en cada chat de Copilot
│ ├── prompts/*.prompt.md · Las mismas skills, generadas en formato Copilot
│ └── pull_request_template.md · Molde de PR/MR atado al link
├── .cursor/
│ ├── skills/ · Las mismas skills, en formato Cursor
│ └── rules/dai-constitution.mdc · Constitución always-on de Cursor
└── .dai/
├── templates/ · formato-us · epica · DoR · DoD · adr · pull-request
└── governance/ · branch-naming · ci-rules · commit-convention
Al trabajar se suma:
└── openspec/changes/<id>/ · implements.yaml (el link) + proposal · design · tasks
¿Cómo se ve un
implements.yaml? Ejemplo lleno + el árbol de dónde vive entre los artefactos de OpenSpec, en ADR-0004.
Las skills se invocan en el asistente — no en todas sus superficies (límite del asistente, no de dai):
| Asistente / superficie | ¿Skills? | Mecanismo |
|---|---|---|
| Claude Desktop | ✅ | ~/.claude/skills/ (global) — sin IDE ni consola |
| Claude Code | ✅ | ~/.claude/skills/ + .claude/skills/ del repo |
| Cursor Agent (IDE) | ✅ | .cursor/skills/*/SKILL.md + .cursor/rules/*.mdc |
| Copilot en VS Code / JetBrains | ✅ | los .github/prompts/*.prompt.md |
| Copilot CLI | ✅ | custom agents |
| Copilot app standalone / github.com chat | ❌ | los prompt files son solo-IDE |
El analista sin IDE cierra con Claude Desktop; con Copilot necesita VS Code o el Copilot
CLI. El CLI dai corre en cualquier terminal, con cualquier asistente o ninguno.
Un protocolo invariante para, sólo developer, equipos chicos y grandes, una misma ceremonia. N1 (un dev, todo local) → N2 (equipo + tracker) → N3 (muchos repos, CI que estampa). Cada capa se agrega cuando es necesario, no antes. El dev que lo usa en un equipo chico, está listo para usarlo en equipos grandes distribuidos.
docs/MANIFIESTO.md— la ley: 4 valores + 15 artículos. 5 minutos.docs/SCRUM-CON-IA.md— tu Scrum de siempre, en 10 pasos con IA.docs/EJEMPLO-END-TO-END.md— el golden path sobre una US real.docs/METODOLOGIA.md— el detalle del protocolo y el porqué.
Además: docs/glosario.md · guías por rol (po ·
dev · lead) · decisiones (ADRs) ·
landing.
dai/
├── cli/ 🖥️ el binario `dai` (Node, cero dependencias) + su suite de tests
├── docs/ 📖 la metodología: MANIFIESTO · METODOLOGIA · SCRUM-CON-IA · EJEMPLO ·
│ glosario · guias/ · detalle/ (10 pasos) · adr/ (0001–0009)
├── templates/ 🧩 los moldes (formato-us · epica · DoR · DoD · adr · pull-request)
├── skills/ 🤖 doc-to-backlog · grill-intent · grill-epic · grill-user-story · link-us · tdd · dai-review
├── governance/ 🛡️ branch-naming · ci-rules · commit-convention
├── index.html 📊 landing autocontenido (la historia); publicable por GitHub Pages
└── manifest.yaml · VERSION · install.sh (shim) · .env.example
GPLv3 (GPL-3.0-or-later) — ver LICENSE. Software libre: puedes verlo,
auditarlo, modificarlo y redistribuirlo; si distribuyes una versión modificada, tiene que
quedar también libre. Libre no es gratis: se puede cobrar por uso, soporte o desarrollo.
Detalle en ADR-0006.
Ayúdanos a mejorar dai 🌱 — es software libre y una metodología viva: se hace mejor con la comunidad. Si te sirve, cuenta tu experiencia, reporta lo que falle y propón mejoras. Toda contribución al método o a la herramienta es bienvenida. Empieza por
CONTRIBUTING.md.
dai se apoya en ideas y aprendizajes de la comunidad. En particular, gracias a Matt Pocock por su aporte con las skills y por su canal de YouTube explicándolas — su trabajo nos ayudó a construir esta herramienta.
Seguridad: SECURITY.md · Conducta: CODE_OF_CONDUCT.md