rootkid0-initializer 0.1.0

package/.opencode/README.md

@@ -0,0 +1,38 @@
+# OpenCode setup (MVP)
+
+Esta carpeta define una integracion simple para OpenCode con este modelo:
+
+- 1 contexto global en la raiz.
+- 1 AGENTS local por subproyecto.
+- Skills globales y locales.
+- MCP centralizado.
+- Entrypoint de agentes en `AGENTS.md` y roles definidos por archivo.
+
+## Estructura
+
+- `.opencode/context.md`: contexto global del proyecto.
+- `.opencode/skills/global/SKILL.md`: skill global de convenciones base.
+- `<subproyecto>/AGENTS.md`: reglas y scope local del subproyecto.
+- `<subproyecto>/skills/SKILL.md`: skill local con reglas del subproyecto.
+- `.opencode/mcp/servers.template.json`: plantilla centralizada de MCP.
+- `AGENTS.md`: indice canonico para seleccionar rol.
+- `.opencode/agents/*.md`: detalle de roles reutilizables.
+
+## Uso recomendado
+
+1. Cargar primero `.opencode/context.md`.
+2. Para trabajar en un subproyecto, cargar su `AGENTS.md` local y su `skills/SKILL.md`.
+3. Mantener todos los servidores MCP en `.opencode/mcp/servers.template.json`.
+4. Entrar por `AGENTS.md` y luego abrir el rol que corresponda.
+
+MCP recomendados del proyecto: `context7`, `engram`, `notion`.
+
+## Ejemplo rapido de consumo (05-development)
+
+- Global: `.opencode/context.md`
+- Local: `05-development/AGENTS.md`
+- Skill global: `.opencode/skills/global/SKILL.md`
+- Skill local: `05-development/skills/SKILL.md`
+- Agente sugerido: `AGENTS.md` -> `implementer`
+
+Con esto se combina el contexto comun con las reglas especificas del area.

package/.opencode/agents/README.md

@@ -0,0 +1,12 @@
+# Agentes por rol
+
+Este proyecto define agentes por responsabilidad, no por carpeta.
+
+- `architect.md`: diseno y decisiones tecnicas.
+- `implementer.md`: implementacion de cambios.
+- `reviewer.md`: validacion de calidad y consistencia.
+- `ops.md`: despliegue, CI/CD y operacion.
+
+Cada rol debe cargar contexto global y, si aplica, contexto local del subproyecto.
+
+Usa `AGENTS.md` en la raiz como punto de entrada para elegir rol.

package/.opencode/agents/architect.md

@@ -0,0 +1,16 @@
+# Role: Architect
+
+## Mission
+
+Definir o ajustar decisiones tecnicas con foco en simplicidad y trazabilidad.
+
+## Inputs minimos
+
+- `.opencode/context.md`
+- `<subproyecto>/.opencode/context.md` (si aplica)
+- Documentos del area afectada
+
+## Outputs esperados
+
+- Decision clara, alcance y trade-offs.
+- Cambios minimos en docs estructurales.

package/.opencode/agents/implementer.md

@@ -0,0 +1,16 @@
+# Role: Implementer
+
+## Mission
+
+Aplicar cambios pequenos y compatibles con el bootstrap y la estructura por fases.
+
+## Inputs minimos
+
+- `.opencode/context.md`
+- `<subproyecto>/.opencode/context.md` (si aplica)
+- Skills global/local
+
+## Outputs esperados
+
+- Implementacion funcional y MVP.
+- Actualizacion minima de documentacion cuando haga falta.

package/.opencode/agents/ops.md

@@ -0,0 +1,15 @@
+# Role: Ops
+
+## Mission
+
+Mantener la configuracion operativa (MCP, CI/CD, despliegue) simple y centralizada.
+
+## Inputs minimos
+
+- `.opencode/mcp/servers.template.json`
+- `06-deployment/` y `99-common/`
+
+## Outputs esperados
+
+- Ajustes seguros y repetibles.
+- Instrucciones de ejecucion cortas.

