Skip to content

workflows.md

Latest commit

 

History

History
305 lines (231 loc) · 7.79 KB

workflows.md

File metadata and controls

305 lines (231 loc) · 7.79 KB

Development Workflows

Master proven workflow patterns that leverage Claude Code's strengths for consistent, high-quality development.

Core Workflow Patterns

🔍 Explore-Plan-Code-Commit (Recommended)

This systematic approach ensures thorough understanding before implementation:

1. Explore Phase

"Help me understand the current authentication system. Show me how user sessions are managed and where password validation happens."
  • Ask Claude to analyze existing code
  • Understand current patterns and conventions
  • Identify dependencies and constraints

2. Plan Phase

"Based on what we learned, let's plan how to add two-factor authentication. Think through the user flow, database changes, and security considerations."
  • Design the solution approach
  • Break down complex features into steps
  • Consider edge cases and failure modes

3. Code Phase

"Let's implement step 1: add the 2FA settings to the user profile page."
  • Implement one component at a time
  • Test each piece before moving on
  • Follow established patterns

4. Commit Phase

"Let's review what we built, run tests, and commit these changes."
  • Review generated code for quality
  • Run tests and fix any issues
  • Commit with descriptive messages

🧪 Test-Driven Development with Claude

Let Claude help you write better tests and more testable code:

Write Tests First

"Write comprehensive tests for a user registration function that handles email validation, password strength checking, and duplicate email prevention."

Implement to Pass Tests

"Now implement the registration function to make these tests pass, following our established patterns."

Refactor with Confidence

"The tests are passing. Let's refactor this code for better performance while keeping all tests green."

⚡ Safe YOLO Mode

For large refactors where you want Claude to work autonomously:

Setup Safety Net

# Create a backup branch
git checkout -b backup-before-refactor
git checkout -b feature/large-refactor

Enable Autonomous Mode

"I'm going to let you work autonomously on this refactor. Please:
1. Update all components to use the new authentication context
2. Remove the old auth prop drilling
3. Update tests to match the new structure
4. Run tests after each change and fix any issues

Work through this systematically. If you encounter errors, debug and fix them before continuing."

Review and Merge

  • Review the changes with git diff
  • Test the application thoroughly
  • Merge if satisfied, or rollback if needed

Advanced Workflow Patterns

🔀 Multi-Branch Parallel Development

Use multiple Claude instances for complex features:

Setup Parallel Branches

git checkout -b feature/frontend-auth
git worktree add ../auth-backend -b feature/backend-auth

Coordinate Development

  • Claude Instance 1: Frontend authentication UI
  • Claude Instance 2: Backend authentication API
  • You: Coordinate between branches and handle integration

🔄 Iterative Context Management

For large projects, manage context strategically:

Start Focused

# Focus on specific files
"Working on user authentication. Let's look at these files:
- src/auth/AuthContext.tsx
- src/auth/useAuth.ts
- src/types/User.ts"

Expand Gradually

"Now that we understand the auth system, let's also consider:
- src/components/LoginForm.tsx
- src/api/authAPI.ts"

Reset When Needed

# Use /clear to reset context
/clear

# Summarize current state
"We just implemented 2FA authentication. Now let's work on password reset functionality."

🎯 Feature-Driven Sessions

Start fresh sessions for major features:

Session Planning

"Starting fresh for the shopping cart feature. Here's what we need to build:
- Add to cart functionality
- Cart state management  
- Checkout flow
- Payment integration

Let's start with the cart state management."

Context Transfer

"We completed the cart state management in the previous session. Now let's build the checkout flow using the patterns we established."

Workflow Best Practices

✅ Do This

Be Explicit About Scope

"Only modify the authentication logic. Don't change the user profile components or database schema."

Use Progressive Disclosure

"First, show me the overall structure. Then we'll dive into the payment processing logic."

Validate Frequently

"After each change, let's run the tests and make sure everything still works."

Maintain Clean History

"Let's commit these working changes before moving to the next feature."

❌ Avoid This

Vague Requests

❌ "Fix the bugs in this code."
✅ "The login form isn't validating email format correctly. Fix the validation logic."

Information Overload

❌ Dumping entire codebase at once
✅ Providing targeted, relevant files

Ignoring Errors

❌ Moving on when tests fail
✅ Fixing issues before proceeding

Monolithic Changes

❌ "Rebuild the entire user management system"
✅ "Let's update the user profile form first, then move to account settings"

Debugging Workflows

🔍 Systematic Debugging

When things go wrong, follow a structured approach:

1. Isolate the Problem

"The login form stopped working after our changes. Let's check:
1. Are there any console errors?
2. Is the API request being made?
3. What's the server response?"

2. Use the Scientific Method

"Let's create a minimal test case to reproduce this bug. Then we'll change one thing at a time until we find the root cause."

3. Fix and Prevent

"Now that we found the issue, let's fix it and add a test to prevent this regression."

🚨 When Claude Gets Stuck

If Claude repeatedly fails to solve a problem:

Take a Break

"Let's step back. Can you explain what you think is causing this issue? What are the top 3 most likely culprits?"

Change Approach

"The current approach isn't working. Let's try a completely different strategy for implementing this feature."

Start Fresh

# New session with focused context
"I'm starting a fresh session to debug this authentication issue. Here's the minimal context you need..."

Team Workflows

👥 Code Review with Claude

Use Claude as a second pair of eyes:

"Review this pull request for:
- Security vulnerabilities
- Performance issues
- Code style consistency
- Missing edge cases
- Potential bugs"

📝 Documentation Generation

Keep docs current with Claude's help:

"Generate updated API documentation for these endpoints based on the current implementation."

🏗️ Architecture Reviews

Get architectural feedback:

"Review this database schema design for a multi-tenant SaaS application. Look for normalization issues, performance bottlenecks, and scaling concerns."

Measuring Workflow Effectiveness

Track these metrics to optimize your workflow:

⏱️ Time Metrics

  • Time from idea to working prototype
  • Average debugging time per issue
  • Code review turnaround time

🎯 Quality Metrics

  • First-pass success rate (code works without modifications)
  • Bug density in AI-generated code
  • Test coverage of generated code

💰 Efficiency Metrics

  • Token usage per feature
  • Cost per completed story point
  • Developer satisfaction scores

Next Steps

  • Practice the Explore-Plan-Code-Commit pattern on your current project
  • Try Test-Driven Development with Claude for your next feature
  • Experiment with multi-branch parallel development for complex features
  • Learn about Multi-Agent Patterns for even more sophisticated workflows
  • Set up Automation Recipes to streamline repetitive tasks