Desarrollar con evidencia

Un cambio de principio a fin

Diagrama técnico · fuente Mermaid versionada

Ver fuente textual accesible

flowchart LR
  Request[Requisito] --> Plan[Roles y dependencias]
  Plan --> Checkpoint[Checkpoint previo]
  Checkpoint --> Work[Implementación aislada]
  Work --> Gates[Pruebas y quality gates]
  Gates --> Review[Revisión]
  Review --> Integrate[Integración]
  Integrate --> Docs[Memoria y documentación]
  Gates -->|fallo| Repair[Diagnóstico y corrección limitada]
  Repair --> Gates

Planificar

python kit.py orchestrate --request "Agregar API con autenticación" --max-roles 4
python kit.py task ready
python kit.py agent list

El plan es una selección por reglas, no una autorización de ejecución. --apply crea tareas y un checkpoint; ajusta sus criterios al negocio antes de implementar. Los roles y skills disponibles están en los catálogos.

Preparar y revisar

python kit.py checkpoint create --label "Antes del cambio" --expected "Describir el resultado verificable"
python kit.py test
python tools/docs_manager.py scan

En EIP, declara entradas, salidas y gates. Los trabajos independientes usan workspaces separados; archivos compartidos conservan reservas hasta la revisión. Nunca edites simultáneamente los mismos archivos sin coordinación.

Coordinación multiagente

Diagrama técnico · fuente Mermaid versionada

Ver fuente textual accesible

sequenceDiagram
  participant O as Orquestador
  participant A as Trabajo A
  participant B as Trabajo B
  participant Q as Revisión
  O->>O: Validar permisos, DAG y presupuesto
  par Entradas y salidas independientes
    O->>A: Reservar archivos y lease
    A-->>O: Candidato y gates
  and
    O->>B: Reservar archivos y lease
    B-->>O: Candidato y gates
  end
  O->>Q: Consolidar candidatos
  Q->>O: Aprobar integración acotada
  O->>O: Checkpoint, journal y verificación de hashes

Actualizar documentación

Edita la fuente original en docs/, los contratos o las guías en documentation/content/. Después ejecuta generate, validate y build. scan detecta fuentes modificadas y sugiere revisar arquitectura cuando cambia el núcleo; no afirma comprender semánticamente cada decisión. Los cambios manuales en salidas generadas bloquean su sobrescritura.

Guía de desarrollo existente · Contribuir