briefs-setuplisted
Install: claude install-skill naxoc/claude-briefs
# Setup Claude Briefs
Creates the Briefs project management structure in the current project. Briefs
is a lightweight system for managing focus across sessions - for both humans
and LLMs.
## What This Creates
A briefs directory with four files:
- **CURRENT.md** - The heart of the system. One active task: context, planned approach, task list, session log.
- **BACKLOG.md** - The larger project plan: up next, blocked, backlog, done.
- **PROGRESS.md** - The long-term memory. Completed tasks with backstory and decisions. Written only by `/briefs-done`.
- **NOTES.md** - Technical notes, gotchas, and references that outlive any single task.
The lifecycle that maintains them: `/briefs-plan` (settle the approach) →
`/briefs-work` (execute, repeatable sessions) → user reviews and commits →
`/briefs-done` (review against plan, archive, reset). `/briefs-health` audits
when things feel muddled.
## Steps
**1. Ask where to put the briefs folder**
Ask: "Where should I create the briefs folder?"
Present two options:
- **With this project** - creates `.briefs/` in the project root. Suggest adding `.briefs/` to `.gitignore` (these are working notes, not source code).
- **Somewhere else** - user provides an absolute path. Good for people who keep notes in Obsidian, a shared docs folder, or anywhere outside the repo.
**2. Create the directory**
```bash
mkdir -p <chosen-path>
```
**3. Save the path**
Create `.claude/briefs-path` containing the absolute path to the briefs folder. This le