ZynplexZPX Forgeby Zynplex
Empezar.md

Conceptos

ConceptoQué es
EmpresaEl cliente. Tiene miembros, proyectos, instalaciones de GitHub y su propio harness. Una persona puede pertenecer a varias empresas.
ProyectoLo que se construye. Agrupa repos, specs, backlog, harness y nivel de autonomía.
RepositorioUna carpeta de código del proyecto en GitHub (front, back, infra…). Tiene rama de integración (develop) y de producción (main).
Casa de las specsEl repo donde vive specs/ de SpecKit para ese proyecto.
SpecUna feature de SpecKit: spec.md (qué y por qué), plan.md (cómo) y tasks.md (tareas).
HarnessLas reglas que siguen tus agentes en un proyecto: estándares (AGENTS.md), comandos y qué decisiones exigen a una persona.
AgenteClaude Code, Codex u otro agente con acceso al CLI, que corre en la máquina de un desarrollador con su propia suscripción.
Fase / olaUna fase es un hito con valor (MVP, v1…). Una ola es un grupo de tareas sin archivos compartidos que pueden correr en paralelo.
Clasificación de tareaCada tarea tiene un área (docs, ui, api, core, data, infra, security), una talla (XS–XL) y un riesgo (R0–R3). El riesgo decide cuánta documentación, revisión y aprobación necesita.
SubagenteAyudante efímero que lanza un agente: explorer (lee), verifier (corre los checks), reviewer y challenger (revisión adversarial).
ReporteSalida estructurada que un agente envía a ZPX Forge (spec, plan, avance, revisión, bloqueo, entrega). Las personas lo leen como vista, no como archivo.
AprobaciónUna decisión que exige a una persona: spec, arquitectura, acción riesgosa o pase a producción.

El ciclo de una feature

Alcance → spec.md → aprobación (PM/PO) → plan.md + tasks.md → backlog
  → un dev toma una tarea → su agente trabaja en una worktree y una rama
  → PR a develop → revisión → release aprobado → main = producción

Ramas

RamaPara quéQuién la cambia
mainProducciónSolo por PR de release aprobado
developIntegración / stagingPor PR desde ramas de tarea
feat/<tarea>-…Una tarea, vida cortaEl dev y su agente

Evidencia y decisiones

Lo declarado es un reporte del equipo. Lo observado incluye el resultado que Forge consulta en GitHub para el commit y la prueba acordados. Un riesgo aceptado registra el motivo y quién lo asume. El responsable de la entrega decide si comparte la ficha. El cliente decide si acepta esa versión.