rootkid0-initializer 0.1.0

package/03-design/02-to-be-flow.md

@@ -0,0 +1,16 @@
+# To-Be Flow - {{PROJECT_NAME}}
+
+## Flujo objetivo
+
+1. Entrada del usuario o sistema.
+2. Procesamiento.
+3. Respuesta y persistencia.
+
+## Mejoras respecto al As-Is
+
+- Mejora 1
+- Mejora 2
+
+## Validacion
+
+- Como mediremos que el nuevo flujo funciona.

package/03-design/03-components.md

@@ -0,0 +1,12 @@
+# Components - {{PROJECT_NAME}}
+
+## Inventario de componentes
+
+| Componente | Tipo | Responsabilidad | Owner |
+|---|---|---|---|
+| API Core | Servicio | Orquestar reglas de negocio | |
+
+## Dependencias
+
+- Dependencia interna:
+- Dependencia externa:

package/03-design/04-data-model.md

@@ -0,0 +1,17 @@
+# Data Model - {{PROJECT_NAME}}
+
+## Entidades
+
+| Entidad | Descripcion | Fuente |
+|---|---|---|
+| ExampleEntity | Entidad principal del dominio | Sistema interno |
+
+## Reglas de datos
+
+- Regla de integridad 1
+- Regla de integridad 2
+
+## Retencion y privacidad
+
+- Politica de retencion:
+- Datos sensibles:

package/03-design/05-api-contracts.md

@@ -0,0 +1,18 @@
+# API Contracts - {{PROJECT_NAME}}
+
+## Endpoints
+
+| Metodo | Ruta | Input | Output |
+|---|---|---|---|
+| GET | /health | - | status |
+
+## Reglas de contrato
+
+- Versionado:
+- Compatibilidad hacia atras:
+- Limites de rate:
+
+## Seguridad
+
+- Autenticacion:
+- Autorizacion:

package/03-design/06-error-handling.md

@@ -0,0 +1,19 @@
+# Error Handling - {{PROJECT_NAME}}
+
+## Principios
+
+- Mensajes claros para usuario.
+- Detalles tecnicos solo en logs.
+
+## Catalogo minimo de errores
+
+| Codigo | Caso | Accion recomendada |
+|---|---|---|
+| VALIDATION_ERROR | Datos invalidos | Corregir payload |
+| INTERNAL_ERROR | Error inesperado | Reintentar y escalar |
+
+## Observabilidad
+
+- Logs estructurados:
+- Trazabilidad:
+- Alertas:

package/03-design/AGENTS.md

@@ -0,0 +1,33 @@
+# AGENTS
+
+Entrypoint local para trabajo en `03-design`.
+
+## Scope
+
+Definir arquitectura, componentes, modelo de datos y contratos.
+
+## Reglas locales
+
+- Justificar decisiones tecnicas de alto impacto.
+- Mantener consistencia con propuesta y alcance.
+- No avanzar a Management sin cumplir el gate de Design.
+
+## Design Configuration
+
+- Estandar operativo: `03-design/DESIGN-OPERATING-MODEL.md`
+- Entregables obligatorios:
+  - `01-architecture-overview.md`
+  - `02-to-be-flow.md`
+  - `03-components.md`
+  - `04-data-model.md`
+  - `05-api-contracts.md`
+  - `06-error-handling.md`
+- Criterio de paso: diseno validado y gate aprobado.
+
+## Orden de carga recomendado
+
+1. Contexto global: `.opencode/context.md`
+2. AGENTS local: `03-design/AGENTS.md`
+3. Skill global: `.opencode/skills/global/SKILL.md`
+4. Skill local: `03-design/skills/SKILL.md`
+5. Rol: `AGENTS.md` (raiz)

package/03-design/DESIGN-OPERATING-MODEL.md

