Workflow
The daily workflow for using Claude Code Setup effectively.
Overview
┌─────────────────────────────────────────────────────────┐
│ SESSION START │
│ │
│ /catchup → See what changed, what's next │
└─────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────┐
│ WORK │
│ │
│ Implement tasks from CLAUDE.md │
│ /todo → Add new todos (creates Records if complex) │
│ Monitor context: Ctx: 70% (via ccstatusline) │
└─────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────┐
│ SESSION END (when context fills up) │
│ │
│ /wrapup → Saves status to CLAUDE.md, commits │
│ /clear → Fresh start with full memory │
└─────────────────────────────────────────────────────────┘Session Start
After /clear or New Chat
/catchupClaude will:
- Read your project’s CLAUDE.md
- Check recent Git changes
- Load relevant Records
- Load coding standards for your tech stack
- Show you what’s next
First Time on a Project
/init-projectCreates the project CLAUDE.md and docs/records/ folder.
During Work
Track Important Decisions
When Claude makes a significant decision, add it to Records:
Create a Record for why we chose JWT over sessionsFor small decisions with a quick “why”:
Add to Recent Decisions: pip --user to avoid PEP 668 errorAdd New Tasks
/todo Add password reset functionalityClaude determines if it needs a Record or just a table entry.
Monitor Context
Watch the status line:
Ctx: 45% | Model: opus | Branch: mainAt ~80%, it’s time to wrap up.
Session End
Save Your Progress
/wrapupClaude will:
- Update CLAUDE.md status
- Create/sync Records
- Commit changes
Clear Context
/clearStart fresh. Next session begins with /catchup.
Why This Workflow?
| Problem | Solution |
|---|---|
| Auto-compact loses details | You control what’s saved via /wrapup |
| ”Where was I?” | /catchup shows exactly where you left off |
| Lost decisions | Records preserve reasoning |
| Inconsistent sessions | Same workflow every time |
Related
- Disable Auto-Compact - Required setup
- First Session - Detailed walkthrough