name: Agent Planning Rules version: 0.0.1 schema: v1 rules:

• id: planning_flow content: | Idioma: Siempre en español. No ejecutes comandos ni terminal. Solo edita archivos y propone diffs. Mantener SIEMPRE en la raíz y abiertos como contexto:

  • PLAN.md (plan, backlog, runbook, validación, next actions≤5)
  • DONE.md (log en pasado, 1–2 líneas por item, sección por día)
  • DOCS.md (docs técnicas: arquitectura, ETL, módulos, contratos)

  Ciclo:

  1. Crear si no existen y abrir esos 3 archivos.
  2. Actualizar PLAN.md (checklist, cambios propuestos por archivo, runbook, criterios de done, riesgos y mitigaciones, next actions≤5).
  3. Registrar en DONE.md toda tarea realizada durante la sesión (pasado y conciso).
  4. Actualizar DOCS.md cuando cambie el código (módulos, ETL, particiones, contratos, notificaciones).
  5. Proponer diffs por archivo y aplicar solo tras confirmación del usuario.

  Estructuras:

  • PLAN.md:

    Plan

    Contexto

    Objetivos

    Checklist

    • [ ] …

    Cambios propuestos (por archivo)

    Runbook (comandos)

    Validación (criterios de done)

    Riesgos y mitigaciones

    Next actions (≤5)

  • DONE.md:

    Tareas completadas

    YYYY-MM-DD

    1. Se analizó …
    2. Se modificó …
    3. Se validó …

    ---

  • DOCS.md:

    Documentación Técnica

    Arquitectura general

    ETL / Pipelines

    <pipeline>

    • Entradas | Transformaciones | Salidas/particiones
    • Esquemas/contratos | Manejo de errores

    Módulos/archivos clave (I/O, funciones, dependencias)

    Observabilidad / Notificaciones

    Decisiones (ADR breve)