@@ -0,0 +1,83 @@
+# Design Operating Model
+
+## Objective
+
+Estandarizar Design para transformar una propuesta aprobada en una definicion tecnica ejecutable, estimable y consistente.
+
+## Inputs
+
+- Proposal aprobado (Go) en `02-proposal/`.
+- Alcance in/out confirmado.
+- Riesgos y condiciones de avance definidos.
+
+## Mandatory Deliverables
+
+1. `01-architecture-overview.md`
+2. `02-to-be-flow.md`
+3. `03-components.md`
+4. `04-data-model.md`
+5. `05-api-contracts.md`
+6. `06-error-handling.md`
+
+## Mandatory Content by Deliverable
+
+- `01-architecture-overview.md`: componentes, limites, integraciones y decisiones de alto nivel.
+- `02-to-be-flow.md`: flujo futuro extremo a extremo con actores y sistemas.
+- `03-components.md`: responsabilidades por componente y dependencias.
+- `04-data-model.md`: entidades, ownership, relaciones y reglas clave.
+- `05-api-contracts.md`: contratos de entrada/salida, codigos de error y supuestos.
+- `06-error-handling.md`: estrategia de errores, reintentos, fallback y observabilidad minima.
+
+## Execution Steps
+
+1. Bajar la solucion propuesta a arquitectura con limites claros.
+2. Definir flujo to-be con foco en consistencia de datos.
+3. Asignar responsabilidades por componente.
+4. Modelar datos y contratos con reglas de negocio trazables.
+5. Definir estrategia de errores y comportamiento ante fallas.
+6. Validar el diseno con criterios de implementabilidad.
+
+## Design Gate (Go / No-Go)
+
+La fase solo pasa a Management si todas las condiciones son verdaderas:
+
+- Todos los entregables tecnicos obligatorios estan completos.
+- El diseno responde al alcance aprobado en Proposal.
+- Las decisiones clave y trade-offs estan documentados.
+- Los contratos tecnicos son suficientes para estimar tareas.
+- Existe validacion tecnica explicita para iniciar planificacion.
+
+Si una condicion falla, el resultado es **No-Go** y se itera en Design.
+
+## Validation Checklist
+
+- [ ] La arquitectura define limites y dependencias claras.
+- [ ] El flujo to-be refleja el comportamiento esperado.
+- [ ] Componentes y responsabilidades no se superponen.
+- [ ] Modelo de datos y contratos son coherentes entre si.
+- [ ] Estrategia de errores cubre escenarios criticos.
+- [ ] Hay acuerdo tecnico para pasar a Management.
+
+## Output Format
+
+Al cerrar Design, registrar decision en `01-architecture-overview.md` con este formato:
+
+```md
+## Design Decision
+
+- Status: Go | No-Go
+- Date: YYYY-MM-DD
+- Approved by: <nombre/rol tecnico>
+- Open risks:
+  - <riesgo 1>
+  - <riesgo 2>
+- Next step:
+  - Si Go: iniciar `04-management/`
+  - Si No-Go: iterar artefactos de design
+```
+
+## Quality Rules
+
+- No incluir backlog detallado en Design (eso pertenece a Management).
+- Evitar ambiguedad en ownership de componentes y datos.
+- Cada decision de alto impacto debe tener justificacion breve.

package/03-design/skills/SKILL.md

@@ -0,0 +1,11 @@
+---
+name: local-design-conventions
+description: Convenciones para decisiones de arquitectura y diseno. Trigger: cambios en 03-design.
+---
+
+# Skill local 03-design
+
+- Enfatizar trade-offs y decisiones reversibles.
+- Evitar detalle de implementacion prematuro.
+- Trabajar siempre contra el estandar `03-design/DESIGN-OPERATING-MODEL.md`.
+- No marcar Design como completo si falta algun artefacto tecnico obligatorio.

package/04-management/01-project-overview.md

@@ -0,0 +1,17 @@
+# Project Overview - {{PROJECT_NAME}}
+
+## Vision
+
+Explica el resultado esperado del proyecto.
+
+## Objetivos operativos
+
+- Objetivo operativo 1
+- Objetivo operativo 2
+
+## Equipo
+
+| Rol | Nombre | Responsabilidad |
+|---|---|---|
+| PM | | |
+| Tech Lead | | |

package/04-management/02-roadmap.md

@@ -0,0 +1,14 @@
+# Roadmap - {{PROJECT_NAME}}
+
+## Hitos
+
+| Hito | Fecha objetivo | Estado |
+|---|---|---|
+| Inicio | | Planned |
+| MVP | | Planned |
+| Cierre | | Planned |
+
+## Dependencias criticas
+
+- Dependencia 1
+- Dependencia 2

package/04-management/03-backlog.md

@@ -0,0 +1,11 @@
+# Backlog - {{PROJECT_NAME}}
+
+## Priorizacion
+
+Usa prioridad P0, P1, P2 y define valor/impacto.
+
+## Items
+
+| ID | Item | Prioridad | Estado |
+|---|---|---|---|
+| BG-001 | Definir alcance MVP | P0 | Todo |

package/04-management/04-sprints.md

@@ -0,0 +1,12 @@
+# Sprints - {{PROJECT_NAME}}
+
+## Sprint planning
+
+| Sprint | Objetivo | Fecha inicio | Fecha fin |
+|---|---|---|---|
+| Sprint 1 | | | |
+
+## Definicion de done
+
+- [ ] Criterios funcionales cumplidos.
+- [ ] Evidencia de pruebas disponible.

