7 Workflows to Make Claude Code a Dev Cycle Partner
Master Claude Code in production with TDD-first loops, slice-based refactoring, git/PR automation, hypothesis-driven debugging, multi-repo orchestration, quality gates, and end-to-end feature workflows—turning reactive prompts into compounding systems.
TDD and Slice-Based Loops Prevent Regressions
Start every implementation with failing tests to define the spec before code exists, forcing Claude to consider interfaces, edge cases, and behavior upfront. For validatePaymentMethod(), prompt Claude to write 12 comprehensive tests in tests/services/payment.test.ts covering valid cards (Visa, Mastercard, Amex), expired cards, CVV lengths by type, and Luhn validation—run npm run test to confirm failures, then implement in src/services/payment.ts without touching tests, verify passing, and refactor for readability while keeping ≥80% branch coverage. Advance to property-based testing with fast-check for dates.ts boundaries like leap years and timezones.
Lock this in CLAUDE.md: 'Always write tests before implementation; run tests after every step; never modify tests to pass.' This builds a safety net automatically, making refactors and changes run against it.
For refactoring, map dependencies first without changes: analyze auth across src/auth/, middleware, routes, tests for graphs, direct req.user accesses, error inconsistencies, and sequence. Branch (git checkout -b refactor/auth-middleware-consolidation), baseline tests, refactor one file/slice (e.g., centralize req.user in src/routes/auth.ts via middleware), test, commit if green. Stop on failures, use git diff HEAD~1 or bisect. CLAUDE.md rule: 'Analysis first, one slice/file at a time, commit passing slices only.' Slices isolate errors; git history traces verified steps.
Automate Git, Reviews, and Enforce Quality Gates
Pipe git diff --staged to Claude for conventional commits: 'type(scope): subject under 72 chars + body explaining WHY.' Alias gcm='git diff --staged | claude -p "..."'. For PRs: git diff main...HEAD yields Markdown with summary, motivation, changes bullets, testing, risks. Pre-commit hook scans staged diffs for secrets, SQLi, XSS, .env files—respond 'LGTM' or list issues. Pre-push review checks logic, security, perf (N+1s), API breaks, errors, coverage gaps with line-specific fixes.
Quality gates before PRs: security audit diffs for creds, SQLi, XSS, IDORs, validation, CVEs. Complexity flags: cyclomatic >10, nesting >4, lines >50, params >5 with refactors. Dependency audits on package.json: maintenance, alternatives, security. Coverage in CI: analyze npm run test:coverage vs baseline, fail <70% branches or drops, output JSON {'pass': boolean}. Weekly: maintainability report on src/*.ts for trends, gaps, debt priorities.
CLAUDE.md: 'Conventional commits/PRs with motivation/testing/risks; pre-review auth/payments; no .env commits.' Automates history, reviews, debt prevention.
Hypothesis Debugging, Multi-Repo, and E2E Features
Debug systematically: hypothesize top 5 causes from error/stack (e.g., undefined userId in payment.service.ts:147), evidence per hypothesis (check files like auth.middleware.ts), reproduce in failing test before fix. Patterns: log WebSockets for leaks; rank race interleaves in order.service.ts with repros; compare perf baselines for regressions.
CLAUDE.md: 'Hypotheses first; reproduce in test; evidence over guesses; one hypothesis at a time.'
Orchestrate multi-repo: claude --add-dir ../frontend --add-dir ../api-gateway --add-dir ../shared-types with system prompt naming shared-types as truth. Contract-first: update UserProfile subscription in shared-types/src/user.ts, impact analysis, propagate frontend/API file-by-file with TS checks. Central docs-central/api-contracts.md for migrations.
Capstone E2E feature (webhook retries): resume session (--resume payments-v2), load docs/features/payments.md/architecture.md for context/risks; TDD tests/services/webhook.test.ts (5xx retries, backoff 1s/2s/4s/8s, max 5 to DLQ, no 4xx); implement src/services/webhook.service.ts using baseQueue.ts; gates (security/complexity/full tests); update docs; PR automation. Rename sessions ( /rename feat-webhook-retry) for continuity.
Compounds Sections 1-4: CLAUDE.md/living docs/TDD/refactoring/git/quality/E2E make good habits default, not discipline.