Um Padrão para Executar Claude Code em Sessões Noturnas Não Supervisionadas Sem Desvio

Executor da Cadeia

Executa uma sequência fixa de habilidades por N iterações:

bin/skill-chain.py --chain dev-cycle-with-review-looped --loop 10

Cada iteração: uma habilidade de desenvolvimento pega o próximo item de docs/TODO.md, o implementa (código + testes + documentação em um único commit), então uma habilidade de revisão critica o que foi feito e coloca itens de acompanhamento no TODO. Loop de agente padrão tornado explícito.

Supervisor ao Final da Sessão

Após o loop terminar, uma habilidade separada lê as transcrições da execução, avalia cada habilidade em relação à sua função declarada e propostas de reescrita da própria descrição da habilidade. Com autopromoção ativada, essas reescritas são aplicadas. Autopromoção desativada as escreve como sidecars SKILL.patch.md para revisão humana.

Contrato Único de Handoff

Toda habilidade lê docs/SPEC.md (plano canônico) e docs/TODO.md (Em andamento / Acabou de ser enviado / Próximo) no início, e os atualiza no mesmo commit da alteração de código. Sem canais laterais, sem segundo formato de TODO, sem documentos de plano por habilidade. O framework aplica esse contrato em seu próprio desenvolvimento. O contrato faz a maior parte do trabalho de eliminação de desvios.

Funcionalidades Adicionais

• Divisão proprietário / transferível: Habilidades em skills/framework/ são transferíveis; cada projeto mantém sua contraparte proprietária em .claude/skills/. Uma habilidade de sanitização verifica promoções nesse limite para que segredos não vazem.
• Validação de esquema: bin/validate-frontmatter.py contra schema/skill-set.schema.json e schema/skill-chain.schema.json detecta habilidades malformadas antes de uma execução da cadeia.
• Direcionamento opcional via Telegram: Mensagens de status no início da sessão, em cada limite de iteração, cada pausa/retomada por limite de taxa e no final da sessão. Comandos de fila de volta via /cmd que a próxima iteração consome.
• Cadeia noturna: Loop até falha, orçamento limite ou Ctrl-C, com um atraso aleatório entre iterações de 5 min a 2 h para que a cadência de commits permaneça com aparência humana.

Repositório

https://github.com/toadlyBroodle/skill-set