package/04-management/05-risks.md

@@ -0,0 +1,12 @@
+# Risks - {{PROJECT_NAME}}
+
+## Registro de riesgos
+
+| Riesgo | Probabilidad | Impacto | Owner | Estado |
+|---|---|---|---|---|
+| Dependencia externa no disponible | Media | Alto | | Open |
+
+## Plan de mitigacion
+
+- Mitigacion 1
+- Mitigacion 2

package/04-management/06-change-log.md

@@ -0,0 +1,11 @@
+# Change Log - {{PROJECT_NAME}}
+
+## Formato
+
+Registra cambios funcionales y tecnicos relevantes.
+
+## Entradas
+
+| Fecha | Cambio | Motivo | Responsable |
+|---|---|---|---|
+| YYYY-MM-DD | Inicializacion del proyecto | Inicio de MVP | |

package/04-management/AGENTS.md

@@ -0,0 +1,33 @@
+# AGENTS
+
+Entrypoint local para trabajo en `04-management`.
+
+## Scope
+
+Planificar roadmap, backlog, sprints, riesgos y cambios.
+
+## Reglas locales
+
+- Definir prioridades claras y fechas realistas.
+- Mantener riesgos con plan de mitigacion.
+- No avanzar a Development sin cumplir el gate de Management.
+
+## Management Configuration
+
+- Estandar operativo: `04-management/MANAGEMENT-OPERATING-MODEL.md`
+- Entregables obligatorios:
+  - `01-project-overview.md`
+  - `02-roadmap.md`
+  - `03-backlog.md`
+  - `04-sprints.md`
+  - `05-risks.md`
+  - `06-change-log.md`
+- Criterio de paso: plan ejecutable, prioridades claras y gate aprobado.
+
+## Orden de carga recomendado
+
+1. Contexto global: `.opencode/context.md`
+2. AGENTS local: `04-management/AGENTS.md`
+3. Skill global: `.opencode/skills/global/SKILL.md`
+4. Skill local: `04-management/skills/SKILL.md`
+5. Rol: `AGENTS.md` (raiz)

package/04-management/MANAGEMENT-OPERATING-MODEL.md

@@ -0,0 +1,83 @@
+# Management Operating Model
+
+## Objective
+
+Estandarizar Management para convertir el diseno aprobado en un plan de ejecucion controlado, priorizado y trazable.
+
+## Inputs
+
+- Design aprobado (Go) en `03-design/`.
+- Alcance y restricciones confirmadas.
+- Riesgos tecnicos y de negocio identificados.
+
+## Mandatory Deliverables
+
+1. `01-project-overview.md`
+2. `02-roadmap.md`
+3. `03-backlog.md`
+4. `04-sprints.md`
+5. `05-risks.md`
+6. `06-change-log.md`
+
+## Mandatory Content by Deliverable
+
+- `01-project-overview.md`: objetivo, alcance vigente, estado y responsables.
+- `02-roadmap.md`: hitos, dependencias y fechas objetivo.
+- `03-backlog.md`: items priorizados con owner, criterio de cierre y estado.
+- `04-sprints.md`: plan de iteraciones con capacidad y objetivo por sprint.
+- `05-risks.md`: riesgos activos con impacto, probabilidad, owner y mitigacion.
+- `06-change-log.md`: decisiones y cambios relevantes con fecha y motivo.
+
+## Execution Steps
+
+1. Consolidar alcance y objetivos de entrega.
+2. Definir roadmap realista con dependencias.
+3. Construir backlog priorizado y accionable.
+4. Planificar sprints segun capacidad del equipo.
+5. Formalizar registro de riesgos y mitigaciones.
+6. Registrar cambios para mantener trazabilidad.
+
+## Management Gate (Go / No-Go)
+
+La fase solo pasa a Development si todas las condiciones son verdaderas:
+
+- El backlog esta priorizado, estimable y con owner por item.
+- El roadmap define hitos claros y dependencias criticas.
+- Los riesgos principales tienen accion de mitigacion asignada.
+- El plan de iteraciones es coherente con la capacidad real.
+- Existe acuerdo operativo para iniciar ejecucion tecnica.
+
+Si una condicion falla, el resultado es **No-Go** y se itera en Management.
+
+## Validation Checklist
+
+- [ ] `01-project-overview.md` refleja el estado real del proyecto.
+- [ ] `02-roadmap.md` muestra hitos y secuencia ejecutable.
+- [ ] `03-backlog.md` evita tareas ambiguas.
+- [ ] `04-sprints.md` es consistente con capacidad.
+- [ ] `05-risks.md` contiene riesgos accionables con owner.
+- [ ] `06-change-log.md` registra decisiones relevantes.
+
+## Output Format
+
+Al cerrar Management, registrar decision en `01-project-overview.md` con este formato:
+
+```md
+## Management Decision
+
+- Status: Go | No-Go
+- Date: YYYY-MM-DD
+- Approved by: <nombre/rol>
+- Operational blockers:
+  - <bloqueo 1>
+  - <bloqueo 2>
+- Next step:
+  - Si Go: iniciar `05-development/`
+  - Si No-Go: ajustar roadmap/backlog/riesgos
+```
+
+## Quality Rules
+
+- No incluir decisiones de arquitectura nuevas en esta fase.
+- Toda tarea del backlog debe tener criterio de cierre.
+- El estado de riesgos debe actualizarse en cada iteracion.

