b6ce1ef72f
- guide/workflows/rpi.md (new): Research → Plan → Implement, 3-phase pattern with explicit GO gates, slash command templates, worked example - guide/workflows/changelog-fragments.md (new): per-PR YAML fragment enforcement, 3-layer system (CLAUDE.md rule + UserPromptSubmit hook + CI gate) - examples/hooks/bash/smart-suggest.sh (new): UserPromptSubmit behavioral coach, 3-tier priority (enforcement/discovery/contextual), ROI logging - guide/core/known-issues.md: LLM Day-to-Day Performance Variance section, 4 root causes (probabilistic inference, MoE routing, infra, context sensitivity) - guide/workflows/README.md: added RPI entry + quick selection row - machine-readable/reference.yaml: added entries for changelog_fragments, smart_suggest - CHANGELOG.md: [Unreleased] entries for all 4 new items - IDEAS.md: prompt-caching MCP plugin research note (testing in progress) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> |
||
|---|---|---|
| .. | ||
| agent-teams-quick-start.md | ||
| agent-teams.md | ||
| changelog-fragments.md | ||
| design-to-code.md | ||
| dual-instance-planning.md | ||
| event-driven-agents.md | ||
| exploration-workflow.md | ||
| gstack-workflow.md | ||
| iterative-refinement.md | ||
| og-image-generation.md | ||
| pdf-generation.md | ||
| plan-driven.md | ||
| plan-pipeline.md | ||
| README.md | ||
| rpi.md | ||
| search-tools-mastery.md | ||
| skeleton-projects.md | ||
| spec-first.md | ||
| talk-pipeline.md | ||
| task-management.md | ||
| tdd-with-claude.md | ||
| team-ai-instructions.md | ||
| tts-setup.md | ||
| title | description | tags | |||
|---|---|---|---|---|---|
| Claude Code Workflows | Step-by-step guides for common development patterns with Claude Code |
|
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
Skeleton Projects ⭐ 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
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 ⭐ 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
UserPromptSubmithook with 3-tier priority (enforcement, discovery, contextual)- Conditional suggestion pattern: "if PR-intent without fragment-mention"
- CI enforcement with independent migration check job
RPI: Research → Plan → Implement ⭐ NEW
3-phase feature development with explicit validation gates between phases
Build features in three locked phases: Research feasibility first, plan the implementation second, write code third. Each phase produces a concrete artifact (RESEARCH.md → PLAN.md → code). Each gate requires an explicit GO before the next phase starts.
When to use: Features with unclear feasibility, more than a day of work, unknown technical territory, or anywhere discovering a wrong assumption late is costly
Cognitive Mode Switching ⭐ 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
Convert design mockups (Figma, wireframes) into working code.
When to use: Frontend development, UI implementation, design system work
OG Image Generation
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
Generate professional PDFs using Quarto/Typst with Claude Code.
When to use: Reports, documentation, whitepapers, technical documents
Talk Preparation Pipeline ⭐ 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
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.
Multi-Agent & Advanced
Agent Teams
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
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
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
Coordinate agents through hook events rather than direct orchestration.
When to use: Reactive workflows, hook-triggered automation, loosely-coupled agent pipelines
Plan Pipeline
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
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 + 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 |
| New project from template | Skeleton Projects |
| Team AI instructions | Team AI Instructions |
| Enforce mandatory workflow steps | Changelog Fragments |
| Unknown feasibility, multi-day feature | RPI: Research → Plan → Implement |
| Documentation | PDF Generation |
| Social previews | OG Image Generation |
| Conference talk from raw material | Talk Preparation Pipeline |
| Audio feedback | TTS Setup |
| Multi-agent tasks | Agent Teams |
| First agent team | Agent Teams Quick Start |
| Cost-optimized planning | Dual-Instance Planning |
| Hook-driven automation | Event-Driven Agents |
| Full plan workflow | Plan Pipeline |
| Multi-session tracking | Task Management |
| Strategic gate before coding | Cognitive Mode Switching |
| Non-MCP browser automation | Cognitive Mode Switching |
Contributing
New workflow ideas? Open an issue or PR in the main repository.
Workflow Template Structure:
- Title & Purpose
- When to Use
- Prerequisites
- Step-by-Step Guide
- Real-World Examples
- Common Pitfalls
- Related Workflows
Last updated: March 2026