Detailed development workflow patterns, checklists, and standards. Auto-loads for complex tasks, planning, debugging, testing, or when explicit patterns are needed. Contains session protocols, git conventions, security checklists, testing strategy, and communication standards.
Comprehensive development workflow reference. This loads on-demand for detailed patterns.
Quick links to rules: ~/.claude/rules/ for stack-specific and task-type checklists.
# 1. Sync with remote (ALWAYS FIRST)
git fetch origin main && git merge origin/main --no-edit
# or: git fetch origin master && git merge origin/master --no-edit
# 2. Get context
git log -3
# 3. Check for existing work
ls tasks/*.md 2>/dev/null || echo "No active tasks"
CRITICAL: Check <env> section for today's date. NEVER guess dates.
# 1. Verify
npm run test && npm run type-check # or project equivalent
# 2. Archive completed work
mv tasks/<completed-task>.md .archive/completed-tasks/
# 3. Commit with comprehensive message
git add .
git commit # See Git Conventions below
git push origin main
Stop dev server after testing: lsof -ti:PORT | xargs kill (or Windows equivalent)
For complex features spanning days/weeks, use GSD.
| Complexity | Use GSD? | Workflow | | -------------------------- | -------- | --------------------- | | Simple fix (<30 min) | No | Direct execution | | Single feature (30min-2hr) | No | Task file + TodoWrite | | Multi-phase feature (days) | Yes | GSD workflow | | New project/app | Yes | GSD from start |
/gsd:new-project # Initialize with brief + config
/gsd:create-roadmap # Create phases and state tracking
/gsd:plan-phase 1 # Create detailed plan for phase
/gsd:execute-plan <path> # Execute the plan
| Command | Purpose |
| ---------------------------------- | ---------------------------------- |
| /gsd:progress | Check status, route to next action |
| /gsd:resume-work | Resume from previous session |
| /gsd:pause-work | Create handoff when pausing |
| /gsd:plan-phase <n> | Create detailed phase plan |
| /gsd:execute-plan <path> | Execute a PLAN.md |
| /gsd:add-phase <desc> | Add phase to roadmap |
| /gsd:insert-phase <after> <desc> | Insert urgent work |
| /gsd:complete-milestone <ver> | Archive and tag release |
| /gsd:help | Full command reference |
.planning/
├── PROJECT.md # Vision and requirements
├── ROADMAP.md # Phase breakdown
├── STATE.md # Project memory (context accumulation)
├── config.json # Workflow mode (interactive/yolo)
└── phases/
└── 01-foundation/
├── 01-01-PLAN.md
└── 01-01-SUMMARY.md
feat | fix | refactor | perf | test | docs | chore
type: Short summary (50 chars max)
## What Changed
- File X: Added feature Y
- File Z: Updated config for A
## Why
- User requested feature Y
- Config A needed update
## Testing
- All tests passing
- Manual verification done
When a task or plan is complete, automatically commit without being asked.
# 1. Check this is a user-owned repo (not external)
git remote get-url origin | grep -q "travisjneuman" && echo "OK: User repo"
# 2. Check push is not blocked
git remote get-url --push origin | grep -q "no_push" && echo "SKIP: External repo"
| Condition | Action |
| ---------------------------- | ---------------------------- |
| User's own repo | Auto-commit + push |
| External repo (no_push) | Never commit - read-only |
| Submodule (external) | Never commit - read-only |
| Uncommitted secrets detected | Block - warn user |
textContent not innerHTMLunknown type for external data| Metric | Target | | ---------------------- | --------------- | | Initial bundle | <100KB gzipped | | Page load | <1s | | Interaction latency | <100ms | | Lighthouse Performance | 95+ | | Accessibility | WCAG AA minimum |
| Type | Location | When |
| ----------- | -------------------- | --------------- |
| Unit | src/**/__tests__/ | Every function |
| Component | Same | Every component |
| Integration | tests/integration/ | Critical paths |
| E2E | tests/e2e/ | Before release |
Before committing: npm run test && npm run type-check
Use structured decision-making for complex choices:
| Decision Type | Framework |
| ---------------------- | ----------------------------- |
| Long-term implications | /consider:10-10-10 |
| Root cause analysis | /consider:5-whys |
| Prioritization | /consider:eisenhower-matrix |
| Innovation | /consider:first-principles |
| Risk identification | /consider:inversion |
| Simplification | /consider:occams-razor |
| Focus | /consider:one-thing |
| Tradeoffs | /consider:opportunity-cost |
| Optimization | /consider:pareto |
| Consequences | /consider:second-order |
Use debug-like-expert skill for systematic approach.
We build features. We use utilities.
Give high-level updates, not spam:
✅ Added authentication middleware (3 files)
✅ Updated user store with new fields
⏳ Testing login flow...
Use AskUserQuestion when:
@-embed large docs by default/clear after completing work units| Situation | Action |
| -------------------- | ----------------------------------------- |
| Context >100k tokens | Create prompt → delegate to fresh context |
| Moderate complexity | /create-prompt → /run-prompt |
| Multi-stage features | /create-meta-prompt |
| Approaching limits | /whats-next for handoff document |
npm run dev # Start dev server
npm run build # Production build
npm run test # Run tests
npm run type-check # TypeScript check
| Type | Convention | Example |
| ---------- | ---------- | --------------- |
| Components | PascalCase | UserCard.tsx |
| Hooks | use prefix | useAuth.ts |
| Utilities | camelCase | utils.ts |
| Tests | .test.ts | utils.test.ts |
~/.claude/docs/reference/checklists/ - Task-type specific checklists~/.claude/docs/reference/stacks/ - Stack-specific patterns~/.claude/docs/reference/tooling/ - Tool configuration guides~/.claude/skills/MASTER_INDEX.md - Full skills catalog~/.claude/agents/README.md - Agents directorySearch for places (restaurants, cafes, etc.) via Google Places API proxy on localhost.
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Start voice calls via the OpenClaw voice-call plugin.
Notion API for creating and managing pages, databases, and blocks.
Gemini CLI for one-shot Q&A, summaries, and generation.
Category:developer