1728b6de39
- guide/workflows/gstack-workflow.md (new): Cognitive Mode Switching pattern — 6 gears table, pre-implementation strategic gate concept, /browse non-MCP native Chromium daemon architecture (~100ms/cmd), full ship cycle demo. Reference impl: gstack by Garry Tan (YC CEO). - examples/commands/plan-ceo-review.md (new): strategic product gate template with 3 modes (SCOPE EXPANSION / HOLD SCOPE / REDUCTION) - examples/commands/plan-eng-review.md (new): engineering architecture gate template with Mermaid diagrams, failure modes, test matrix - guide/workflows/README.md: add entry + 2 Quick Selection Guide rows - guide/ecosystem/third-party-tools.md: gstack in Plugin Ecosystem - machine-readable/reference.yaml: v3.34.9, 11 new gstack entries Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
223 lines
8 KiB
Markdown
223 lines
8 KiB
Markdown
---
|
|
title: "Claude Code Workflows"
|
|
description: "Step-by-step guides for common development patterns with Claude Code"
|
|
tags: [workflow, guide, reference]
|
|
---
|
|
|
|
# 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
|
|
|
|
### [Team AI Instructions](./team-ai-instructions.md)
|
|
|
|
Scale CLAUDE.md across a multi-developer, multi-tool team with profile-based module assembly.
|
|
|
|
**When to use**: Team 5+ devs, multiple AI tools (Claude Code + Cursor/Windsurf), mixed OS
|
|
|
|
### [Changelog Fragments](./changelog-fragments.md) ⭐ NEW
|
|
|
|
**Enforce per-PR documentation with a 3-layer system: CLAUDE.md rule + UserPromptSubmit hook + CI gate**
|
|
|
|
Eliminates merge conflicts on `CHANGELOG.md`, captures context at implementation time, and ensures DB migrations are never silently deployed. Includes a reusable `UserPromptSubmit` hook pattern for enforcing any mandatory workflow step.
|
|
|
|
**Key Topics**:
|
|
- CLAUDE.md workflow rule for autonomous fragment creation
|
|
- `UserPromptSubmit` hook with 3-tier priority (enforcement, discovery, contextual)
|
|
- Conditional suggestion pattern: "if PR-intent without fragment-mention"
|
|
- CI enforcement with independent migration check job
|
|
|
|
### [Cognitive Mode Switching](./gstack-workflow.md) ⭐ NEW
|
|
|
|
Switch between specialist roles across your ship cycle: strategic product gate, architecture review, paranoid code review, automated release, native browser QA, and retrospective.
|
|
|
|
**When to use**: Ship cycles where you want explicit separation between product direction, engineering rigor, review, and release — rather than one generic assistant handling all phases
|
|
|
|
---
|
|
|
|
## 🎨 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
|
|
|
|
### [OG Image Generation](./og-image-generation.md)
|
|
|
|
Generate social preview images dynamically at build time with Satori and resvg.
|
|
|
|
**When to use**: Astro projects, keeping social previews accurate without maintaining static PNGs
|
|
|
|
### [PDF Generation](./pdf-generation.md)
|
|
|
|
Generate professional PDFs using Quarto/Typst with Claude Code.
|
|
|
|
**When to use**: Reports, documentation, whitepapers, technical documents
|
|
|
|
### [Talk Preparation Pipeline](./talk-pipeline.md) ⭐ NEW
|
|
|
|
6-stage skill pipeline: raw material → structured talk → AI-generated slides via Kimi.
|
|
|
|
**When to use**: Conference talks, meetup presentations, internal tech talks — from article, transcript, or notes
|
|
|
|
### [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.
|
|
|
|
---
|
|
|
|
## Multi-Agent & Advanced
|
|
|
|
### [Agent Teams](./agent-teams.md)
|
|
|
|
Orchestrate multiple specialized agents working in parallel on complex tasks.
|
|
|
|
**When to use**: Tasks that benefit from parallelism, specialized expertise, or independent verification
|
|
|
|
### [Agent Teams Quick Start](./agent-teams-quick-start.md)
|
|
|
|
Fast-track guide to setting up your first agent team in under 30 minutes.
|
|
|
|
**When to use**: New to multi-agent patterns, want to experiment before committing to full setup
|
|
|
|
### [Dual-Instance Planning](./dual-instance-planning.md)
|
|
|
|
Run Opus for planning and Sonnet for execution in two coordinated Claude Code instances.
|
|
|
|
**When to use**: Complex features needing deep reasoning for architecture, cost-effective execution
|
|
|
|
### [Event-Driven Agents](./event-driven-agents.md)
|
|
|
|
Coordinate agents through hook events rather than direct orchestration.
|
|
|
|
**When to use**: Reactive workflows, hook-triggered automation, loosely-coupled agent pipelines
|
|
|
|
### [Plan Pipeline](./plan-pipeline.md)
|
|
|
|
Full end-to-end plan pipeline: /plan-start, /plan-validate, /plan-execute as a coherent workflow.
|
|
|
|
**When to use**: Any significant feature where planning rigor pays off before writing code
|
|
|
|
### [Task Management](./task-management.md)
|
|
|
|
Multi-session task tracking with TodoWrite, tasks API, and context persistence across sessions.
|
|
|
|
**When to use**: Long-running tasks spanning multiple sessions, team coordination, complex backlogs
|
|
|
|
---
|
|
|
|
## 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) |
|
|
| **Team AI instructions** | [Team AI Instructions](./team-ai-instructions.md) |
|
|
| **Enforce mandatory workflow steps** | [Changelog Fragments](./changelog-fragments.md) |
|
|
| **Documentation** | [PDF Generation](./pdf-generation.md) |
|
|
| **Social previews** | [OG Image Generation](./og-image-generation.md) |
|
|
| **Conference talk from raw material** | [Talk Preparation Pipeline](./talk-pipeline.md) |
|
|
| **Audio feedback** | [TTS Setup](./tts-setup.md) |
|
|
| **Multi-agent tasks** | [Agent Teams](./agent-teams.md) |
|
|
| **First agent team** | [Agent Teams Quick Start](./agent-teams-quick-start.md) |
|
|
| **Cost-optimized planning** | [Dual-Instance Planning](./dual-instance-planning.md) |
|
|
| **Hook-driven automation** | [Event-Driven Agents](./event-driven-agents.md) |
|
|
| **Full plan workflow** | [Plan Pipeline](./plan-pipeline.md) |
|
|
| **Multi-session tracking** | [Task Management](./task-management.md) |
|
|
| **Strategic gate before coding** | [Cognitive Mode Switching](./gstack-workflow.md) |
|
|
| **Non-MCP browser automation** | [Cognitive Mode Switching](./gstack-workflow.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**: March 2026
|