package/.opencode/agents/reviewer.md

@@ -0,0 +1,12 @@
+# Role: Reviewer
+
+## Mission
+
+Verificar consistencia, claridad y compatibilidad del cambio.
+
+## Checklist rapido
+
+- Se respeta contexto global y local.
+- No se rompe bootstrap.
+- Documentacion corta y util.
+- Estructura por fases intacta.

package/.opencode/context.md

@@ -0,0 +1,36 @@
+# Contexto global - {{PROJECT_NAME}}
+
+## Objetivo
+
+Este repositorio usa una estructura por fases para documentar y ejecutar un proyecto desde negocio hasta despliegue.
+
+## Regla de contexto
+
+- Este archivo es el contexto global unico.
+- Cada subproyecto define su entrada local en `<subproyecto>/AGENTS.md`.
+- El agente debe cargar contexto global + reglas locales + skills al trabajar en un area.
+
+## Convenciones base
+
+- Mantener cambios MVP y faciles de mantener.
+- Preservar estructura por fases (`01-` a `06-`, `99-common`).
+- Documentar decisiones cortas y accionables.
+- Priorizar consistencia con bootstrap y README.
+
+## Mapa de subproyectos
+
+- `01-business`: descubrimiento del problema.
+- `02-proposal`: propuesta de solucion.
+- `03-design`: arquitectura y contratos.
+- `04-management`: roadmap, backlog y sprints.
+- `05-development`: setup, estandares y testing.
+- `06-deployment`: entornos, CI/CD y monitoreo.
+- `07-production`: operacion, incidentes y evolucion.
+- `99-common`: checklist y glosario transversal.
+
+## Integracion OpenCode
+
+- Skills globales: `.opencode/skills/global/`.
+- Skills locales: `<subproyecto>/skills/`.
+- MCP centralizado: `.opencode/mcp/`.
+- Agentes por rol: `.opencode/agents/`.

package/.opencode/mcp/README.md

@@ -0,0 +1,34 @@
+# MCP centralizado
+
+Configura todos los servidores MCP en esta carpeta para evitar definiciones duplicadas.
+
+- Plantilla base: `.opencode/mcp/servers.template.json`.
+- Plantilla recomendada (requiere ajuste): `.opencode/mcp/servers.recommended.template.json`.
+- Copia esta plantilla al formato que use tu cliente OpenCode.
+- Mantener una sola fuente de verdad para endpoints, comandos y variables.
+
+## MCPs recomendados del proyecto
+
+- `context7`
+- `engram`
+- `notion`
+
+## Recomendacion de uso
+
+- Mantener la configuracion MCP a nivel global de usuario.
+- Usar `servers.template.json` como baseline estable.
+- Tomar `servers.recommended.template.json` como punto de partida para agregar `context7`, `engram` y `notion` segun tu entorno.
+
+## Requisito para init automatico de Notion
+
+El bootstrap del proyecto valida este archivo global:
+
+- `~/.config/opencode/mcp-servers.json`
+
+Condicion minima requerida:
+
+- Debe existir entrada `servers.notion`.
+
+Si falta, el init falla con mensaje de correccion porque el setup Notion es automatico en P1.
+
+Sugerencia: referenciar esta carpeta desde scripts de setup del equipo.

package/.opencode/mcp/servers.recommended.template.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "https://opencode.ai/schemas/mcp-servers.json",
+  "servers": {
+    "context7": {
+      "transport": "stdio",
+      "command": "<configure-context7-command>",
+      "args": ["<configure-context7-args>"],
+      "env": {
+        "CONTEXT7_API_KEY": "${CONTEXT7_API_KEY}"
+      }
+    },
+    "engram": {
+      "transport": "stdio",
+      "command": "<configure-engram-command>",
+      "args": ["<configure-engram-args>"],
+      "env": {
+        "ENGRAM_API_KEY": "${ENGRAM_API_KEY}",
+        "ENGRAM_PROJECT": "${ENGRAM_PROJECT}"
+      }
+    },
+    "notion": {
+      "transport": "stdio",
+      "command": "<configure-notion-command>",
+      "args": ["<configure-notion-args>"],
+      "env": {
+        "NOTION_TOKEN": "${NOTION_TOKEN}"
+      }
+    }
+  }
+}

