Lesson 32 of 2116
Agents vs. Autocomplete — the Mental Model Shift
Autocomplete is a suggestion. An agent is an actor. The mental model you bring to each is different, and conflating them is the number-one reason teams trip over AI coding.
Lesson map
What this lesson covers
Learning path
The main moves in order
- 1Two Different Machines
- 2autocomplete
- 3agent
- 4autonomy
Concept cluster
Terms to connect while reading
Section 1
Two Different Machines
Autocomplete suggests. Agents act. That single distinction changes everything about how you review, how you test, and how much can go wrong in a bad session. Confusing them is how teams end up with hallucinated commits on main.
The spectrum of autonomy
Compare the options
| Level | Example | Human involvement |
|---|---|---|
| L0: Autocomplete | Copilot ghost text | Accept or reject every line |
| L1: Inline chat | Cursor Cmd+K | Review generated block before apply |
| L2: Scoped agent | Cursor Agent Mode on a file | Review diff across files |
| L3: Autonomous agent | Claude Code on a repo | Approve plans and commands, review commits |
| L4: Background agent | codex cloud, Copilot coding agent | Review finished PR |
The review tax
Every step up the autonomy ladder reduces the time you spend writing and increases the time you spend reviewing. At L4, you are a code reviewer full-time. That's not worse, it's different — but plan your calendar around it.
Failure modes by level
- L0 failures are small and local — one wrong suggestion, easy to dismiss
- L1 failures can silently edit a function in ways you miss
- L2 failures ripple across files — imports break, types drift
- L3 failures include confidently destructive commands (`rm -rf`, bad git operations)
- L4 failures are whole PRs that look right but break in production
The handoff pattern
A healthy workflow moves up and down the autonomy dial within one task. Plan with the agent (L3). Generate scaffolding (L2). Review details with inline chat (L1). Finish with autocomplete (L0). Then commit.
A single feature, four autonomy levels, one consistent engineer in the loop.
Task: add a rate limiter to the auth API.
L3 (agent): "Plan a rate-limit layer for POST /auth/login.
List files to change and risks."
L2 (agent): Accept the plan, let it create the middleware file.
L1 (inline): Select the middleware function, Cmd+K
"Add Redis as the backing store."
L0 (ghost): Type implementation details, accept ghost text for boilerplate.
Review, run tests, commit.When to choose which
- Unfamiliar code: start with L3 planning and L2 exploration
- Greenfield feature: L2 scaffold, L1 refinement
- Tight bug fix: L1 is usually enough
- Mechanical chore: L4 background agent if you trust your tests
“The autonomy you grant should match the autonomy your safety net can catch.”
Key terms in this lesson
The big idea: agent vs. autocomplete is not a feature comparison, it's a contract with your future self. Higher autonomy means faster work and higher review cost. Pick the level that matches your test coverage and deploy the right guardrails for it.
End-of-lesson quiz
Check what stuck
15 questions · Score saves to your progress.
Tutor
Curious about “Agents vs. Autocomplete — the Mental Model Shift”?
Ask anything about this lesson. I’ll answer using just what you’re reading — short, friendly, grounded.
Progress saved locally in this browser. Sign in to sync across devices.
Related lessons
Keep going
Creators · 60 min
Capstone — Python CLI That Summarizes With Claude
Tie it all together. A command-line tool that reads a file, calls Claude, and prints a summary. Real code, real errors, real polish.
Creators · 50 min
The Landscape: Copilot vs. Cursor vs. Windsurf vs. Claude Code
The AI coding tool market fragmented fast. Let's map the 2026 landscape honestly: who is for autocomplete, who is for agents, who wins on cost, and what the tradeoffs actually feel like.
Creators · 50 min
Long-Context Code Understanding — The 1M-Token Era
Frontier models now read a million tokens of your codebase in one shot. That changes how we architect prompts, retrieval, and the cost curve of agentic work.
