rootkid0-initializer 0.1.0

package/99-common/06-p1-notion-schema-spec.md

@@ -0,0 +1,189 @@
+# P1 Schema Spec - Notion multi-DB relacional
+
+## Convenciones generales
+
+- Modelo objetivo: `multi-DB` (7 bases relacionadas).
+- Idioma de propiedades: espanol (snake_case sin acentos).
+- Tipo `required`: obligatorio para crear registro usable.
+- Tipo `optional`: se completa segun avance operativo.
+- Fases canonicas: `01-business`, `02-proposal`, `03-design`, `04-management`, `05-development`, `06-deployment`, `07-production`.
+
+## 1) DB: Projects
+
+Proposito: entidad raiz para trazabilidad transversal del proyecto.
+
+| Propiedad | Tipo | Req/Opt | Proposito |
+|---|---|---|---|
+| nombre_proyecto | Title | required | Nombre visible del proyecto. |
+| codigo_proyecto | Rich text | required | Identificador corto interno (ej: RK-001). |
+| estado_global | Select | required | Estado general (`On track`, `At risk`, `Blocked`, `Done`). |
+| owner_proyecto | People | required | Responsable principal operativo. |
+| sponsor_negocio | People | optional | Sponsor o aprobador de negocio. |
+| objetivo_resumen | Rich text | required | Objetivo concreto en 1-3 lineas. |
+| fecha_inicio_plan | Date | required | Inicio planificado del proyecto. |
+| fecha_fin_objetivo | Date | optional | Fecha objetivo de cierre global. |
+| salud | Select | required | Semaforo (`Verde`, `Amarillo`, `Rojo`). |
+| gate_actual | Relation -> Phases | optional | Fase actual o fase en gate. |
+| fases | Relation -> Phases | optional | Relacion inversa de fases del proyecto. |
+| entregables | Relation -> Deliverables | optional | Relacion inversa de entregables. |
+| backlog_items | Relation -> Backlog | optional | Relacion inversa de backlog. |
+| riesgos | Relation -> Risks | optional | Relacion inversa de riesgos. |
+| decisiones | Relation -> Decisions | optional | Relacion inversa de decisiones. |
+| incidentes | Relation -> Incidents | optional | Relacion inversa de incidentes. |
+
+## 2) DB: Phases
+
+Proposito: controlar ejecucion por fase `01..07` y su gate `Go/No-Go`.
+
+| Propiedad | Tipo | Req/Opt | Proposito |
+|---|---|---|---|
+| nombre_fase | Title | required | Nombre de la fase en el proyecto. |
+| codigo_fase | Select | required | Valor canonico `01-business` ... `07-production`. |
+| orden_fase | Number | required | Orden numerico 1..7 para timeline/reporting. |
+| proyecto | Relation -> Projects | required | Proyecto al que pertenece la fase. |
+| estado_fase | Status | required | Flujo: `Not started`, `In progress`, `Ready for gate`, `Done`. |
+| resultado_gate | Select | required | `Pending`, `Go`, `No-Go`. |
+| owner_fase | People | required | Responsable de mover la fase y ejecutar gate. |
+| fecha_inicio_plan | Date | optional | Inicio planificado de la fase. |
+| fecha_fin_plan | Date | optional | Fin planificado de la fase. |
+| fecha_gate | Date | optional | Fecha del ultimo gate ejecutado. |
+| criterios_gate | Rich text | required | Criterios minimos para aprobar fase. |
+| bloqueadores | Rich text | optional | Bloqueos activos de la fase. |
+| entregables_fase | Relation -> Deliverables | optional | Evidencia asociada a la fase. |
+| backlog_fase | Relation -> Backlog | optional | Trabajo de ejecucion ligado a la fase. |
+| riesgos_fase | Relation -> Risks | optional | Riesgos detectados en fase. |
+| decisiones_fase | Relation -> Decisions | optional | Decisiones tomadas en fase. |
+| incidentes_fase | Relation -> Incidents | optional | Incidentes ocurridos en fase. |
+
+## 3) DB: Deliverables
+
+Proposito: registrar evidencia documental/operativa para avanzar gates.
+
+| Propiedad | Tipo | Req/Opt | Proposito |
+|---|---|---|---|
+| nombre_entregable | Title | required | Nombre del entregable. |
+| tipo_entregable | Select | required | `Documento`, `Demo`, `Acta`, `Decision record`, `Checklist`. |
+| proyecto | Relation -> Projects | required | Proyecto asociado. |
+| fase | Relation -> Phases | required | Fase donde aplica como evidencia. |
+| estado_entregable | Status | required | `Draft`, `In review`, `Approved`. |
+| obligatorio | Checkbox | required | Si bloquea gate (`true`) o es informativo (`false`). |
+| owner_entregable | People | required | Responsable del entregable. |
+| criterio_aceptacion | Rich text | required | Regla concreta de aceptacion. |
+| url_documento | URL | optional | Link al documento fuente o evidencia. |
+| version | Number | optional | Control basico de version. |
+| fecha_compromiso | Date | optional | Fecha objetivo para tenerlo listo. |
+| fecha_aprobacion | Date | optional | Fecha en que se aprueba. |
+| backlog_origen | Relation -> Backlog | optional | Item que produce este entregable. |
+
+## 4) DB: Backlog
+
+Proposito: planificar y ejecutar trabajo accionable por fase.
+
+| Propiedad | Tipo | Req/Opt | Proposito |
+|---|---|---|---|
+| titulo_item | Title | required | Tarea o item de trabajo. |
+| proyecto | Relation -> Projects | required | Proyecto asociado. |
+| fase_objetivo | Relation -> Phases | required | Fase donde se consume/entrega. |
+| tipo_item | Select | required | `Feature`, `Task`, `Bug`, `Debt`, `Ops`. |
+| prioridad | Select | required | `P0`, `P1`, `P2`, `P3`. |
+| estado_item | Status | required | Flujo operativo de trabajo. |
+| owner_item | People | required | Responsable de ejecucion. |
+| estimacion_horas | Number | optional | Estimacion simple en horas. |
+| fecha_objetivo | Date | optional | Fecha objetivo de cierre. |
+| fecha_cierre | Date | optional | Fecha real de cierre. |
+| criterio_cierre | Rich text | required | Definicion concreta de terminado. |
+| sprint_lote | Rich text | optional | Referencia de sprint o lote. |
+| deliverable_destino | Relation -> Deliverables | optional | Entregable impactado por el item. |
+| riesgo_relacionado | Relation -> Risks | optional | Riesgo mitigado por este item. |
+| dependencia_items | Relation -> Backlog (self) | optional | Dependencias entre items. |
+
+## 5) DB: Risks
+
+Proposito: controlar riesgos de negocio/tecnicos con mitigacion activa.
+
+| Propiedad | Tipo | Req/Opt | Proposito |
+|---|---|---|---|
+| titulo_riesgo | Title | required | Riesgo expresado en lenguaje claro. |
+| proyecto | Relation -> Projects | required | Proyecto asociado. |
+| fase_detectada | Relation -> Phases | required | Fase donde se detecta. |
+| categoria | Select | required | `Negocio`, `Tecnico`, `Operativo`, `Dependencia`. |
+| probabilidad | Select | required | `Baja`, `Media`, `Alta`. |
+| impacto | Select | required | `Bajo`, `Medio`, `Alto`. |
+| estado_riesgo | Select | required | `Abierto`, `Mitigando`, `Cerrado`. |
+| owner_riesgo | People | required | Responsable de seguimiento. |
+| plan_mitigacion | Rich text | required | Accion concreta para reducir impacto/probabilidad. |
+| trigger_alerta | Rich text | optional | Senal temprana para detectar materializacion. |
+| backlog_mitigacion | Relation -> Backlog | optional | Trabajo creado para mitigarlo. |
+| decision_relacionada | Relation -> Decisions | optional | Decision que trata este riesgo. |
+| fecha_revision | Date | required | Proxima revision comprometida. |
+| fecha_cierre | Date | optional | Cierre formal del riesgo. |
+
+## 6) DB: Decisions
+
+Proposito: guardar decisiones relevantes con contexto y trazabilidad.
+
+| Propiedad | Tipo | Req/Opt | Proposito |
+|---|---|---|---|
+| titulo_decision | Title | required | Nombre corto de la decision. |
+| proyecto | Relation -> Projects | required | Proyecto asociado. |
+| fase | Relation -> Phases | required | Fase donde se toma. |
+| tipo_decision | Select | required | `Scope`, `Producto`, `Arquitectura`, `Operacion`. |
+| estado_decision | Select | required | `Propuesta`, `Aprobada`, `Descartada`. |
+| fecha_decision | Date | required | Fecha de toma o validacion. |
+| tomada_por | People | required | Quien toma o aprueba la decision. |
+| contexto | Rich text | required | Situacion que obliga a decidir. |
+| decision_tomada | Rich text | required | Resolucion concreta. |
+| impacto | Rich text | required | Impacto esperado en alcance, tiempo o riesgo. |
+| tradeoffs | Rich text | optional | Costos y renuncias aceptadas. |
+| entregable_evidencia | Relation -> Deliverables | optional | Documento/acta que la respalda. |
+| riesgo_relacionado | Relation -> Risks | optional | Riesgo asociado a la decision. |
+| incidente_relacionado | Relation -> Incidents | optional | Incidente que gatillo la decision. |
+
+## 7) DB: Incidents
+
+Proposito: operar incidentes y convertirlos en aprendizaje accionable.
+
+| Propiedad | Tipo | Req/Opt | Proposito |
+|---|---|---|---|
+| titulo_incidente | Title | required | Nombre del incidente. |
+| proyecto | Relation -> Projects | required | Proyecto asociado. |
+| fase_afectada | Relation -> Phases | required | Fase impactada al ocurrir. |
+| severidad | Select | required | `SEV1`, `SEV2`, `SEV3`, `SEV4`. |
+| estado_incidente | Status | required | `Abierto`, `Investigando`, `Resuelto`, `Cerrado`. |
+| owner_incidente | People | required | Responsable de coordinacion. |
+| fecha_inicio | Date (date-time) | required | Momento de deteccion. |
+| fecha_resolucion | Date (date-time) | optional | Momento de mitigacion/resolucion. |
+| impacto_negocio | Rich text | required | Efecto concreto sobre usuario/negocio. |
+| causa_raiz | Rich text | optional | Hallazgo de analisis causal. |
+| accion_inmediata | Rich text | required | Contencion ejecutada. |
+| accion_preventiva | Rich text | optional | Accion para evitar recurrencia. |
+| decision_relacionada | Relation -> Decisions | optional | Decision disparada por el incidente. |
+| backlog_correctivo | Relation -> Backlog | optional | Item correctivo/preventivo asociado. |
+| postmortem_url | URL | optional | Documento de postmortem final. |
+
+## Contrato minimo de relaciones cruzadas
+
+Implementar como minimo estas relaciones bidireccionales en Notion:
+
+1. `Projects <-> Phases`
+2. `Projects <-> Deliverables`
+3. `Projects <-> Backlog`
+4. `Projects <-> Risks`
+5. `Projects <-> Decisions`
+6. `Projects <-> Incidents`
+7. `Phases <-> Deliverables`
+8. `Phases <-> Backlog`
+9. `Phases <-> Risks`
+10. `Phases <-> Decisions`
+11. `Phases <-> Incidents`
+12. `Backlog <-> Deliverables`
+13. `Backlog <-> Risks`
+14. `Backlog <-> Incidents`
+15. `Risks <-> Decisions`
+16. `Decisions <-> Incidents`
+
+## Datos semilla recomendados
+
+- Cargar en `Phases` los 7 codigos canonicos para cada proyecto nuevo.
+- Dejar al menos 1 entregable obligatorio por fase antes de iniciar ejecucion.
+- Crear vistas base antes de cargar backlog masivo para evitar deuda de orden.

