Skip to content

Instantly share code, notes, and snippets.

@bogdanscarwash
Created May 12, 2025 23:29
Show Gist options
  • Save bogdanscarwash/6d6344c8e72fd82b0c6b20725cc7e70f to your computer and use it in GitHub Desktop.
Save bogdanscarwash/6d6344c8e72fd82b0c6b20725cc7e70f to your computer and use it in GitHub Desktop.

Claude AI Assistant Workflow Guide

This guide outlines the optimal workflow for leveraging Claude AI across your development, documentation, and problem-solving tasks.

Preparation Phase

  1. Define Context

    • Provide relevant code snippets, files, or project structure
    • Share error messages or logs when troubleshooting
    • Include any constraints (performance, memory, compatibility)
    • Mention relevant frameworks, libraries, or environments
  2. Frame Your Request

    • Be specific about the desired outcome
    • Break complex tasks into manageable subtasks
    • Include acceptance criteria for the solution
    • Specify any style, pattern, or best practices to follow

Execution Workflow

  1. Problem Analysis

    • Ask Claude to analyze the situation first
    • Request explanations of complex issues before solutions
    • Have Claude identify potential approaches
    • Discuss tradeoffs between different solutions
  2. Implementation

    • Start with high-level approaches
    • Request incremental code solutions
    • Ask for explanations of critical sections
    • Test implementations against edge cases
  3. Refinement

    • Request optimization for specific concerns
    • Ask for alternative approaches
    • Have Claude help with debugging issues
    • Request simplification of complex solutions
  4. Documentation

    • Ask for documentation in markdown format
    • Request examples demonstrating usage
    • Have Claude explain design decisions
    • Generate comments for complex algorithms

Best Practices

  • Be Specific: The more details you provide, the better Claude can assist
  • Iterative Process: Build on previous messages for complex tasks
  • Request Explanations: Ask "why" to understand Claude's reasoning
  • Provide Feedback: Tell Claude what works or doesn't work
  • Review Output: Always verify generated code before implementation
  • Save Discussions: Keep solutions for future reference or training

Common Tasks

  • Code Generation: "Write a function that..."
  • Debugging: "Help me fix this error..."
  • Refactoring: "Improve this code by..."
  • Learning: "Explain how this algorithm works..."
  • Documentation: "Create documentation for..."
  • Testing: "Generate test cases for..."
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment