tderoussel/overnight-build

Compõe um prompt de build autônomo e não supervisionado para o Claude Code, que sobrevive a reinícios de limite de uso via checkpointing em BUILD_LOG.md, além do lançador que o reinicia.

O que é overnight-build?

Esta skill permite que desenvolvedores criem prompts de build que podem rodar de forma autônoma durante a noite, sobrevivendo a reinícios de limite de uso do Claude Code. O segredo está no checkpointing via arquivo `BUILD_LOG.md`, que registra o progresso e permite que o build continue exatamente de onde parou após um reset. A skill gera um prompt que inclui regras de guarda (como não aplicar migrações de banco de dados ou enviar mensagens para contatos reais), fases de execução independentes e verificáveis, e um playbook de pivô para lidar com bloqueadores. O prompt final é fornecido em um único bloco de código copiável, que o usuário salva em `overnight-build-prompt.txt` e executa com um dos três lançadores suportados: agendador do SO, loop bash ou MCP de tarefa agendada. A skill é especialmente útil para builds longos e complexos que o desenvolvedor não deseja monitorar manualmente.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tderoussel/agent-skills/tree/main/skills/overnight-build

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

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

Documentação

Prompt de build noturno

O template completo está em references/overnight-build-template.md. Leia-o antes de compor. Não derive a estrutura de regras de memória — preencha suas seções [ENTRE_COLCHETES] com as especificidades do usuário e preserve quaisquer edições que ele tenha feito em sua própria cópia.

Inegociável

Cada saída deve conter obrigatoriamente a Regra 8 (sobreviver a reinícios de uso) e a seção LANÇADOR. São elas que tornam o build reiniciável; um prompt sem elas recomeça silenciosamente do zero após o primeiro reset de uso e queima uma noite.

Compor

  1. Leia o template. Se o usuário mantiver uma cópia editada, a dele vence — preserve suas alterações.
  2. Preencha a especificação — o que construir, contexto, requisitos de design, requisitos técnicos, funcionalidades em ordem de prioridade, dados de semente, implantação, critérios de sucesso. Especificidade aqui é o jogo todo; uma especificação vaga produz uma noite vaga.
  3. Defina as fases — 4 a 8, cada uma independentemente concluível e verificável, com alocações de tempo que somem o orçamento.
  4. Preencha o playbook de pivô com bloqueadores específicos do projeto, além dos fixos do template.
  5. Pergunte uma vez qual lançador eles querem (A: agendador do SO · B: loop bash · C: um MCP de tarefa agendada), se a solicitação não disser. Pergunte uma vez — depois prossiga.
  6. Forneça a saída como um único bloco de código copiável e lembre-os de salvá-lo em overnight-build-prompt.txt na raiz do projeto antes de lançar.

Sinalização de conclusão

O prompt deve instruir o build a emitir BUILD_COMPLETE como sua linha final — o executor de loop bash grep por ela para sair. Indique claramente, no prompt, que omitir BUILD_COMPLETE é correto quando qualquer critério P0 não for genuinamente atendido. Um executor que sai em um build inacabado é pior do que um que continua.

Guardrails

Um agente não supervisionado não tem ninguém para perguntar, então o prompt deve carregar seus próprios limites.

Se o alvo for uma base de código de produção existente, derive primeiro a propriedade dos arquivos e uma lista de NÃO FAZER (a skill fleet-brief produz ambas) e carregue as verificações de validação do projeto na fase de teste, para que "pronto" signifique verificado, não apenas mesclado.

Nunca permita que um prompt noturno autorize aplicar migrações de banco de dados, enviar schema, implantar via CLI de hospedagem, comprar ou liberar números de telefone ou domínios, ou enviar mensagens para contatos reais. Isso precisa de um humano acordado. Adicione as próprias ações irreversíveis do projeto a essa lista.

Entregáveis que o build deve escrever

  • BUILD_LOG.md — entradas de fase, decisões, pivôs, problemas conhecidos e blocos ## CHECKPOINT — <ISO> com o próximo passo exato
  • RESEARCH_NOTES.md — descobertas de pesquisa antes do início da implementação

Ao retomar, a primeira ação literal do build é ler BUILD_LOG.md de cima a baixo e continuar a partir do checkpoint mais recente — nunca repesquisar, reestruturar ou reiniciar.

Individual skills in this repo

This repo contains 8 individual skills — each has its own dedicated page.

tderoussel/codebase-audit

Runs a ranked, evidence-backed audit of a product, codebase, or subsystem, ending in a verify list that separates proven findings from inferred ones. Use when the user asks for an audit, a gap analysis, a deep read, a bug hunt, a readiness check, a re-audit, a state reconciliation, or asks what they are not seeing. Trigger phrases include "audit", "gap analysis", "what am I missing", "deep audit", "readiness", "bug hunt", "review the whole thing". Produces findings and a verify list; does not fix.

tderoussel/competitive-teardown

Researches a competing product against your own and produces a ranked build-or-ignore verdict, plus optional comparison-page copy. Use when the user names a competitor or asks how their product stacks up against one. Trigger phrases include "vs us", "competitor", "what does X have", "should we copy", "competitive gap", "teardown", "are we behind". Produces a ranked verdict with effort estimates and an explicit not-worth-copying list.

tderoussel/decision-council

Run a structured multi-perspective review of a decision instead of getting one agreeable answer. Use when the user says run a council, get me perspectives on this, should I do X, stress-test this decision, or is this a good idea.

tderoussel/fleet-brief

Authors a workstream brief for dispatching multiple parallel build agents across one codebase, with per-lane file ownership, shared-ground warnings, and a derived DO-NOT list. Use whenever work is about to be split across concurrent agents, workers, lanes, or waves — even if the user does not say "write a brief". Trigger phrases include "fan out", "parallel agents", "orchestrate this", "split into lanes", "workstreams", "run these in parallel", "review-gated build". Produces the brief; does not dispatch.

tderoussel/inbox-triage

Triage an email inbox — sort what needs a reply, draft the replies, flag what needs a decision, and surface what can be ignored or unsubscribed. Use when the user says triage my inbox, do my email, what's in my inbox, or clean up my email.

tderoussel/session-log

Write a durable record of a work session — what was built, root-caused, or shipped — into the project's notes. Use when the user says log this session, write a session log, record this, or when a substantial piece of work has just finished and needs to be handed off to a future session.

tderoussel/ship-gate

Verification gate for a Next.js-on-Vercel + Supabase + GitHub Actions stack, to run before claiming anything is shipped, deployed, live, merged, passing, or done. Use before saying a change is in production, before merging a PR, before reporting CI green, and before writing any status into a document — even if the user does not ask for verification. Trigger phrases include "is it live", "did it deploy", "ship it", "merge it", "is CI green", "confirm prod", "did that work". Encodes traps where the obvious check returns a false pass.

tderoussel/vault-doctor

Audits and repairs an Obsidian vault's structural health — broken [[wikilinks]], ambiguous duplicate filenames, missing or malformed frontmatter, stale status markers, and hub notes whose state sections have gone cold. Use when the user asks about vault health, broken links, vault cleanup, dead links, orphan notes, tag consistency, or says the vault feels messy or out of date. Trigger phrases include "vault health", "broken links", "clean up the vault", "audit the vault", "is the vault current". Read-only by default; every repair is proposed before it is made.

Habilidades Relacionadas