package/.opencode/mcp/servers.template.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://opencode.ai/schemas/mcp-servers.json",
+  "servers": {
+    "filesystem": {
+      "transport": "stdio",
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
+    },
+    "github": {
+      "transport": "stdio",
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-github"],
+      "env": {
+        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
+      }
+    }
+  }
+}

package/.opencode/skills/global/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: global-rootkid0-conventions
+description: Convenciones globales para cambios MVP del repositorio por fases. Trigger: cuando se trabaje en cualquier carpeta del proyecto.
+---
+
+# Skill global de rootkid0-initializer
+
+## Principios
+
+1. Cambios simples y compatibles con bootstrap.
+2. No romper la estructura por fases.
+3. Mantener documentacion breve y accionable.
+4. Evitar sobreingenieria.
+
+## Flujo recomendado
+
+1. Cargar contexto global en `.opencode/context.md`.
+2. Cargar contexto/skill local del subproyecto.
+3. Ejecutar cambios minimos necesarios.
+4. Actualizar README o bootstrap solo si afecta inicializacion.

package/.opencode/templates/subproject-agents.template.md

@@ -0,0 +1,20 @@
+# AGENTS
+
+Entrypoint local para trabajo en `<subproyecto>`.
+
+## Scope
+
+Describe aqui el alcance del subproyecto y que tipo de cambios se aceptan.
+
+## Reglas locales
+
+- Convenciones especificas del area.
+- Restricciones funcionales o tecnicas.
+
+## Orden de carga recomendado
+
+1. Contexto global: `.opencode/context.md`
+2. AGENTS local: `<subproyecto>/AGENTS.md`
+3. Skill global: `.opencode/skills/global/SKILL.md`
+4. Skill local: `<subproyecto>/skills/SKILL.md`
+5. Rol: `AGENTS.md` (raiz)

package/.opencode/templates/subproject-skill.template.md

@@ -0,0 +1,9 @@
+---
+name: local-<subproyecto>-conventions
+description: Convenciones locales para <subproyecto>.
+---
+
+# Skill local <subproyecto>
+
+- Define las reglas operativas de este subproyecto.
+- Mantiene consistencia con el contexto global y el rol activo.

package/01-business/01-business-understanding.md

@@ -0,0 +1,22 @@
+# Business Understanding - {{PROJECT_NAME}}
+
+## Contexto
+
+Describe el negocio actual y por que este proyecto es importante.
+
+## Stakeholders
+
+- Sponsor:
+- Lider de negocio:
+- Equipo tecnico:
+
+## Sistemas involucrados
+
+- Sistema origen:
+- Sistema destino:
+- Dependencias externas:
+
+## Criterio de exito
+
+- [ ] Objetivo medible definido.
+- [ ] Responsable de validacion asignado.

package/01-business/02-problem-statement.md

@@ -0,0 +1,15 @@
+# Problem Statement - {{PROJECT_NAME}}
+
+## Problema actual
+
+Explica el dolor principal con evidencia concreta.
+
+## Impacto
+
+- Costo:
+- Tiempo:
+- Riesgo:
+
+## Hipotesis
+
+Si resolvemos este problema, entonces el equipo lograra:

package/01-business/03-as-is-flow.md

