Tier 3 Chapter 12 25 min read

Developer Workflows

Tier 3 Chapter 12 25 min read

Developer Workflows

Developer Workflows

“The best developers aren’t the ones who type the fastest. They’re the ones who think the clearest.”

Learning Objectives

By the end of this module, you will be able to:

  1. Compare major AI coding tools and their strengths
  2. Choose appropriate tools for different tasks
  3. Apply effective workflows with AI assistants
  4. Maintain security awareness across different tools
  5. Adapt as tools evolve

The Tool Landscape

AI coding assistants have exploded in variety. Here’s what’s available:

Categories of Tools

CategoryExamplesHow They Work
Inline AssistantsGitHub Copilot, CodeiumAutocomplete as you type
Chat InterfacesClaude.ai, ChatGPTConversational coding help
Agentic IDEsCursor, WindsurfFull IDE with agent capabilities
CLI AgentsClaude Code, AiderTerminal-based agents
API AccessClaude API, OpenAI APIBuild your own tools

Each category has tradeoffs. Let’s understand them.


Inline Assistants: Copilot & Friends

How They Work

As you type, the AI predicts what comes next:

def calculate_shipping(weight, distance):
    # AI suggests completion as you type
    base_rate = 5.00
    per_pound = 0.50
    per_mile = 0.10
    return base_rate + (weight * per_pound) + (distance * per_mile)

You press Tab to accept, or keep typing to reject.

Strengths

StrengthWhy It Matters
Low frictionSuggestions appear automatically
FastNo context switching
Good for boilerplateRepetitive patterns generated quickly
Learn as you codeSee patterns you might not know

Limitations

LimitationWhy It Matters
Limited contextOften just current file
Can’t explainJust generates, no discussion
Encourages acceptanceEasy to Tab without thinking
Subtle bugsConfident-looking wrong code

Best Practices

  1. Read before accepting: Every Tab should be deliberate
  2. Use for patterns, verify for logic: Trust structure, verify behavior
  3. Keep suggestions short: Accept line-by-line when uncertain
  4. Turn off for complex logic: Think first, then generate

Chat Interfaces: Claude.ai & ChatGPT

How They Work

You have a conversation about code:

You: How should I structure a REST API for a bookstore?
AI: [Explains architecture, provides examples, discusses tradeoffs]
You: Can you show me the models?
AI: [Provides code with explanation]

You copy relevant parts into your project.

Strengths

StrengthWhy It Matters
Deep explanationsUnderstand the “why”
Iterative refinementKeep asking until clear
Large contextCan paste substantial code
Learning-focusedGreat for understanding

Limitations

LimitationWhy It Matters
Manual integrationCopy-paste workflow
No file accessCan’t see your actual code
Context lossLong conversations drift
No executionCan’t run or test

Best Practices

  1. Provide context: Paste relevant code, explain your setup
  2. Ask for explanations: Don’t just get code, understand it
  3. Iterate: “What if…” and “How would this change if…”
  4. Use for learning: Best for concepts, not bulk generation

Agentic IDEs: Cursor & Windsurf

How They Work

A full IDE with AI deeply integrated:

  • AI can see your entire codebase
  • AI can make multi-file changes
  • AI can run commands (with permission)
  • Inline + chat + agent modes combined

Strengths

StrengthWhy It Matters
Full codebase contextAI understands your project
Multi-file changesRefactoring across files
Integrated experienceNo context switching
Agent capabilitiesCan execute plans

Limitations

LimitationWhy It Matters
Learning curveMore complex than basic tools
CostPremium features cost money
Vendor lock-inWorkflows tied to specific tool
Security surfaceMore capabilities = more risk

Best Practices

  1. Start with chat mode: Discuss before delegating
  2. Review diffs carefully: Multi-file changes need attention
  3. Use agent mode sparingly: For well-defined tasks
  4. Understand what’s indexed: Know what AI can see

Cursor-Specific Tips

@file src/models/user.py    # Reference specific file
@codebase                    # Search entire codebase
Cmd+K                        # Inline edit mode
Cmd+L                        # Open chat

CLI Agents: Claude Code

How They Work

Terminal-based AI that can:

  • Navigate your filesystem
  • Read and write files
  • Execute commands
  • Run tests and builds
$ claude

You: Add input validation to the registration endpoint

Claude: I'll examine the current endpoint, add validation,
        and verify with tests.

[Reads files, makes changes, runs tests]

Done. Here's what I changed: [summary]

Strengths

StrengthWhy It Matters
Deep integrationFull system access
Powerful automationComplex multi-step tasks
TransparentSee every action taken
Git-awareUnderstands your repo

Limitations

LimitationWhy It Matters
Terminal comfort requiredNot for everyone
Requires trustGiving substantial access
Can make mistakesReview everything
Resource usageAPI calls add up

Best Practices

  1. Be specific: Clear goals produce better results
  2. Watch it work: Monitor actions in real-time
  3. Use git: Easy rollback if things go wrong
  4. Start small: Build trust before big tasks

