Planos · agentic-dev-boilerplate
◐ · docs hub

Los planos de cómo este repo construye software con IA.

Este repo defiende una regla antes que cualquier otra: plan antes de código. Cada skill produce un plano por escrito antes de escribir una sola línea: un PRD, un DESIGN.md, un mockup, un impl plan, un epic. Este hub es la versión legible de esos planos: cómo piensa cada skill, qué archivo espera de vos, y qué te devuelve.

para quien recién llega al repo un deck = una skill o una pieza de doctrina generados con html-ppt · self-contained
Fundación

project-foundation

Constitución, PRD, SRS: el porqué del producto.

→
Diseño

design-system

DESIGN.md + mockups por historia.

→
Sprint

sprint-development

Plan → código → review, historia por historia.

→
Entrega

staging → prod

Deploy gateado, con rollback.

01 · núcleo

Cómo piensa el repo, antes de cualquier skill

Doctrina transversal: cómo el agente principal orquesta subagentes y sesiones, cómo decide su registro de comunicación, dónde vive el backlog y dónde vive el mapa del negocio. Vale la pena leer esto antes que cualquier "cómo funciona" puntual.

02 · ciclo de vida del desarrollo

De la idea al sprint, en el orden real

Las skills en el orden en que un producto nuevo realmente las atraviesa: definir, diseñar, levantar el repo, armar el backlog y entregar historia por historia. Una app que ya existe entra por la adopción en lugar de levantar el repo.

project-foundationPM/PO · lead

Definir el producto

Antes de la primera línea de código: Constitución, PRD, diseño, SRS con ADRs y Discovery.

Abrir →
design-systemdev · PM/PO

Tokens y mockups

DESIGN.md una vez, mockup por historia, y el design gate que rutea entre los dos.

Abrir →
project-bootstrapdev · lead

Del SRS a un repo que arranca

Backend, frontend y piezas de integración desde el PRD, el SRS y el DESIGN.md, antes de la primera historia.

Abrir →
project-adoptionlead · dev

Adoptar una app que ya existe

Leer la app sin tocarla, un plan que esperás aprobar y la prueba de que compila, lintea y testea igual que antes.

Abrir →
product-managementPM/PO · dev

Del PRD a historias listas

Cómo el backlog pasa de PRD a historias refinadas en Jira y a un orden de ejecución.

Abrir →
project-contextlead · dev

Mapas, plan maestro y roadmap

Cómo la IA arma y refresca los mapas de negocio, el plan maestro y el roadmap, un modo por vez y con tu aprobación antes de pisar nada.

Abrir →
sprint-developmentdev · lead · PM/PO

Del ticket al deploy

Planning, Implementation, Code Review, Staging y Production con compuerta: plan en Jira, app viva, review adversarial, historia por historia.

Abrir →
unit-testingdev

Tests que fallan por el motivo correcto

Red-green-refactor, nombres, mocks y cobertura, sola o desde la etapa de Implementation.

Abrir →
testability-guidedev · lead

La página /qa y sus credenciales

La página /qa que enseña a testear la app, y las credenciales detrás de una puerta con permisos.

Abrir →
03 · operación y entrega

Lo que sostiene todo lo anterior

Git, review, sesiones largas, corridas sin nadie mirando, Jira y deploy: lo que se usa todos los días una vez que el ciclo de vida principal ya está rodando.

04 · para mantenedores

Cómo se arma y se publica este hub

Para quien agrega un deck, corrige uno o mantiene el boilerplate. Todo vive en GitHub; nada de esto se publica como página.