@@ -0,0 +1,17 @@
+# As-Is Flow - {{PROJECT_NAME}}
+
+## Flujo actual
+
+1. Paso inicial:
+2. Proceso intermedio:
+3. Resultado actual:
+
+## Puntos de friccion
+
+- Cuello de botella 1:
+- Cuello de botella 2:
+
+## Evidencia
+
+- Ticket o caso real:
+- Metricas observadas:

package/01-business/04-scope-definition.md

@@ -0,0 +1,17 @@
+# Scope Definition - {{PROJECT_NAME}}
+
+## Incluye
+
+- [ ] Alcance funcional 1
+- [ ] Alcance funcional 2
+
+## No incluye
+
+- [ ] Tema fuera de alcance 1
+- [ ] Tema fuera de alcance 2
+
+## Entregables
+
+- Documento:
+- Automatizacion:
+- Criterio de done:

package/01-business/05-assumptions-risks.md

@@ -0,0 +1,17 @@
+# Assumptions and Risks - {{PROJECT_NAME}}
+
+## Supuestos
+
+- Supuesto 1:
+- Supuesto 2:
+
+## Riesgos
+
+| Riesgo | Probabilidad | Impacto | Mitigacion |
+|---|---|---|---|
+| Ejemplo | Media | Alto | Definir plan de contingencia |
+
+## Alertas tempranas
+
+- Indicador 1:
+- Indicador 2:

package/01-business/AGENTS.md

@@ -0,0 +1,32 @@
+# AGENTS
+
+Entrypoint local para trabajo en `01-business`.
+
+## Scope
+
+Define problema, flujo actual, alcance y supuestos de negocio.
+
+## Reglas locales
+
+- Priorizar claridad para stakeholders no tecnicos.
+- Mantener trazabilidad entre problema y alcance.
+- No avanzar a Proposal sin cumplir el gate de Discovery.
+
+## Discovery Configuration
+
+- Estandar operativo: `01-business/DISCOVERY-OPERATING-MODEL.md`
+- Entregables obligatorios:
+  - `01-business-understanding.md`
+  - `02-problem-statement.md`
+  - `03-as-is-flow.md`
+  - `04-scope-definition.md`
+  - `05-assumptions-risks.md`
+- Criterio de paso: todos los entregables completos y gate aprobado.
+
+## Orden de carga recomendado
+
+1. Contexto global: `.opencode/context.md`
+2. AGENTS local: `01-business/AGENTS.md`
+3. Skill global: `.opencode/skills/global/SKILL.md`
+4. Skill local: `01-business/skills/SKILL.md`
+5. Rol: `AGENTS.md` (raiz)

package/01-business/DISCOVERY-OPERATING-MODEL.md