Choosing the Right Tool

Decision Framework

What kind of task is it?

├── Learning/understanding something
│   └── Chat interfaces (Claude.ai, ChatGPT)

├── Quick code completion while typing
│   └── Inline assistants (Copilot, Codeium)

├── Multi-file changes or refactoring
│   └── Agentic IDEs (Cursor) or CLI agents (Claude Code)

├── Exploring unfamiliar codebase
│   └── CLI agents or agentic IDEs with search

└── Complex, multi-step automation
    └── CLI agents (Claude Code)

Tool Combinations

Many developers use multiple tools:

CombinationUse Case
Copilot + Claude.aiQuick completions + deep explanations
Cursor + Claude CodeIDE work + terminal automation
ChatGPT + CopilotLearning + implementation

There’s no single “best” setup. Experiment and find what works.


Security Across Tools

Remember the Rule of Two from Module 10. Apply it to your tools:

Evaluating Tool Risk

ToolUntrusted InputPrivate AccessExternal Actions
CopilotLimitedCurrent fileNone
Claude.aiYour pasteWhat you shareNone
CursorCodebaseFull projectCommands (with approval)
Claude CodeCodebaseFull systemCommands (with approval)

Risk Mitigation

For inline assistants:

  • Lower risk; limited capabilities
  • Still review all suggestions

For chat interfaces:

  • Don’t paste secrets or credentials
  • Sanitize sensitive data

For agentic tools:

  • Review before approving actions
  • Use git for easy rollback
  • Don’t run on untrusted codebases blindly
  • Be cautious with network-accessing commands

Workflow Patterns

Pattern 1: Explore → Understand → Implement

1. Use chat to understand the problem
2. Use chat to discuss approaches
3. Use agent/IDE to implement chosen approach
4. Review and test

Good for: New features, unfamiliar territory

Pattern 2: Quick Implementation

1. Clear goal in mind
2. Use agent directly
3. Review changes
4. Test

Good for: Well-understood tasks, boilerplate

Pattern 3: Pair Programming

1. You write the structure
2. AI fills in details
3. You review and adjust
4. AI handles cleanup

Good for: Complex logic where you want control

Pattern 4: Learning Mode

1. Ask chat to explain concept
2. Try implementing yourself
3. Compare with AI suggestion
4. Ask about differences

Good for: Building understanding, skill development


Tool Evolution

The landscape changes fast. Principles that stay constant:

What Changes

  • Specific tools and features
  • Pricing and availability
  • Capabilities and limits
  • UI and workflows

What Stays the Same

  • Need to verify AI output
  • Security considerations
  • Value of understanding code
  • Importance of clear communication

Model Selection

Many tools let you choose which AI model powers them:

ToolModel Options
CursorClaude, GPT-4, custom
Claude CodeClaude models (Sonnet, Opus)
ChatGPTGPT-4, GPT-4o, etc.
CopilotGitHub’s models

Why it matters:

  • Different models have different strengths
  • Cost varies significantly
  • Speed vs. capability tradeoffs

Practical advice: Start with the default. Change only if you hit specific limitations.

Staying Current

  • Follow tool announcements
  • Try new features gradually
  • Share findings with your team
  • Don’t chase every new tool

Practical Exercises

Exercise 1: Tool Comparison

Pick a simple task (e.g., “Write a function to validate email addresses”).

Complete it using:

  1. An inline assistant (Copilot or similar)
  2. A chat interface (Claude.ai or ChatGPT)
  3. An agentic tool if available (Cursor, Claude Code)

Compare:

  • Speed to completion
  • Quality of result
  • Your understanding of the code
  • Ease of modification

Exercise 2: Workflow Design

For your current project, design a workflow:

  1. What tool(s) will you use for what tasks?
  2. What are the security implications?
  3. How will you verify AI output?
  4. What’s your rollback strategy?

Write it down. Revisit after a week.

Exercise 3: Security Audit

Evaluate a tool you use:

  1. What can it access? (files, network, commands)
  2. What external actions can it take?
  3. What approval mechanisms exist?
  4. Does it handle untrusted content?

Apply the Rule of Two. Is it in the danger zone?


Key Insights

ConceptPractical Rule
Tool categoriesInline, chat, agentic IDE, CLI — different strengths
Choose by taskLearning → chat; typing → inline; complex → agentic
Security scales with capabilityMore power = more caution needed
Combine toolsNo single tool does everything best
Principles persistVerification and understanding transcend tools

Connection to What’s Next

You now understand the tools. Next:

  • Module 13: The Human-AI Partnership — vibe engineering in depth
  • Module 14: Iterating with AI — patterns for complex projects

These modules focus on how you work with AI, regardless of which tool you use.


Reflection Questions

  1. What’s your current AI tool setup? After this module, would you change anything?

  2. “More power = more caution needed.” How do you balance capability with risk in your own work?

  3. As these tools evolve rapidly, what strategies help you stay effective without constantly chasing new features?


Next module: The Human-AI Partnership — vibe engineering and maintaining professional standards.