Community코딩 & 개발github.com

juliusbrussee/spec

SPEC.md 파일을 생성, 수정 또는 버그 역전파 할 수 있는 스킬입니다. 사용자가 명세 작성을 요청하거나, 새 명세를 시작하거나, 기존 코드에서 명세를 추출하거나, 불변 조건을 추가하거나, 섹션을 수정(§G, §C, §I, §V, §T, §B)하거나, 버그를 역전파할 때 트리거됩니다.

spec란 무엇인가요?

이 스킬은 프로젝트 루트에 있는 SPEC.md 파일의 유일한 변형자(mutator)로, 사용자 요청에 따라 소프트웨어 명세를 생성, 수정 및 유지 관리합니다. 주로 'write the spec for...', 'new spec', 'bug: ...', 'amend §V.3', 'distill spec from code', 'spec this idea'와 같은 문구로 트리거됩니다. 이 스킬은 §G(목표), §C(제약 조건), §I(인터페이스), §V(검증), §T(테이블), §B(버그) 섹션을 다루며, FORMAT.md 파일에 정의된 'caveman encoding' 규칙과 §T 및 §B의 파이프 테이블 형식을 준수합니다. 개발자와 AI 에이전트 사용자에게 명세 작성을 자동화하고 코드 품질을 높이는 데 유용하며, 명세 변경 사항을 체계적으로 추적할 수 있습니다.

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

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

spec은(는) 무엇을 하나요?

프로젝트 루트에 있는 SPEC.md 파일을 생성, 수정 또는 버그 역전파(backprop)합니다. 프로젝트 명세의 유일한 변형자입니다. 사용자가 명세 작성을 요청하거나, 새 명세를 시작하거나, 기존 코드에서 명세를 추출하거나, 불변 조건을 추가하거나, 섹션(§G, §C, §I, §V, §T, §B)을 수정하거나, 버그를 역전파할 때 트리거됩니다. 일반적인 표현: "...에 대한 명세 작성", "새 명세", "버그: ...", "§V.3 수정", "코드에서 명세 추출", "이 아이디어 명세화". FORMAT.md 파일을 읽고 따라 caveman 인코딩 규칙과 §T, §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".

관련 스킬