| name | project-brief |
| description | Create and maintain one-page project briefs (goal, success criteria, constraints, stack, status, next actions). Use when starting a new project, updating a project's status, or asked 'what's the status of X?' |
| category | productivity |
| maturity | stable |
| tags | ["project-status","brief","goals","blockers","tracking"] |
Project Brief Skill
Use when: starting a new project, updating a project's status, or when the user asks "what's the status of X?"
Create a brief for a new project
node ${PROJECT_BRIEF_HOME:-$HOME/projects/project-brief}/brief.cjs new
--project
--goal "What this project does and why"
--success "criterion 1,criterion 2,criterion 3"
--constraints "constraint 1,constraint 2"
--stack "tech1,tech2"
--status "Active"
--next "first next action,second next action"
List all projects with briefs
node ${PROJECT_BRIEF_HOME:-$HOME/projects/project-brief}/brief.cjs list
Compact status overview
node ${PROJECT_BRIEF_HOME:-$HOME/projects/project-brief}/brief.cjs status
View a project's brief
node ${PROJECT_BRIEF_HOME:-$HOME/projects/project-brief}/brief.cjs view
Update a brief
node ${PROJECT_BRIEF_HOME:-$HOME/projects/project-brief}/brief.cjs update --status "Complete"
node ${PROJECT_BRIEF_HOME:-$HOME/projects/project-brief}/brief.cjs update --add-next "New action item"
node ${PROJECT_BRIEF_HOME:-$HOME/projects/project-brief}/brief.cjs update --check "Success criterion text"
node ${PROJECT_BRIEF_HOME:-$HOME/projects/project-brief}/brief.cjs update --add-history "What changed today"
node ${PROJECT_BRIEF_HOME:-$HOME/projects/project-brief}/brief.cjs update --add-blocker "What's blocking"
node ${PROJECT_BRIEF_HOME:-$HOME/projects/project-brief}/brief.cjs update --resolve-blocker "What's blocking"
node ${PROJECT_BRIEF_HOME:-$HOME/projects/project-brief}/brief.cjs update --current-status "One-liner on current state"
Briefs live at
~/projects//BRIEF.md
When to update
- When a project's status changes
- When a blocker appears or is resolved
- When a milestone is hit
- When the user says "note that X is done"