← ClaudeAtlas

briefs-worklisted

Use at start of any work session. Reads where you left off in CURRENT.md and executes the planned task — without relitigating decisions or declaring the task done.
naxoc/claude-briefs · ★ 2 · Data & Documents · score 63
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