package/99-common/07-p1-notion-manual-setup-checklist.md

@@ -0,0 +1,72 @@
+# P1 Checklist - implementacion manual en Notion (MVP)
+
+## Preparacion
+
+- [ ] Crear pagina raiz `P1 - Management Template (multi-DB)`.
+- [ ] Confirmar alcance MVP: solo setup manual, sin API ni automatizaciones.
+- [ ] Confirmar responsables: owner operativo y aprobador de gate.
+- [ ] Tener a mano `99-common/05-p1-notion-multi-db-plan.md` y `99-common/06-p1-notion-schema-spec.md`.
+
+## Crear bases de datos
+
+- [ ] Crear DB `Projects` (tabla).
+- [ ] Crear DB `Phases` (tabla).
+- [ ] Crear DB `Deliverables` (tabla).
+- [ ] Crear DB `Backlog` (tabla).
+- [ ] Crear DB `Risks` (tabla).
+- [ ] Crear DB `Decisions` (tabla).
+- [ ] Crear DB `Incidents` (tabla).
+
+## Configurar propiedades por DB
+
+- [ ] Cargar propiedades de `Projects` segun spec.
+- [ ] Cargar propiedades de `Phases` segun spec.
+- [ ] Cargar propiedades de `Deliverables` segun spec.
+- [ ] Cargar propiedades de `Backlog` segun spec.
+- [ ] Cargar propiedades de `Risks` segun spec.
+- [ ] Cargar propiedades de `Decisions` segun spec.
+- [ ] Cargar propiedades de `Incidents` segun spec.
+
+## Configurar relaciones bidireccionales
+
+- [ ] Configurar relaciones `Projects <->` todas las demas DB.
+- [ ] Configurar relaciones `Phases <-> Deliverables/Backlog/Risks/Decisions/Incidents`.
+- [ ] Configurar `Backlog <-> Deliverables`.
+- [ ] Configurar `Backlog <-> Risks`.
+- [ ] Configurar `Backlog <-> Incidents`.
+- [ ] Configurar `Risks <-> Decisions`.
+- [ ] Configurar `Decisions <-> Incidents`.
+
+## Cargar catalogos y datos semilla
+
+- [ ] En `Phases`, dejar lista de codigos canonicos `01..07` para el proyecto piloto.
+- [ ] Definir valores de estados y prioridades en selects/status segun spec.
+- [ ] Crear 1 proyecto piloto en `Projects` con owner y objetivo.
+- [ ] Crear 7 registros de fase del proyecto piloto (uno por codigo).
+- [ ] Crear al menos 1 entregable obligatorio para `01-business` y `02-proposal`.
+
+## Crear vistas requeridas
+
+- [ ] Crear vistas MVP de `Projects` (Dashboard, En riesgo).
+- [ ] Crear vistas MVP de `Phases` (Board de gate, Timeline).
+- [ ] Crear vistas MVP de `Deliverables` (Pendientes de aprobacion, Por fase).
+- [ ] Crear vistas MVP de `Backlog` (Priorizado, Ejecucion, Sin criterio de cierre).
+- [ ] Crear vistas MVP de `Risks` (Activos, Alto impacto).
+- [ ] Crear vistas MVP de `Decisions` (Pendientes, Aprobadas).
+- [ ] Crear vistas MVP de `Incidents` (Activos, Postmortem pendiente).
+
+## Ritual operativo inicial
+
+- [ ] Agendar ritual diario (15 min) para backlog/incidentes/bloqueos.
+- [ ] Agendar ritual semanal (45 min) para riesgos/decisiones/entregables.
+- [ ] Definir formato de cierre de gate por fase (`Go/No-Go` + condiciones).
+
+## Validacion final (DoD de implementacion manual)
+
+- [ ] Se puede navegar desde un `Project` hacia todas las DB relacionadas.
+- [ ] Cada fase tiene owner, criterios de gate y estado actual.
+- [ ] Los entregables obligatorios muestran claramente si bloquean gate.
+- [ ] Existe backlog priorizado con criterio de cierre por item.
+- [ ] Riesgos activos tienen owner y plan de mitigacion.
+- [ ] Decisiones e incidentes tienen trazabilidad con evidencia o acciones.
+- [ ] El equipo puede correr una revision semanal sin editar el schema.

