claude-code-ultimate-guide/guide/workflows
Florian BRUNIAUX fd4550cbd3 release: v3.20.0 - Multi-Agent Code Review Automation
Integration of production-grade PR review patterns from Pat Cullen + Méthode Aristote.

New Features:
- Resource evaluation: Pat Cullen Final Review (5/5 - Critical)
- Enhanced /review-pr: +150 lines with Advanced Multi-Agent Review section
- Enhanced code-reviewer agent: +219 lines with anti-hallucination rules
- New workflow: Review Auto-Correction Loop in iterative-refinement.md
- Production example: Multi-Agent Code Review in ultimate-guide.md
- Reference updates: +3 entries (review_pr_advanced, review_anti_hallucination, review_auto_fix_loop)

Key Patterns:
- 3 specialized agents: Consistency, SOLID, Defensive Code Auditor
- Pre-flight check: git log Co-Authored-By detection
- Anti-hallucination: Grep/Glob verification before suggestions
- Severity classification: 🔴 Must Fix / 🟡 Should Fix / 🟢 Can Skip
- Convergence loop: review → fix → re-review (max 3 iterations)
- Conditional context loading: stack-agnostic decision table

Design Principles:
- Enrich existing files (no fragmentation)
- No breaking changes (review-pr.md template simple preserved)
- Complete attribution (Pat Cullen + Méthode Aristote with links)
- Audience-aware (beginner → advanced progression)

Files Modified:
- CHANGELOG.md, VERSION: bumped to 3.20.0
- docs/resource-evaluations/017-pat-cullen-final-review.md: NEW (120 lines)
- examples/commands/review-pr.md: 80 → 230 lines (+150)
- examples/agents/code-reviewer.md: 72 → 291 lines (+219)
- guide/workflows/iterative-refinement.md: 389 → 522 lines (+133)
- guide/ultimate-guide.md: +28 lines (Production Example section)
- machine-readable/reference.yaml: +3 entries
- README.md, guide/cheatsheet.md: version sync

Total: +537 insertions, 0 deletions (no breaking changes)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-30 16:07:09 +01:00
..
design-to-code.md feat(guide): add Pencil (IDE-native canvas) to Product Designer workflow 2026-01-22 10:16:20 +01:00
exploration-workflow.md docs: add AI productivity research, trust calibration, and exploration workflow 2026-01-19 19:16:33 +01:00
iterative-refinement.md release: v3.20.0 - Multi-Agent Code Review Automation 2026-01-30 16:07:09 +01:00
pdf-generation.md feat(seo): add CITATION.cff and improve AI discoverability 2026-01-17 11:21:58 +01:00
plan-driven.md docs: add task management workflow and update guides 2026-01-26 14:02:54 +01:00
README.md docs: add search tools guides and ast-grep patterns 2026-01-25 18:47:29 +01:00
search-tools-mastery.md docs: add grepai benchmark data to search tools workflow 2026-01-25 18:35:38 +01:00
spec-first.md feat(docs): add development methodologies documentation v3.5.0 2026-01-14 22:28:02 +01:00
task-management.md docs: document Tasks API field visibility limitations (Gang Rui analysis) 2026-01-27 16:16:49 +01:00
tdd-with-claude.md docs: add task management workflow and update guides 2026-01-26 14:02:54 +01:00
tts-setup.md docs: add Agent Vibes TTS integration documentation (v3.11.1) 2026-01-22 16:08:32 +01:00

Claude Code Workflows

Step-by-step guides for common development patterns with Claude Code.


🔍 Search & Discovery

Search Tools Mastery NEW

Master the art of code search by combining rg, grepai, Serena & ast-grep

Learn when to use each tool, how to combine them for maximum efficiency, and real-world workflows including:

  • Exploring unknown codebases
  • Large-scale refactoring
  • Security audits
  • Framework migrations
  • Performance optimization

Key Topics:

  • Quick decision matrix
  • Complete feature comparison
  • 5 combined workflows
  • Performance benchmarks
  • Common pitfalls
  • Tool selection cheatsheet

🎯 Development Workflows

Plan-Driven Development

Structure complex tasks with planning mode before execution.

When to use: Multi-step features, architectural changes, uncertainty about approach

TDD with Claude

Test-Driven Development workflow: write tests first, implement after.

When to use: Critical functionality, regression prevention, API design

Spec-First Development

Write specifications before code for better requirements clarity.

When to use: Team collaboration, complex features, documentation-first projects

Iterative Refinement

Improve code through multiple refinement cycles.

When to use: Quality improvements, performance optimization, code cleanup


🎨 Design & Content

Design to Code

Convert design mockups (Figma, wireframes) into working code.

When to use: Frontend development, UI implementation, design system work

PDF Generation

Generate professional PDFs using Quarto/Typst with Claude Code.

When to use: Reports, documentation, whitepapers, technical documents

TTS Setup

Configure Text-to-Speech for Claude Code responses (Agent Vibes integration).

When to use: Audio feedback, accessibility, hands-free coding


🔬 Code Exploration

Exploration Workflow

Systematically explore and understand unfamiliar codebases.

When to use: New projects, legacy code, documentation gaps

Related: See Search Tools Mastery for advanced multi-tool exploration strategies.


Quick Selection Guide

Your Situation Recommended Workflow
New to codebase Exploration Workflow + Search Tools Mastery
Complex feature Plan-Driven or Spec-First
Need reliability TDD with Claude
Large refactoring Search Tools Mastery
UI implementation Design to Code
Code quality Iterative Refinement
Documentation PDF Generation
Audio feedback TTS Setup

Contributing

New workflow ideas? Open an issue or PR in the main repository.

Workflow Template Structure:

  1. Title & Purpose
  2. When to Use
  3. Prerequisites
  4. Step-by-Step Guide
  5. Real-World Examples
  6. Common Pitfalls
  7. Related Workflows

Last updated: January 2026