Agentic Dev Boilerplate
The dev workflow, but AI runs it. From PRD to Jira stories to staging deploy.
bunx create-agentic-dev@latest mi-proyectoUn solo comando: descarga el template, limpia el historial git, renombra el proyecto y pasa a bun setup, que abre una página local para configurar el resto.
AI works, human decides
El agente opera tu stack de punta a punta; tú defines el producto y apruebas en los checkpoints.
Tú
Defines el producto y apruebas en cada checkpoint
El agente
Planifica, implementa, revisa y despliega con skills por fase
Tu stack
- Tú decides: cada gate del pipeline espera tu OK antes de seguir.
- La IA opera: transiciona tickets en Jira, abre PRs, corre tests y despliega a staging.
- Memoria entre sesiones: .session/ guarda el estado, retomar un sprint es un resume, no un re-onboarding.
Un story de punta a punta
Así se ve una corrida de /sprint-development sobre un ticket real: del resume de estado al Ready For QA.
claude · mi-proyecto
/sprint-development SCRUM-88
Phase 0: retomo el estado de .session/ y consulto /project-context dev-roadmap. SCRUM-88 sin bloqueos, epic en curso.
S1 · Planning (sonnet): implementation plan de 4 pasos para el descuento en el order summary.
Forecast: 6 archivos, ~2h, riesgo bajo
esperando tu OKacli jira workitem transition(start_working SCRUM-88 → In Progress)
Edit(lib/checkout/order-summary.ts (+42 −7))
bun run test(suite de checkout)
31 pass, 0 fail · type-check ok
gh pr create(feat(checkout): apply discount at order summary → #142)
S3 · Code Review (opus, adversarial): 1 MAJOR (descuento aplicado después del impuesto) y 1 NIT.
Edit(fix del MAJOR: orden de cálculo impuesto/descuento)
Re-review: findings resueltos · Spec Matrix con los AC cubiertos
gh pr merge --squash(#142 → staging)
acli jira workitem transition(SCRUM-88 → Ready For QA)
Story entregado · estado persistido en .session/
5 stages con gates humanos
Planning con sonnet, review adversarial con opus y dos pausas donde nada avanza sin tu aprobación.
Phase 0
resume + roadmap
S1 · Planning
sonnet
Forecast gate
tú apruebas
S2 · Implementation
código + tests
S3 · Code Review
opus adversarial
Spec Matrix
AC cubiertos
S4 · Staging
deploy
QA + aprobación
humano
S5 · Producción
gated
El agente opera Jira y GitHub
Transiciones de tickets, PRs, checks y merges sin que abras un board ni un formulario.
upex.atlassian.net/jira/software/projects/SCRUM/boards/1
Proyecto SCRUM
Sprint 14 · activoReady For Dev
1Cupones por volumen en el carrito
In Progress
1Webhook de pagos con reintentos
In Review
1Filtros del historial de órdenes
Ready For QA
1Descuento en el order summary
github.com/tu-org/tu-proyecto/pull/142
feat(checkout): apply discount at order summary #142
quiere mergear feat/SCRUM-88-discount-order-summary en staging
claude · reviewer adversarial aprobó estos cambios
1 MAJOR resuelto: el descuento se aplicaba después del impuesto. AC cubiertos, aprobado.
Todos los checks pasaron
- lintSuccessful
- type-checkSuccessful
- unit testsSuccessful
- Spec MatrixSuccessful
El conocimiento vive separado
AGENTS.md entra en cada sesión (Claude Code lo recibe a través del shim CLAUDE.md); el resto se carga bajo demanda según lo que la corrida necesita.
AGENTS.md
núcleo que se carga en cada sesión (CLAUDE.md es un shim)
./Skills
instrucciones de cada workflow
.agents/skills/Variables
proyecto + manifiesto Jira
.agents/Hechos
lo que es cierto del producto
.context/Estado
resume entre sesiones
.session/hechos, instrucciones, variables y estado viven separados: la IA carga solo lo que necesita
Todo incluido en el scaffold
Del primer bunx al primer deploy: skills, MCPs, instalador, multi-harness, artefactos y automatización desatendida.
Skills por fase
Foundation, product management, sprint development, git, unit testing, contexto de negocio y tooling: cada fase del ciclo tiene su skill. La lista completa es el registro .agents/skills/REGISTRY.md.
Skills con modos, sin commands
No se distribuye ningún command: una skill se invoca por su nombre más un modo (/project-context dev-roadmap, /jira-administration components). En OpenCode y Codex nombras la skill y el modo en prosa.
MCPs + acli
Los servidores declarados en .mcp.json (context7, supabase y n8n) activos desde el día uno; la búsqueda web se conecta a nivel del harness. Atlassian es opt-in: el agente opera Jira vía acli.
Cadena de artefactos completa
Constitution → PRD → DESIGN.md → SRS → Discovery → Epic → Story + AC → Implementation Plan → Code. Nada se implementa sin trazabilidad hacia arriba.
Máquina Jira de 11 estados
Backlog → Shift-Left QA → Estimation → Ready For Dev → In Progress → In Review → Ready For QA → In Test → QA Approved → Ready For Release → Deployed to Production.
Autonomous delivery
Corridas desatendidas con Lock → Audit → Select → Execute → Close: el agente elige el próximo ticket desbloqueado y lo entrega solo.
Model routing orientativo
Preferencias por etapa: opus para foundation y review, sonnet para planning e implementación, haiku para el cierre mecánico. Quien despacha puede usarlas para rutear; no son obligatorias.
git-flow-master · 7 estrategias
Detecta si el repo corre solo-main, main + integración, trunk-based, GitFlow, GitHub Flow, GitLab Flow o multi-branch enterprise, y adapta cada commit y PR.
Instalador con página local
bun setup abre una página local con las fases como línea de tiempo y cada pregunta como tarjeta; con --headless se queda en la terminal. Un re-run retoma donde quedó.
Una fuente, tres harnesses
Claude Code, OpenCode y Codex leen las mismas instrucciones y skills: AGENTS.md y .agents/skills/ son la fuente; CLAUDE.md y .claude/skills se generan a partir de ellas.
Actualización con bun sync
Sync por archivo contra el template, con --dry-run para previsualizar y --rollback para volver atrás. Cada diferencia con upstream queda en una tabla de paridad: conservar lo tuyo, tomar upstream o fusionar.
Adopta una app existente
bunx create-agentic-dev@latest --adopt instala la capa agéntica sin pisar lo que la app ya tiene. En la v1 cubre Next.js sobre Postgres (Supabase o propio) con bun.
Cada skill, explicada
No son cursos: son decks explicativos por skill, publicados desde el repo fuente. Abre cualquiera y mira la skill en acción.
Project Foundation
Define el producto antes de escribir código: Constitución, PRD, SRS y Discovery, los documentos base que todas las skills siguientes dan por hechos.
Ver cómo funcionaProject Bootstrap
Levanta la base técnica desde el PRD y el SRS: backend con base de datos y auth, frontend con design system y las piezas de integración que el proyecto pida.
Ver cómo funcionaProject Adoption
Enseña la capa agéntica a una app viva: lee el stack real sin escribir nada, propone un solo plan y solo con tu aprobación toca las superficies agénticas.
Ver cómo funcionaProject Context
Genera y refresca los mapas de negocio, el plan maestro y el roadmap de desarrollo, con evidencia del código y un diff que apruebas antes de escribir.
Ver cómo funcionaProduct Management
Convierte el PRD en épicas e historias dentro de Jira, las refina con INVEST y criterios Gherkin, y calcula en qué orden se pueden empezar.
Ver cómo funcionaSprint Development
Lleva una historia de Jira hasta staging: Planning → Implementation → Code Review → Staging, y producción como paso aparte con tu aprobación.
Ver cómo funcionaTestability Guide
Genera la página pública /qa que explica cómo testear la app por base de datos, API e interfaz, y un artefacto de credenciales aparte donde viven los secretos.
Ver cómo funcionaUnit Testing
Diseña y escribe tests de una unidad con TDD (red, green, refactor): cómo nombrarlos, qué mockear y qué cobertura mirar, para fijar comportamiento y no implementación.
Ver cómo funcionaGit Flow Master
La única puerta para ramas, commits, pushes y PRs: lee la estrategia de ramas del repo, la contrasta con lo que impone el host y se detiene al abrir el PR.
Ver cómo funcionaPR Review Lead
Revisa el PR de un compañero como Tech Lead: cada hallazgo cita doctrina o código, y nada se publica en GitHub sin tu OK sobre el borrador final.
Ver cómo funcionaAutonomous Delivery
Entrega con un scheduler y sin nadie mirando: audita el estado real, elige trabajo desbloqueado, lo despacha a la skill dueña y deja un reporte para la corrida siguiente.
Ver cómo funcionaOrca Orchestration
Una sesión conductora coordina sesiones worker persistentes, una por historia, módulo o grupo de bugs, con buzón de reportes y cierre verificado.
Ver cómo funcionaSession Handoff
Compacta una sesión entera en un archivo para que una sesión nueva retome exactamente donde esta se detuvo, como si la ventana de contexto se hubiera agrandado.
Ver cómo funcionaJira Administration
Dos operaciones de admin que no se deshacen: reconciliar los Components con los módulos de la app o repuntar el repo a otra instancia de Atlassian, siempre con tu aprobación.
Ver cómo funcionaContext Skills
El mapa del negocio viaja dentro de una skill de contexto: cómo se genera, se lee por sección, se mantiene fresco y se corrige con evidencia.
Ver cómo funcionaProgressive Disclosure
Las instrucciones del repo en capas: un núcleo chico que carga siempre, un archivo por tema y un router que dice cuál leer según el pedido.
Ver cómo funcionaTooling
Cómo la IA usa acli y vercel-cli con la skill que conoce cada binario, los scripts jira:* y el arranque con .env y credenciales para los servidores MCP.
Ver cómo funcionaLas ideas detrás del repo
Ideas que cruzan varias skills: cómo responde el repo, por qué el backlog vive en Jira y cómo se pasa del plano al mockup. Salen del mismo repo fuente.
La capa comportamental
Butler Pattern, PM Voice, Visual Mapping y el reparto de capas: por qué el repo responde como responde, con la misma sesión en los dos estilos.
Ver el conceptoPBI como caché de Jira
Jira es la fuente de verdad y el disco es un caché: los tres tiers, la escalera de .gitignore, context:hydrate y las defensas del workspace compartido.
Ver el conceptoTokens y mockups
DESIGN.md una vez, mockup por historia, y el design gate que rutea entre los dos.
Ver el conceptoQuick start
Cuatro pasos: scaffold, setup, definición del producto y el primer story entregado.
bunx create-agentic-dev@latest mi-proyecto
cd mi-proyecto && bun setup
# en Claude Code (en OpenCode y Codex nombra la skill en prosa)
/project-foundation # define el producto
/sprint-development # entrega el primer story
# ya tienes una app (Next.js + Postgres, con bun)? Desde su raíz:
bunx create-agentic-dev@latest --adopt
# para traer las novedades del template
bun syncEl repo es público bajo licencia MIT: úsalo, fórkealo, mejóralo.