CommunityProgramación y desarrollogithub.com

juliusbrussee/spec

Crea, modifica o propaga bugs hacia atrás en SPEC.md en la raíz del repositorio. Único mutador del proyecto de especificación.

¿Qué es spec?

Esta habilidad de agente AI, diseñada para plataformas como Claude Code o Cursor, permite gestionar la especificación de un proyecto (SPEC.md) en la raíz del repositorio. Su función principal es crear una nueva especificación desde cero, modificarla (añadiendo o enmendando secciones como §G, §C, §I, §V, §T, §B), destilarla a partir del código existente, o registrar bugs mediante un mecanismo de 'backprop' (retropropagación de errores). Es útil para equipos de desarrollo que necesitan mantener una especificación viva y actualizada, sincronizada con el código y los cambios del proyecto, usando un formato de 'hombre de las cavernas' (caveman encoding) y tablas de tuberías (pipe-tables). La habilidad se activa con frases como 'escribe la especificación para...', 'nueva especificación', 'error: ...', 'modifica §V.3', 'destila especificación del código', o 'especifica esta idea'. Lee y sigue las reglas de formato definidas en FORMAT.md, garantizando consistencia en la codificación y estructura de las secciones §T y §B.

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

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

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

Documentación

¿Qué hace spec?

Crea, modifica o propaga bugs hacia atrás en SPEC.md en la raíz del repositorio. Único mutador del proyecto de especificación. Se activa cuando el usuario solicita escribir una especificación, iniciar una nueva especificación, destilar una especificación a partir del código existente, agregar invariantes, modificar secciones (§G, §C, §I, §V, §T, §B) o registrar un bug mediante backprop. Frases comunes: "escribe la especificación para...", "nueva especificación", "bug: ...", "modifica §V.3", "destila especificación del código", "especifica esta idea". Lee y sigue FORMAT.md para las reglas de codificación 'caveman' y la forma de tabla de tuberías de §T y §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".

Skills relacionados