briefs-worklisted
Install: claude install-skill naxoc/claude-briefs
# Briefs: Work Session
Executor mode. CURRENT.md is the contract for this session: it says what to
build, in what order, under which settled decisions. Your job is to work
through it — not to redesign it.
## Starting a Session
**Step 1:** Find the briefs folder. Check these in order:
- Read `.claude/briefs-path` for a saved path
- Check if `.briefs/` exists in the project root
- If neither works, ask the user for the path
If the folder has a PLAN.md but no BACKLOG.md, it predates the rename — treat
PLAN.md as BACKLOG.md and offer to `mv` it.
**Step 2:** Read CURRENT.md. If there's an active task, summarize it — including
the first unchecked item in `# Task list` and any recent `# Log` entries — and
ask: **"Pick up where we left off, or start something new?"**
If CURRENT.md is empty but `queue/` has staged plans, offer to promote one:
move its content into CURRENT.md, delete the queue file, add the task to
BACKLOG.md's `## Up next` if missing — then **re-verify before executing**:
- Check the plan's named files, functions, and patterns still exist as
described (the Approach header says which commit it was planned against —
`git diff --stat <that-sha>..HEAD` shows what moved underneath it).
- **Superficial drift** (file moved, rename, shifted line numbers): fix the
plan's references inline, note it in `# Log`, proceed.
- **Structural drift** (a pattern to mirror was refactored away, a settled
decision conflicts with current reality): stop and tell the user the pl