CommunityEscrita e Ediçãogithub.com

ohm41321/luciazero

Disciplina de verificação em primeiro lugar para agentes de codificação (Claude Code + Codex CLI): doutrina de 9 regras, seis habilidades, agente revisor adversário, ganchos de enforcement com falha aberta. 'Pronto' é comprovado por um comando, não por opinião.

O que é luciazero?

Lucia Zero é uma skill para agentes de codificação como Claude Code e Codex CLI que impõe uma disciplina rigorosa de verificação em primeiro lugar para garantir que tarefas sejam concluídas de forma confiável e mensurável. Ela implementa uma doutrina de 9 regras com seis habilidades principais: verificação completa de todos os testes, uma passagem cética pelo diff final como revisor hostil, revisão independente orientada por risco em segurança/contrato/geral, verificação de escopo contra a solicitação original, lições aprendidas de becos sem saída ou abordagens refutadas, e um relatório final estruturado sem rodeios. A skill utiliza um agente revisor adversário e ganchos de enforcement com falha aberta para forçar que 'pronto' seja comprovado por um comando e não por opinião. Seu principal benefício é evitar entregas incompletas ou defeituosas, garantindo que cada alteração passe por verificações rigorosas de bordas, caminhos de erro, contratos alterados e conteúdo acidental, além de exigir uma re-verificação após qualquer correção.

Funciona com✓Claude Code✓Codex CLI~Cursor
npx skills add ohm41321/luciazero

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Pronto

1. Verificação completa

Execute o nível completo agora: verify-full quando presente, caso contrário verify. Cite a linha mais curta e decisiva.

  • Vermelho → você ainda não está aqui. Retorne ao loop.
  • Nenhum comando de verificação existe → use /ready; não afirme que está pronto.
  • Deve realmente ter sido executado agora, não no início da sessão.

2. Passagem cética do diff

Releia o diff final como um revisor hostil. Verifique:

  • Casos extremos: vazio, zero, unicode, limites, concorrência.
  • Caminhos de erro: falhas, arquivos ausentes, rede perdida, limpeza.
  • Contratos alterados: APIs, formatos, schema, configuração, consumidores antigos.
  • Conteúdo acidental: arquivos não relacionados, código de depuração, segredos, pinos soltos.
  • Honestidade dos testes: os testes alterados falhariam se a implementação fosse revertida?

Quando aplicável, execute <this-skill-dir>/scripts/revert-probe.sh "<verify-cmd>". Verificações enfraquecidas são considerações. Corrija as considerações e repita a verificação completa.

3. Revisão independente orientada por risco

Escolha o foco:

  • segurança: autenticação, permissões, entrada, caminhos, comandos, segredos, endpoints.
  • contrato: API/CLI pública, schema, configuração, migração, consumidores.
  • geral: dinheiro, concorrência, recursos, ou um diff amplo e incerto.

Prefira o comando de revisão embutido do harness; caso contrário, use um agente revisor. Se segurança e contrato forem ambos aplicáveis, solicite duas passagens independentes focadas. O revisor lê os chamadores e consumidores.

Corrija e reverifique cada bloqueador ou grave, a menos que o usuário aceite explicitamente o risco nomeado. Um menor pode ser adiado apenas quando relatado. Um diff pequeno e bem compreendido sem risco roteado pode parar após a passagem cética.

4. Verificação de escopo

Releia a solicitação original. Cada item é entregue, ou nomeado como omitido com uma razão. Nunca omita escopo silenciosamente. Uma tarefa de ônibus que você reivindicou via /lucia-bus deve estar concluída ou bloqueada, com seu resultado publicado, a menos que o usuário a cancele.

5. Lições

Para um beco sem saída, armadilha ou abordagem refutada, execute /retro. Se o estado não finalizado precisar ser transferido, use /lucia-relay.

6. Relatório

Pronto: <o que mudou, uma linha>
Prova: <comando de verificação> → <linha decisiva>
Não coberto: <lacuna de verificação>
Omitido: <escopo omitido + razão, ou nada>

Sem rodeios: relate 'pronto' apenas depois que cada etapa passar. A saída da máquina espelha os mesmos fatos; a saída bloqueada usa "status": "blocked" e sua linha de falha.

{
  "status": "done",
  "verify": {"command": "./test.sh", "exit_code": 0, "decisive_line": "PASS  all checks green"},
  "not_covered": "<lacuna de verificação>",
  "left_out": "nada"
}

Habilidades Relacionadas