package/04-management/skills/SKILL.md

@@ -0,0 +1,11 @@
+---
+name: local-management-conventions
+description: Convenciones para gestion de proyecto. Trigger: cambios en 04-management.
+---
+
+# Skill local 04-management
+
+- Mantener estado, owner y siguiente accion por item.
+- Evitar tareas ambiguas sin criterio de cierre.
+- Trabajar siempre contra el estandar `04-management/MANAGEMENT-OPERATING-MODEL.md`.
+- No marcar Management como completo sin backlog priorizado y riesgos accionables.

package/05-development/01-setup.md

@@ -0,0 +1,13 @@
+# Setup - {{PROJECT_NAME}}
+
+## Requisitos
+
+- Git
+- Editor
+- Runtime segun stack
+
+## Pasos iniciales
+
+1. Clonar repositorio.
+2. Copiar archivo de config.
+3. Ejecutar pruebas basicas.

package/05-development/02-standards.md

@@ -0,0 +1,12 @@
+# Standards - {{PROJECT_NAME}}
+
+## Convenciones de codigo
+
+- Naming claro y consistente.
+- PR pequenos y revisables.
+- Commits orientados a contexto.
+
+## Convenciones de documentacion
+
+- Actualizar markdown en cada cambio relevante.
+- Mantener trazabilidad con backlog y changelog.

package/05-development/03-testing.md

@@ -0,0 +1,12 @@
+# Testing - {{PROJECT_NAME}}
+
+## Estrategia
+
+- Pruebas unitarias para reglas de negocio.
+- Pruebas de integracion para flujos criticos.
+
+## Criterio minimo para merge
+
+- [ ] Casos felices cubiertos.
+- [ ] Errores esperados cubiertos.
+- [ ] Evidencia en CI o local.

package/05-development/04-structure.md

@@ -0,0 +1,11 @@
+# Structure - {{PROJECT_NAME}}
+
+## Estructura sugerida
+
+- src/ para codigo fuente
+- tests/ para pruebas
+- scripts/ para automatizacion interna
+
+## Regla de modularidad
+
+Cada modulo debe tener responsabilidad unica y documentacion minima.

package/05-development/AGENTS.md

@@ -0,0 +1,31 @@
+# AGENTS
+
+Entrypoint local para trabajo en `05-development`.
+
+## Scope
+
+Setup tecnico, estandares de codigo y estrategia de testing.
+
+## Reglas locales
+
+- Cambios pequenos y verificables.
+- Mantener convenciones de desarrollo consistentes.
+- No avanzar a Deployment sin cumplir el gate de Development.
+
+## Development Configuration
+
+- Estandar operativo: `05-development/DEVELOPMENT-OPERATING-MODEL.md`
+- Entregables obligatorios:
+  - `01-setup.md`
+  - `02-standards.md`
+  - `03-testing.md`
+  - `04-structure.md`
+- Criterio de paso: implementacion validada, pruebas base y gate aprobado.
+
+## Orden de carga recomendado
+
+1. Contexto global: `.opencode/context.md`
+2. AGENTS local: `05-development/AGENTS.md`
+3. Skill global: `.opencode/skills/global/SKILL.md`
+4. Skill local: `05-development/skills/SKILL.md`
+5. Rol: `AGENTS.md` (raiz)

package/05-development/DEVELOPMENT-OPERATING-MODEL.md

