claude-code-ultimate-guide/guide/workflows
Florian BRUNIAUX 821c900ba0 docs: add task management workflow and update guides
- Add guide/workflows/task-management.md (comprehensive workflow)
- Update ultimate-guide.md with task management sections
- Add task management quick reference to cheatsheet
- Update machine-readable/reference.yaml with new content
- Update .gitignore for docs/ directory

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-26 14:02:54 +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 docs: add AI productivity research, trust calibration, and exploration workflow 2026-01-19 19:16:33 +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: add task management workflow and update guides 2026-01-26 14:02:54 +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