package/99-common/AGENTS.md

@@ -0,0 +1,20 @@
+# AGENTS
+
+Entrypoint local para trabajo en `99-common`.
+
+## Scope
+
+Concentrar artefactos transversales (checklist, glosario y base comun).
+
+## Reglas locales
+
+- Mantener contenido reusable por todas las fases.
+- Evitar duplicacion con otras carpetas.
+
+## Orden de carga recomendado
+
+1. Contexto global: `.opencode/context.md`
+2. AGENTS local: `99-common/AGENTS.md`
+3. Skill global: `.opencode/skills/global/SKILL.md`
+4. Skill local: `99-common/skills/SKILL.md`
+5. Rol: `AGENTS.md` (raiz)

package/99-common/project.config.json

@@ -0,0 +1,7 @@
+{
+  "projectName": "{{PROJECT_NAME}}",
+  "type": "backend",
+  "architecture": "microservices",
+  "useNotion": false,
+  "useDocker": true
+}

package/99-common/skills/SKILL.md

@@ -0,0 +1,9 @@
+---
+name: local-common-conventions
+description: Convenciones transversales del proyecto. Trigger: cambios en 99-common.
+---
+
+# Skill local 99-common
+
+- Consolidar definiciones y criterios globales.
+- Mantener actualizados checklist y glosario.

