2fcc65e222
9 gaps filled from claudelog.com competitive analysis (313 pages): - Section 9.19: Permutation Frameworks (CLAUDE.md-driven variation testing) - Skeleton Projects workflow (guide/workflows/skeleton-projects.md) - Task Lists as Diagnostic Tool (instruction clarity mirror) - Rev the Engine + Mechanic Stacking (multi-round planning patterns) - Split-Role Sub-Agents (multi-perspective analysis) - "You Are the Main Thread" mental model (CPU scheduler analogy) - Continuous Context Update (proactive CLAUDE.md enrichment) - Smart Hook Dispatching (single entry point routing to handlers) Guide: 15,771 → 16,293 lines (+522) New workflow: skeleton-projects.md (208 lines) Reference: +17 new entries in reference.yaml Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
129 lines
3.6 KiB
Markdown
129 lines
3.6 KiB
Markdown
# Claude Code Workflows
|
|
|
|
Step-by-step guides for common development patterns with Claude Code.
|
|
|
|
---
|
|
|
|
## 🔍 Search & Discovery
|
|
|
|
### [Search Tools Mastery](./search-tools-mastery.md) ⭐ 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](./plan-driven.md)
|
|
|
|
Structure complex tasks with planning mode before execution.
|
|
|
|
**When to use**: Multi-step features, architectural changes, uncertainty about approach
|
|
|
|
### [TDD with Claude](./tdd-with-claude.md)
|
|
|
|
Test-Driven Development workflow: write tests first, implement after.
|
|
|
|
**When to use**: Critical functionality, regression prevention, API design
|
|
|
|
### [Spec-First Development](./spec-first.md)
|
|
|
|
Write specifications before code for better requirements clarity.
|
|
|
|
**When to use**: Team collaboration, complex features, documentation-first projects
|
|
|
|
### [Iterative Refinement](./iterative-refinement.md)
|
|
|
|
Improve code through multiple refinement cycles.
|
|
|
|
**When to use**: Quality improvements, performance optimization, code cleanup
|
|
|
|
### [Skeleton Projects](./skeleton-projects.md) ⭐ NEW
|
|
|
|
Use existing battle-tested repositories as scaffolding for new projects.
|
|
|
|
**When to use**: Starting new projects, standardizing team patterns, rapid prototyping from proven foundations
|
|
|
|
---
|
|
|
|
## 🎨 Design & Content
|
|
|
|
### [Design to Code](./design-to-code.md)
|
|
|
|
Convert design mockups (Figma, wireframes) into working code.
|
|
|
|
**When to use**: Frontend development, UI implementation, design system work
|
|
|
|
### [PDF Generation](./pdf-generation.md)
|
|
|
|
Generate professional PDFs using Quarto/Typst with Claude Code.
|
|
|
|
**When to use**: Reports, documentation, whitepapers, technical documents
|
|
|
|
### [TTS Setup](./tts-setup.md)
|
|
|
|
Configure Text-to-Speech for Claude Code responses (Agent Vibes integration).
|
|
|
|
**When to use**: Audio feedback, accessibility, hands-free coding
|
|
|
|
---
|
|
|
|
## 🔬 Code Exploration
|
|
|
|
### [Exploration Workflow](./exploration-workflow.md)
|
|
|
|
Systematically explore and understand unfamiliar codebases.
|
|
|
|
**When to use**: New projects, legacy code, documentation gaps
|
|
|
|
**Related**: See [Search Tools Mastery](./search-tools-mastery.md) for advanced multi-tool exploration strategies.
|
|
|
|
---
|
|
|
|
## Quick Selection Guide
|
|
|
|
| Your Situation | Recommended Workflow |
|
|
|----------------|---------------------|
|
|
| **New to codebase** | [Exploration Workflow](./exploration-workflow.md) + [Search Tools Mastery](./search-tools-mastery.md) |
|
|
| **Complex feature** | [Plan-Driven](./plan-driven.md) or [Spec-First](./spec-first.md) |
|
|
| **Need reliability** | [TDD with Claude](./tdd-with-claude.md) |
|
|
| **Large refactoring** | [Search Tools Mastery](./search-tools-mastery.md) |
|
|
| **UI implementation** | [Design to Code](./design-to-code.md) |
|
|
| **Code quality** | [Iterative Refinement](./iterative-refinement.md) |
|
|
| **New project from template** | [Skeleton Projects](./skeleton-projects.md) |
|
|
| **Documentation** | [PDF Generation](./pdf-generation.md) |
|
|
| **Audio feedback** | [TTS Setup](./tts-setup.md) |
|
|
|
|
---
|
|
|
|
## 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
|