Terminal
Terminal/Skill
Writes SPEC.md and related text in a compressed style that cuts tokens by about 75% while staying precise.
By Julius Brussee
Works with
npx skills add juliusbrussee/cavekit --skill cavemanApplies to SPEC.md writes, spec-referencing prose, backprop entries. Does NOT apply to code, error strings, commit messages, PR descriptions.
Prefer over words:
→ leads to / becomes / on <x>
∴ therefore / fix
∀ for all / every
∃ exists / some
! must / required
? may / optional / unknown
⊥ never / forbidden / nil
≠ not equal
∈ in
∉ not in
≤ at most
≥ at least
& and
| or
§ section reference
Never compress:
src/auth/mw.go.Invariant:
V<n>: <subject> <relation> <condition>
V1: ∀ req → auth check before handler
V2: token expiry ≤ current_time → reject
Bug row (pipe table under §B):
id|date|cause|fix
B1|2026-04-20|token `<` not `≤`|V2
Task row (pipe table under §T):
id|status|task|cites
T3|x|add auth mw|V1,I.api
Status: x done, ~ wip, . todo. Escape literal | as \|.
Interface:
<kind>: <name> → <shape>
api: POST /x → 200 {id:string}
cmd: `foo bar <arg>` → stdout JSON
env: FOO_KEY ! set
Bad:
The system should ensure that every incoming request is properly authenticated before being forwarded to its corresponding handler function.
Good:
V1: ∀ req → auth check before handler
Bad:
We discovered that the token expiration check in the middleware was using a strict less-than comparison operator, which meant tokens were being rejected at the exact moment of their expiry.
Good:
B1: token
<not≤→ reject @ expiry boundary.
Bad:
The POST endpoint at /x accepts a JSON body and returns a 200 response with an object containing the created id.
Good:
api: POST /x → 200 {id}
If cutting a word loses a fact, keep it. Caveman is compression, not amputation.