Workflows¶

On-demand workflows covering the entire software development lifecycle.

Overview¶

Workflows are structured processes for handling specific types of tasks. They're loaded on-demand when you need them.

Workflow Categories¶

All Workflows¶

How to Use Workflows¶

Invoke a workflow by referencing it:

@.claude/skills/create-prd.md

Build a user authentication system with OAuth support

The AI will:

1. Load the workflow instructions
2. Follow the structured process
3. Ask clarifying questions if needed
4. Complete the workflow steps

Workflow Decision Tree¶

graph TD
    A[New Task] --> B{Type?}

    B -->|New/Existing Project| C[initialize-project.md]
    B -->|Exploring Options| D{Multiple approaches?}
    B -->|Complex Feature| E{>10 files?}
    B -->|Debugging| F{Stuck >30 min?}
    B -->|Cross-tool Setup| G[generate-agents-md.md]
    B -->|Update Samuel| H[update-framework.md]
    B -->|Document Session| I[document-work.md]
    B -->|Autonomous Dev| P{PRD + Tasks ready?}
    B -->|New AI Skill| Q[create-skill.md]

    P -->|Yes| R[auto.md]
    P -->|No| K

    D -->|Yes| J[create-rfd.md]
    J -->|Decision Made| K[create-prd.md]
    D -->|No| K

    E -->|Yes| K
    K --> L[generate-tasks.md]
    E -->|No| M[Use FEATURE mode]

    F -->|Yes| N[troubleshooting.md]
    F -->|No| O[Continue debugging]

When NOT to Use Workflows¶

Workflows add structure but also overhead. Skip them for:

• Simple bug fixes - Use ATOMIC mode directly
• Small features - Use FEATURE mode directly
• Quick questions - Just ask
• Code review - Direct review without workflow

Workflow Outputs¶

Each workflow produces specific outputs:

Initialize Project¶

Creates:

• .claude/project.md - Tech stack documentation
• .claude/patterns.md - Coding conventions (if patterns found)
• Directory structure recommendations

Create PRD¶

Creates:

• .claude/tasks/NNNN-prd-feature-name.md - Product Requirements Document

Contains:

• Introduction/Overview
• Goals
• User Stories
• Functional Requirements
• Non-Goals
• Technical Considerations
• Guardrails Affected
• Success Metrics

Generate Tasks¶

Creates:

• .claude/tasks/tasks-NNNN-prd-feature-name.md - Task breakdown

Contains:

• Numbered task list
• Dependencies
• Verification steps
• Estimated complexity

Troubleshooting¶

Creates (optional):

• .claude/memory/YYYY-MM-DD-issue-name.md - Solution documentation

Contains:

• Problem description
• Root cause
• Solution
• Prevention steps

Generate AGENTS.md¶

Creates:

• AGENTS.md - Cross-tool compatible instructions

Document Work¶

Creates/Updates:

• .claude/patterns.md - Coding patterns discovered
• .claude/memory/YYYY-MM-DD-topic.md - Decision logs
• .claude/state.md - Current work status

Update Framework¶

Updates:

• CLAUDE.md - Latest version
• .claude/ - New guides and workflows

Chaining Workflows¶

Workflows can be chained for complex tasks:

1. @.claude/skills/create-rfd.md (optional)
   → Explore options when approach is unclear

2. @.claude/skills/create-prd.md
   → Creates PRD document (after RFD decision, if used)

3. @.claude/skills/generate-tasks.md
   → Creates task breakdown from PRD

4. Implement tasks one by one
   → Each task uses ATOMIC or FEATURE mode

5. @.claude/skills/document-work.md
   → Capture patterns and decisions from implementation

RFD → PRD Flow: When exploring options, use create-rfd first. Once a decision is made, use create-prd to plan the implementation.

Planning Workflows¶

Quality Workflows¶

Maintenance Workflows¶

Utility Workflows¶

Community Workflows¶

Autonomous Workflows¶