CommunityCodierung & Entwicklunggithub.com

juliusbrussee/spec

Erstellen, Ändern oder rückpropagieren von Fehlern in die SPEC.md im Repository-Stammverzeichnis. Alleiniger Bearbeiter der Projektspezifikation.

Was ist spec?

Diese Fähigkeit ermöglicht es einem KI-Agenten, eine Projektspezifikationsdatei (SPEC.md) im Stammverzeichnis eines Repositories zu erstellen, zu ändern oder durch Rückpropagation (Backprop) von Fehlern zu aktualisieren. Sie ist der einzige autorisierte Verwalter der Spezifikation und wird aktiviert, wenn der Benutzer eine neue Spezifikation anfordert, eine aus bestehendem Code destilliert, Invarianten hinzufügt, bestimmte Abschnitte (§G, §C, §I, §V, §T, §B) ändert oder einen Fehler mittels Backpropagation dokumentiert. Typische Auslöser sind Phrasen wie "write the spec for...", "new spec", "amend §V.3", "distill spec from code" oder "bug: ...". Die Fähigkeit liest und befolgt die Formatierungsregeln aus FORMAT.md, einschließlich der Steinzeit-Codierungsregeln und der Pipe-Tabellenstruktur für die Abschnitte §T und §B. Sie unterstützt Entwickler dabei, eine konsistente, maschinenlesbare Spezifikation zu pflegen, die sowohl als Dokumentation als auch als Grundlage für automatisierte Tests und Code-Generierung dient.

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

Installed? Explore more Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht spec?

Erstellen, Ändern oder rückpropagieren von Fehlern in die SPEC.md im Repository-Stammverzeichnis. Alleiniger Bearbeiter der Projektspezifikation. Wird ausgelöst, wenn der Benutzer eine Spezifikation schreiben, eine neue Spezifikation starten, eine Spezifikation aus vorhandenem Code destillieren, Invarianten hinzufügen, Abschnitte ändern (§G, §C, §I, §V, §T, §B) oder einen Fehler via Rückpropagation aufzeichnen möchte. Übliche Formulierungen: "write the spec for...", "new spec", "bug: ...", "amend §V.3", "distill spec from code", "spec this idea". Liest und befolgt FORMAT.md für die Steinzeit-Codierungsregeln und die Pipe-Tabellenform von §T und §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".

Verwandte Skills