Cómo funciona uscha: las piezas en movimiento

Se lee de izquierda a derecha: el método gobierna · la herramienta ejecuta · la evidencia decide · el humano aprueba

1 · El método gobierna 2 · La herramienta ejecuta 3 · La evidencia decide 4 · El humano aprueba Vos la idea Skills de spec discovery · adr-refine ¿Sistema viejo? reverse-discovery + characterize El contrato ADR + ACCEPTANCE model-check TLA+ para diseños con estado Agente + devloop construye y revisa Claude · Codex · pi Revisores nivel según rutas + linters Hooks nunca escribe goldens guarda del PR qa_ledger.py el motor tests · cobertura · mutación QA-LEDGER.json la evidencia Lecturas status · mirador statusline Gate pr-ready readiness check-terminado Vos aprobás el merge idea escribe goldens verifica construye hallazgos bloquea registra guarda lee deriva listo Legend External Frontend Database Security Backend

1 · El método gobierna

  • • Antes del código, una skill de spec te entrevista y escribe el contrato: ADRs + ACCEPTANCE (los criterios).
  • • Idea nueva: discovery. Feature conocida: adr-refine. Sistema viejo: reverse-discovery + characterize.
  • • Un diseño con estado y reglas se verifica primero con un modelo (TLA+).

2 · La herramienta ejecuta

  • • El agente construye contra el contrato y corre el loop de revisión (devloop).
  • • Las rutas tocadas fijan un nivel de revisión (quick · standard · deep) que elige los revisores; el motor le asigna a cada uno su alcance, y cada hallazgo nombra ruta:regla.
  • • Los hooks frenan lo que el agente nunca debe hacer, como escribir un golden aprobado.

3 · La evidencia decide

  • • El motor guarda solo corridas medidas; nunca le cree al agente.
  • • La cobertura dice que una línea corrió; la mutación (PIT, pit-check) dice si un test la atraparía cambiando.
  • • El gate lee el ledger: tests al día, aceptación en verde, cada hallazgo localizado arreglado o diferido, el pase limpio de cada revisor del nivel vigente.
  • • Las lecturas muestran los mismos números; nunca calculan los suyos.

4 · El humano aprueba

  • • Vos decidís la spec, aprobás los goldens y aprobás el merge.
  • • Solo un humano baja un nivel de revisión o confirma un diferimiento.
  • • El agente no puede declarar 'terminado': lo declara el gate, desde la evidencia.