@@ -0,0 +1,82 @@
+# Development Operating Model
+
+## Objective
+
+Estandarizar Development para ejecutar implementacion tecnica con calidad, trazabilidad y consistencia respecto al diseno aprobado.
+
+## Inputs
+
+- Management aprobado (Go) en `04-management/`.
+- Backlog priorizado con owner y criterio de cierre.
+- Riesgos y dependencias activas identificadas.
+
+## Mandatory Deliverables
+
+1. `01-setup.md`
+2. `02-standards.md`
+3. `03-testing.md`
+4. `04-structure.md`
+
+## Mandatory Content by Deliverable
+
+- `01-setup.md`: prerequisitos, entorno local y pasos de arranque reproducibles.
+- `02-standards.md`: reglas de codigo, convenciones y criterios minimos de calidad.
+- `03-testing.md`: estrategia de pruebas y cobertura minima por capa.
+- `04-structure.md`: estructura tecnica del proyecto y responsabilidades por modulo.
+
+## Execution Steps
+
+1. Preparar entorno de desarrollo y validar setup.
+2. Implementar backlog por prioridad y criterio de cierre.
+3. Aplicar estandares de codigo y arquitectura definidos.
+4. Ejecutar pruebas continuas en caminos criticos.
+5. Registrar decisiones tecnicas relevantes y su impacto.
+6. Consolidar estado tecnico para preparar Deployment.
+
+## Development Gate (Go / No-Go)
+
+La fase solo pasa a Deployment si todas las condiciones son verdaderas:
+
+- Los items comprometidos del backlog estan implementados y verificados.
+- Existen evidencias de pruebas en caminos criticos.
+- La estructura de codigo y estandares estan actualizados.
+- No hay bloqueos tecnicos criticos abiertos sin plan.
+- El estado tecnico permite preparar release candidate.
+
+Si una condicion falla, el resultado es **No-Go** y se itera en Development.
+
+## Validation Checklist
+
+- [ ] `01-setup.md` permite reproducir el entorno sin pasos ocultos.
+- [ ] `02-standards.md` refleja convenciones vigentes.
+- [ ] `03-testing.md` define pruebas accionables por tipo.
+- [ ] `04-structure.md` explica modulos y limites de responsabilidad.
+- [ ] Hay evidencia de pruebas para cambios criticos.
+- [ ] Los bloqueos activos tienen owner y siguiente accion.
+
+## Output Format
+
+Al cerrar Development, registrar decision en `01-setup.md` con este formato:
+
+```md
+## Development Decision
+
+- Status: Go | No-Go
+- Date: YYYY-MM-DD
+- Approved by: <nombre/rol tecnico>
+- Test evidence:
+  - <evidencia 1>
+  - <evidencia 2>
+- Open blockers:
+  - <bloqueo 1>
+  - <bloqueo 2>
+- Next step:
+  - Si Go: iniciar `06-deployment/`
+  - Si No-Go: iterar backlog/pruebas/estandares
+```
+
+## Quality Rules
+
+- No cerrar tareas sin criterio de aceptacion verificado.
+- Evitar deuda tecnica no registrada en backlog o change-log.
+- Toda excepcion relevante de calidad debe quedar documentada.

package/05-development/skills/SKILL.md

@@ -0,0 +1,11 @@
+---
+name: local-development-conventions
+description: Convenciones de implementacion y calidad. Trigger: cambios en 05-development.
+---
+
+# Skill local 05-development
+
+- Priorizar legibilidad y mantenibilidad.
+- Documentar decisiones solo cuando agreguen contexto.
+- Trabajar siempre contra el estandar `05-development/DEVELOPMENT-OPERATING-MODEL.md`.
+- No marcar Development como completo sin evidencia de pruebas en caminos criticos.

package/06-deployment/01-environments.md

@@ -0,0 +1,11 @@
+# Environments - {{PROJECT_NAME}}
+
+## Ambientes
+
+- local
+- staging
+- production
+
+## Variables por ambiente
+
+Lista las variables y su fuente (secret manager, CI, etc.).

package/06-deployment/02-ci-cd.md

@@ -0,0 +1,13 @@
+# CI/CD - {{PROJECT_NAME}}
+
+## Pipeline minimo
+
+1. Lint
+2. Tests
+3. Build
+4. Deploy
+
+## Gating
+
+- Bloquear merge si fallan tests.
+- Requerir al menos una revision.

package/06-deployment/03-config.md

@@ -0,0 +1,11 @@
+# Config - {{PROJECT_NAME}}
+
+## Configuracion base
+
+- Archivo principal: config/project.config.json
+- Archivo de ejemplo: config/project.config.example.json
+
+## Politica
+
+- Nunca commitear secretos.
+- Mantener defaults seguros.

package/06-deployment/04-monitoring.md

@@ -0,0 +1,12 @@
+# Monitoring - {{PROJECT_NAME}}
+
+## Senales clave
+
+- Disponibilidad
+- Latencia
+- Tasa de errores
+
+## Alertas
+
+- Alerta de error alto.
+- Alerta de degradacion de latencia.