Feature Development Workflow
Complete workflow for developing features professionally: branch → plan → implement → verify → PR.
Usage
code
/feature <description of feature or fix>
Phase 1 — PLAN
- •
Create feature branch from
main:- •
feat/<name>for new features - •
fix/<name>for bug fixes - •
refactor/<name>for refactoring - •
chore/<name>for tooling, deps, config
- •
- •
Explore codebase to understand affected areas:
- •Read relevant source files
- •Identify all files that need changes
- •Check for existing patterns to follow
- •
Write implementation plan:
- •Files to create/modify
- •Dependencies or migrations needed
- •Risks or edge cases
- •Testing approach
- •
Get user approval before writing any code.
Phase 2 — IMPLEMENT
- •
Write code following
CLAUDE.mdpatterns:- •Use existing conventions (TanStack Query, Supabase client, etc.)
- •Follow TypeScript strict mode
- •Maintain accessibility standards (44px touch targets, ARIA, focus-visible)
- •Use
typeimports for type-only imports
- •
Write tests (when test infrastructure exists):
- •Unit tests for lib functions
- •Component tests for complex UI logic
Phase 3 — VERIFY
Run all quality checks in order — stop and fix if any fail:
bash
npx prettier --check "src/**/*.{ts,tsx}" "*.{js,json}"
npx eslint src/
npx tsc --noEmit
npx vite build
When test infrastructure exists, also run:
bash
npx vitest run
Phase 4 — SHIP
- •
Update documentation (only what changed):
- •
CLAUDE.md— if architecture, patterns, or rules changed - •
README.md— if user-facing features changed - •
AUDIT.md— if bugs were found/fixed - •
ENGINEERING-PLAN.md— if roadmap items were completed
- •
- •
Bump SW cache version in
public/sw.jsifsrc/orpublic/changed. - •
Commit with conventional commit format:
- •
feat: <description>— new feature - •
fix: <description>— bug fix - •
refactor: <description>— code restructuring - •
chore: <description>— tooling, deps, config - •
docs: <description>— documentation only - •
test: <description>— tests only - •End with
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- •
- •
Push and create PR:
bashgit push -u origin <branch-name> gh pr create --title "<conventional title>" --body "..."
PR body must include:
- •
## Summary— 1-3 bullet points - •
## Test plan— verification checklist
- •
- •
Show PR URL to user.