juliusbrussee/spec

Crée, modifie ou rétropropage des bogues dans SPEC.md à la racine du dépôt. Unique mutateur de la spécification du projet.

Qu'est-ce que spec ?

Cette compétence permet à un agent IA de créer, modifier ou rétropropage des bogues dans le fichier SPEC.md situé à la racine du dépôt. Elle est le seul mutateur autorisé de la spécification du projet. Elle se déclenche lorsque l'utilisateur demande de rédiger une spécification, d'en démarrer une nouvelle, de distiller une spécification à partir du code existant, d'ajouter des invariants, de modifier des sections (\u00a7G, \u00a7C, \u00a7I, \u00a7V, \u00a7T, \u00a7B), ou d'enregistrer un bogue via rétropropagation. Les formulations courantes incluent : « rédige la spécification pour... », « nouvelle spécification », « bogue : ... », « modifie \u00a7V.3 », « distille la spécification à partir du code », « spécifie cette idée ». La compétence lit et suit le fichier FORMAT.md pour respecter les règles d'encodage rudimentaires et la forme des tableaux à pipe pour les sections \u00a7T et \u00a7B.

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

Installed? Explore more Développement et programmation skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait spec ?

Crée, modifie ou rétropropage des bogues dans SPEC.md à la racine du dépôt. Unique mutateur de la spécification du projet. Se déclenche lorsque l'utilisateur demande de rédiger une spécification, d'en démarrer une nouvelle, de distiller une spécification à partir du code existant, d'ajouter des invariants, de modifier des sections (§G, §C, §I, §V, §T, §B), ou d'enregistrer un bogue via rétropropagation. Formulations courantes : "rédige la spécification pour...", "nouvelle spécification", "bogue : ...", "modifie §V.3", "distille la spécification à partir du code", "spécifie cette idée". Lit et suit FORMAT.md pour les règles d'encodage rudimentaires et la forme des tableaux à pipe de §T et §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 associés