package/AGENTS.md

@@ -0,0 +1,275 @@
+# AGENTS.md
+
+## Propósito
+
+Este repositorio implementa un framework para ejecutar proyectos de software de mediana escala.
+
+La estructura de carpetas y templates ya están definidos.
+
+El objetivo del agente NO es crear estructura, sino:
+
+👉 **completar, guiar y mantener consistencia en cada fase del proyecto**
+
+---
+
+# Rol del agente
+
+El agente actúa como un **orquestador de ejecución del proyecto**.
+
+Debe:
+
+- guiar al usuario en cada fase (Discovery → Proposal → Design → ...)
+- utilizar skills específicas para completar documentos
+- asegurar que cada documento tenga contenido útil
+- evitar saltos de fase sin validación previa
+
+---
+
+# Qué hace el agente
+
+## 1. Guiar el flujo del proyecto
+
+Debe asegurar que se siga este orden:
+
+1. Discovery
+2. Proposal
+3. Design
+4. Management
+5. Development
+6. Deployment
+7. Production
+
+---
+
+## 2. Completar documentación
+
+Debe:
+
+- usar los templates existentes
+- llenar contenido con base en contexto real
+- hacer preguntas cuando falte información
+- evitar contenido genérico
+
+---
+
+## 3. Usar skills por fase
+
+Cada fase tiene skills asociadas.
+
+El agente debe:
+
+- seleccionar la skill adecuada
+- aplicar la skill sobre el documento correcto
+- iterar hasta que el documento sea útil
+
+---
+
+## 4. Validar antes de avanzar
+
+No debe permitir avanzar si:
+
+- el problema no está claro
+- el flujo no está definido
+- el alcance es ambiguo
+- la solución no está validada
+
+---
+
+# Qué NO hace el agente
+
+- ❌ No crea estructura de carpetas
+- ❌ No genera templates base
+- ❌ No rellena documentos sin contexto
+- ❌ No propone soluciones prematuras
+- ❌ No permite saltar fases
+
+---
+
+# Principios de trabajo
+
+## 1. Primero entender, luego proponer
+
+Discovery siempre antes que Proposal.
+
+## 2. Nada de texto decorativo
+
+Cada documento debe servir para tomar decisiones.
+
+## 3. Preguntar antes de asumir
+
+Si falta información, el agente pregunta.
+
+## 4. Iterar sobre los documentos
+
+No generar versiones finales de una sola vez.
+
+## 5. Mantener consistencia
+
+Lo definido en BUSINESS debe reflejarse en DESIGN y MANAGEMENT.
+
+---
+
+# Flujo operativo
+
+## Discovery
+
+Objetivo:
+
+- entender negocio
+- mapear flujo actual
+- detectar problema real
+
+Acciones del agente:
+
+- guiar reunión
+- generar preguntas
+- completar:
+  - business-understanding
+  - problem-statement
+  - as-is-flow
+  - scope
+
+---
+
+## Proposal
+
+Objetivo:
+
+- validar solución con el negocio
+
+Acciones del agente:
+
+- resumir problema
+- proponer solución a alto nivel
+- definir alcance claro
+- completar proposal.md
+
+---
+
+## Design
+
+Objetivo:
+
+- definir cómo se construye la solución
+
+Acciones del agente:
+
+- diseñar arquitectura
+- definir componentes
+- modelar datos
+- definir APIs
+- estrategia de errores
+
+---
+
+## Management
+
+Objetivo:
+
+- estructurar ejecución
+
+Acciones del agente:
+
+- generar backlog
+- definir roadmap
+- identificar riesgos
+- estructurar tareas
+
+---
+
+## Development
+
+Objetivo:
+
+- implementar solución
+
+Acciones del agente:
+
+- definir estándares
+- estructurar proyecto
+- definir testing
+
+---
+
+## Deployment
+
+Objetivo:
+
+- preparar operación
+
+Acciones del agente:
+
+- definir ambientes
+- configurar CI/CD
+- definir monitoreo
+
+---
+
+# Interacción con el usuario
+
+El agente debe trabajar así:
+
+1. identificar fase actual
+2. hacer preguntas específicas
+3. proponer contenido
+4. ajustar según feedback
+5. completar documento
+
+---
+
+# Reglas de calidad
+
+Un documento está bien si:
+
+- responde preguntas clave de la fase
+- es claro y directo
+- no tiene ambigüedades
+- puede ser usado para tomar decisiones
+
+---
+
+# Dependencia de skills
+
+El agente depende de:
+
+- skills de discovery
+- skills de proposal
+- skills de design
+- skills de management
+
+El agente NO reemplaza las skills, las orquesta.
+
+---
+
+# Modo de decisión
+
+Priorizar siempre:
+
+1. claridad del problema
+2. utilidad del documento
+3. simplicidad
+4. consistencia
+5. avance del proyecto
+
+---
+
+# Resultado esperado
+
+Al usar este agente:
+
+- los documentos se completan progresivamente
+- el proyecto avanza por fases claras
+- se evita improvisación
+- se mantiene coherencia entre negocio, diseño y ejecución
+
+---
+
+# En resumen
+
+Este agente no crea proyectos.
+
+👉 **los hace avanzar correctamente**
+👉 **los mantiene ordenados**
+👉 **los convierte en ejecutables**
+
+---