@@ -0,0 +1,74 @@
+# Discovery Operating Model
+
+## Objective
+
+Estandarizar la ejecucion de Discovery para asegurar que el problema este claro, el flujo actual documentado y el alcance definido antes de avanzar.
+
+## Inputs
+
+- Contexto inicial del negocio.
+- Stakeholders disponibles para validacion.
+- Hipotesis inicial del problema (si existe).
+
+## Mandatory Deliverables
+
+1. `01-business-understanding.md`
+2. `02-problem-statement.md`
+3. `03-as-is-flow.md`
+4. `04-scope-definition.md`
+5. `05-assumptions-risks.md`
+
+## Execution Steps
+
+1. Levantar contexto del negocio y actores clave.
+2. Capturar sintoma, impacto y causa raiz preliminar.
+3. Mapear el flujo actual end-to-end con puntos de falla.
+4. Definir alcance in/out sin ambiguedades.
+5. Documentar supuestos y riesgos con mitigacion inicial.
+6. Validar con negocio antes de cerrar fase.
+
+## Discovery Gate (Go / No-Go)
+
+La fase solo pasa a Proposal si todas las condiciones son verdaderas:
+
+- Problema principal definido en una frase clara.
+- Impacto de negocio descrito (tiempo, costo o cliente).
+- Flujo as-is completo con actores/sistemas/puntos de falla.
+- Alcance incluye explicitamente in-scope y out-of-scope.
+- Supuestos y riesgos tienen owner y accion inicial.
+- Stakeholder responsable valida el contenido.
+
+Si una condicion falla, el resultado es **No-Go** y se itera en Discovery.
+
+## Validation Checklist
+
+- [ ] `01-business-understanding.md` esta completo y coherente.
+- [ ] `02-problem-statement.md` diferencia sintoma vs causa raiz.
+- [ ] `03-as-is-flow.md` representa el flujo actual real.
+- [ ] `04-scope-definition.md` evita ambiguedad de alcance.
+- [ ] `05-assumptions-risks.md` registra riesgos accionables.
+- [ ] Existe validacion explicita de negocio.
+
+## Output Format
+
+Al cerrar Discovery, generar un bloque final en `01-business/` con este formato:
+
+```md
+## Discovery Decision
+
+- Status: Go | No-Go
+- Date: YYYY-MM-DD
+- Approved by: <nombre/rol>
+- Blocking gaps:
+  - <gap 1>
+  - <gap 2>
+- Next step:
+  - Si Go: iniciar `02-proposal/01-proposal.md`
+  - Si No-Go: iterar entregables pendientes
+```
+
+## Quality Rules
+
+- Prohibido texto decorativo sin valor de decision.
+- Cada afirmacion relevante debe tener evidencia en un entregable.
+- Si hay dudas de contexto, preguntar antes de asumir.

package/01-business/skills/SKILL.md

@@ -0,0 +1,12 @@
+---
+name: local-business-conventions
+description: Convenciones para documentos de negocio. Trigger: cambios en 01-business.
+---
+
+# Skill local 01-business
+
+- Escribir en lenguaje claro y directo.
+- Evitar detalle tecnico innecesario.
+- Conectar problema, alcance y riesgos.
+- Trabajar siempre contra el estandar `01-business/DISCOVERY-OPERATING-MODEL.md`.
+- No marcar Discovery como completo si falta evidencia en algun entregable.

package/02-proposal/01-proposal.md

@@ -0,0 +1,27 @@
+# Proposal - {{PROJECT_NAME}}
+
+## Resumen ejecutivo
+
+Describe la propuesta en 5-7 lineas, enfocada en valor.
+
+## Objetivos
+
+- Objetivo 1
+- Objetivo 2
+
+## Solucion propuesta
+
+Explica enfoque, alcance de MVP y entregables.
+
+## Cronograma estimado
+
+| Fase | Duracion | Responsable |
+|---|---|---|
+| Discovery | 1 semana | |
+| Construccion MVP | 2 semanas | |
+| Cierre | 1 semana | |
+
+## Criterios de aprobacion
+
+- [ ] Alineacion negocio/tecnico validada.
+- [ ] Riesgos criticos mitigados.

package/02-proposal/AGENTS.md

@@ -0,0 +1,28 @@
+# AGENTS
+
+Entrypoint local para trabajo en `02-proposal`.
+
+## Scope
+
+Traducir necesidades de negocio en propuesta de solucion concreta.
+
+## Reglas locales
+
+- Resaltar valor esperado y limites de alcance.
+- Mantener propuesta alineada con 01-business.
+- No avanzar a Design sin cumplir el gate de Proposal.
+
+## Proposal Configuration
+
+- Estandar operativo: `02-proposal/PROPOSAL-OPERATING-MODEL.md`
+- Entregable obligatorio:
+  - `01-proposal.md`
+- Criterio de paso: propuesta validada por negocio y gate aprobado.
+
+## Orden de carga recomendado
+
+1. Contexto global: `.opencode/context.md`
+2. AGENTS local: `02-proposal/AGENTS.md`
+3. Skill global: `.opencode/skills/global/SKILL.md`
+4. Skill local: `02-proposal/skills/SKILL.md`
+5. Rol: `AGENTS.md` (raiz)

