Skip to content

v0.1.0

Latest

Choose a tag to compare

@naxoc naxoc released this 05 Aug 16:28
· 1 commit to main since this release

First tagged release. Six skills for running a project through Claude Code (or any LLM I guess).
plan expensively, execute cheaply, close deliberately.

New: /briefs-groom

Walks BACKLOG.md item by item when the list has grown long enough that you skim
past it. It verifies what it can — items that shipped but were never removed,
titles their own bodies contradict, duplicates, claims about files and methods
that no longer hold — and asks about the rest rather than guessing.

The constraint it's built around: a fresh session has less context than the
backlog does. Items were written across weeks by sessions that had read the code.
Guessing "this looks stale" produces confident nonsense, so the skill verifies or
asks, and never deletes on its own judgement.

/briefs-health stays what it was — structural, not editorial. It asks "is this
system working?"
; groom asks "is this list still true?".

Backlog format: items are headings

Backlog items are now ## headings with a *tag* line, not - [ ] checkboxes.
A backlog item grows — measurements, a settled decision, a correction, the reason
something was deferred — and checkbox items fight that: continuation lines need a
hanging indent, and the whole thing renders as one bullet no matter how long it
gets. Headings fold, appear in an outline panel, and can be linked to.

Checkboxes remain correct in CURRENT.md's # Task list, where an item really is
a thing you tick within one session.

Existing briefs keep working. The skills read both formats and are told not
to convert a file they are only passing through. When you want the conversion,
/briefs-health offers it — with the traps encoded: bold titles wrap across
lines, # comments inside fenced code blocks are not headings, and # Done
entries must be checked by commit SHA rather than title before folding them away.

Also: no redundant # Backlog title (the filename says it, and a # Backlog
wrapping a ## Backlog reads as though one nests inside the other), and the same
flattening in PROGRESS.md.

# Done is a pointer, not a second list

PROGRESS.md already records completed work with dates, commits and reasoning. A
# Done list in the backlog is a hand-maintained copy of that index, and it
drifts. /briefs-done now deletes the finished item and leaves history to
PROGRESS.

Smaller changes

  • ## Up next is gone. It was in five skills but had stopped being used: it
    duplicates CURRENT.md, and a backlog is roughly ordered anyway. The top of
    # Backlog is what's next.
  • PROGRESS entries carry the test instructions — the fixtures and commands,
    copy-pasteable, with the reason each fixture was chosen and the expected result
    where there is one. They are expensive to rediscover, and CURRENT.md gets
    wiped.
  • PROGRESS entries are timestamped YYYY-MM-DD HH:MM, read from the clock
    rather than from the model's memory. A guessed time is worse than none.
  • Queued plans mark the backlog item they came from, so a plan staged in
    queue/ is visible from the list it came out of. /briefs-done clears the
    pointer on promotion.
  • README: fixed an install command that omitted a skill folder, and added an
    example of what a brief actually looks like.

Upgrading

cp -r briefs-* ~/.claude/skills/