juliusbrussee/spec

Crie, altere ou propague bugs de volta para SPEC.md na raiz do repositório. Único mutador das especificações do projeto.

O que é spec?

Esta skill permite que você crie, modifique ou registre bugs na especificação do projeto, armazenada em SPEC.md na raiz do repositório. É o único componente autorizado a alterar a especificação, garantindo consistência. A skill é ativada quando o usuário solicita escrever uma nova spec, destilar uma spec a partir do código existente, adicionar invariantes, alterar seções específicas (§G, §C, §I, §V, §T, §B) ou registrar um bug via backpropagation — uma funcionalidade que permite incorporar bugs na spec como parte do processo de design. Exemplos de comandos incluem: "escreva a spec para...", "nova spec", "bug: ...", "altere §V.3", "destile spec do código" e "spec esta ideia". A skill segue rigorosamente o formato definido em FORMAT.md para codificação simplificada ("caveman encoding") e a estrutura de tabelas de pipe para as seções §T e §B. É compatível com agentes de IA como Claude Code, Cursor e Codex, facilitando a colaboração em projetos com specs vivas que evoluem com o código e os requisitos.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/juliusbrussee/cavekit/tree/main/skills/spec

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

O que spec faz?

Crie, altere ou propague bugs de volta para SPEC.md na raiz do repositório. Único mutador das especificações do projeto. Ativado quando o usuário solicita escrever uma spec, iniciar uma nova spec, destilar uma spec a partir do código existente, adicionar invariantes, alterar seções (§G, §C, §I, §V, §T, §B) ou registrar um bug via backpropagation. Frases comuns: "escreva a spec para...", "nova spec", "bug: ...", "altere §V.3", "destile spec do código", "spec esta ideia". Lê e segue FORMAT.md para as regras de codificação simplificada (caveman encoding) e a estrutura de tabela de pipe das seções §T e §B.

Individual skills in this repo

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

juliusbrussee/backprop

Bug → spec protocol. When a bug is found or a test fails, trace the cause, decide whether a new §V invariant would catch recurrence, append to §B. This is the one non-obvious thing SDD does that plan-then-execute doesn't. Triggers on test failure, bug report, post-mortem, or explicit user ask.

juliusbrussee/build

Plan-then-execute implementation against SPEC.md. Native single-thread loop, no sub-agents. On test or build failure, auto-invokes the backprop skill before retrying — a failed verification always considers whether a new §V invariant would prevent recurrence. Triggers when the user asks to build, implement, execute the spec, or tackle a specific §T task (`build §T.3`, `build --next`, `implement next task`, `run the build`). Expects SPEC.md to exist; if not, defers to the spec skill.

juliusbrussee/caveman

Caveman encoding for SPEC.md and spec-adjacent writes. Loaded by /spec, /build, /check. Cuts tokens ~75% vs prose while staying precise. Triggers on any write to SPEC.md or when user says "caveman", "compress this", "be brief".

juliusbrussee/check

Read-only drift detector. Diffs SPEC.md against current code and reports violations grouped by severity. Writes nothing — suggests remedies via the spec or build skills but never invokes them. Triggers when the user asks to check drift, audit the spec, verify invariants, or ask whether code still matches the spec. Phrasings: "check drift", "audit the spec", "does the code still match §V", "check invariants", "spec vs code".

Habilidades Relacionadas