package/02-proposal/PROPOSAL-OPERATING-MODEL.md

@@ -0,0 +1,77 @@
+# Proposal Operating Model
+
+## Objective
+
+Estandarizar Proposal para convertir Discovery en una propuesta aprobable, con valor de negocio claro y alcance controlado.
+
+## Inputs
+
+- Discovery aprobado (Go) en `01-business/`.
+- Problema, impacto y alcance base definidos.
+- Riesgos y supuestos relevantes identificados.
+
+## Mandatory Deliverable
+
+1. `01-proposal.md`
+
+## Mandatory Content in `01-proposal.md`
+
+- Resumen del problema y su impacto.
+- Flujo actual resumido y puntos criticos.
+- Solucion propuesta a alto nivel.
+- Beneficios esperados y metrica de exito.
+- Alcance in-scope / out-of-scope.
+- Riesgos principales y mitigacion inicial.
+
+## Execution Steps
+
+1. Resumir Discovery en lenguaje de negocio.
+2. Formular propuesta de solucion sin entrar en detalle de implementacion.
+3. Definir valor esperado (resultado medible).
+4. Cerrar alcance y exclusiones para evitar ambiguedad.
+5. Validar propuesta con stakeholders clave.
+6. Registrar decision y condiciones de avance.
+
+## Proposal Gate (Go / No-Go)
+
+La fase solo pasa a Design si todas las condiciones son verdaderas:
+
+- El problema y su impacto son claros para negocio y equipo.
+- La solucion propuesta responde al problema correcto.
+- El valor esperado esta explicitado con criterio medible.
+- El alcance in/out esta definido sin ambiguedad.
+- Existe aprobacion explicita de negocio para avanzar.
+
+Si una condicion falla, el resultado es **No-Go** y se itera en Proposal.
+
+## Validation Checklist
+
+- [ ] `01-proposal.md` incluye problema, solucion, valor y alcance.
+- [ ] Los beneficios son concretos y medibles.
+- [ ] Las exclusiones estan explicitas.
+- [ ] Los riesgos clave tienen mitigacion inicial.
+- [ ] La aprobacion de negocio esta registrada.
+
+## Output Format
+
+Al cerrar Proposal, agregar bloque final en `01-proposal.md` con este formato:
+
+```md
+## Proposal Decision
+
+- Status: Go | No-Go
+- Date: YYYY-MM-DD
+- Approved by: <nombre/rol>
+- Conditions to proceed:
+  - <condicion 1>
+  - <condicion 2>
+- Next step:
+  - Si Go: iniciar `03-design/`
+  - Si No-Go: ajustar `01-proposal.md`
+```
+
+## Quality Rules
+
+- Evitar detalle tecnico de implementacion en esta fase.
+- Toda afirmacion de valor debe poder validarse.
+- Si falta contexto de negocio, preguntar antes de asumir.

package/02-proposal/skills/SKILL.md

@@ -0,0 +1,11 @@
+---
+name: local-proposal-conventions
+description: Convenciones para propuesta funcional y tecnica. Trigger: cambios en 02-proposal.
+---
+
+# Skill local 02-proposal
+
+- Priorizar una propuesta accionable y medible.
+- Dejar explicitas exclusiones y supuestos.
+- Trabajar siempre contra el estandar `02-proposal/PROPOSAL-OPERATING-MODEL.md`.
+- No marcar Proposal como completo sin aprobacion de negocio registrada.

package/03-design/01-architecture-overview.md

@@ -0,0 +1,17 @@
+# Architecture Overview - {{PROJECT_NAME}}
+
+## Objetivo tecnico
+
+Define la arquitectura propuesta y sus limites.
+
+## Componentes principales
+
+- Frontend:
+- Backend:
+- Integraciones:
+- Persistencia:
+
+## Decisiones clave
+
+- Decision 1 y rationale.
+- Decision 2 y tradeoff.