CommunityRedacción y edicióngithub.com

ohm41321/luciazero

Disciplina de verificación como primer principio para agentes de codificación (Claude Code + Codex CLI): doctrina de 9 reglas, seis habilidades, agente revisor adversarial, enganches de cumplimiento con apertura ante fallos. «Hecho» se demuestra con un comando, no con una opinión.

¿Qué es luciazero?

LuciaZero es un skill de verificación rigurosa para agentes de codificación como Claude Code y Codex CLI. Establece una disciplina de 9 reglas organizada en seis pasos que obliga a ejecutar verificaciones completas en el momento, realizar una lectura adversarial del diff, ejecutar revisiones independientes según el riesgo (seguridad, contrato, general), verificar el alcance contra la solicitud original, registrar lecciones de callejones sin salida, y generar un informe estandarizado. Su objetivo es eliminar la ambigüedad: «hecho» ya no es una opinión del desarrollador, sino la salida exitosa de un comando de verificación. El skill incluye scripts auxiliares como `revert-probe.sh` para comprobar la honestidad de las pruebas, y soporta modos de salida bloqueada o completada con formato JSON. Está diseñado para equipos que buscan trazabilidad y repetibilidad en el desarrollo asistido por IA.

Compatible con✓Claude Code✓Codex CLI~Cursor
npx skills add ohm41321/luciazero

Installed? Explore more Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Hecho

1. Verificación completa

Ejecuta el nivel completo ahora: verify-full si está presente, de lo contrario verify. Cita la línea más corta y concluyente.

  • Rojo → aún no estás aquí. Vuelve al bucle.
  • No existe un comando verify → usa /ready; no afirmes que está hecho.
  • Debe haberse ejecutado realmente ahora, no antes en la sesión.

2. Revisión escéptica del diff

Vuelve a leer el diff final como un revisor hostil. Comprueba:

  • Casos límite: vacíos, cero, Unicode, fronteras, concurrencia.
  • Caminos de error: fallos, archivos faltantes, red caída, limpieza.
  • Contratos cambiados: APIs, formatos, esquemas, configuración, consumidores anteriores.
  • Contenido accidental: archivos no relacionados, código de depuración, secretos, dependencias sueltas.
  • Honestidad de las pruebas: ¿las pruebas modificadas fallarían si la implementación se revierte?

Cuando corresponda, ejecuta: <this-skill-dir>/scripts/revert-probe.sh "<verify-cmd>". Las comprobaciones debilitadas son hallazgos. Corrige los hallazgos y repite la verificación completa.

3. Revisión independiente orientada al riesgo

Elige el enfoque:

  • security: autenticación, permisos, entrada, rutas, comandos, secretos, endpoints.
  • contract: API/CLI pública, esquema, configuración, migración, consumidores.
  • general: dinero, concurrencia, recursos, o un diff amplio e incierto.

Prefiere el comando de revisión incorporado del arnés; de lo contrario, utiliza un agente revisor. Si aplican tanto seguridad como contrato, solicita dos pases independientes centrados. El revisor lee los invocadores y consumidores.

Corrige y vuelve a verificar cada blocker o major, a menos que el usuario acepte explícitamente el riesgo nombrado. Un minor puede diferirse solo cuando se informa. Un diff pequeño y bien comprendido sin riesgo dirigido puede detenerse después del pase escéptico.

4. Verificación del alcance

Vuelve a leer la solicitud original. Cada elemento está entregado, o se menciona como omitido con una razón. Nunca omitas alcance en silencio. Una tarea del bus que hayas reclamado mediante /lucia-bus debe estar completed o blocked, con su resultado publicado, a menos que el usuario la haya cancelado.

5. Lecciones

Para un callejón sin salida, un riesgo oculto o un enfoque refutado, ejecuta /retro. Si es necesario transferir un estado incompleto, usa /lucia-relay en su lugar.

6. Informe

Hecho: <lo que cambió, una línea>
Prueba: <comando de verificación> → <línea concluyente>
No cubierto: <brecha de verificación>
Omitido: <alcance omitido + razón, o nada>

Sin ambigüedades: informa "hecho" solo después de que cada paso pase. La salida de la máquina refleja los mismos hechos; la salida bloqueada usa "status": "blocked" y su línea fallida.

{
  "status": "done",
  "verify": {"command": "./test.sh", "exit_code": 0, "decisive_line": "PASS  todas las comprobaciones en verde"},
  "not_covered": "<brecha de verificación>",
  "left_out": "nada"
}

Skills relacionados