Preface
What This Course Is
What This Course Is Not
Who This Course Is For
The Philosophical Thread
An Invitation
How to Use This Course
Three Paths Through This Course
The Tech Lead Path
The Practitioner Path
The Impatient Path
What’s Between the Chapters
A Quick Guide to the Furniture
One More Thing
1. The Pattern of Panic
The Feeling You Recognise
Exercise 1
The Oldest Story in Technology
Exercise 2
The Amplifier Thesis
Exercise 3
What This Means for You
Quiz 1
3 attempts allowed
2. Two Kinds of Intelligence
What You Are Actually Talking To
Exercise 4
The Asymmetry
Where AI is superhuman
Where AI is brittle
Simulation versus participation
Exercise 5
Your Reference Frame Is the Whole Point
The map and the territory
Exercise 6
The Impoverished View and the Real Discipline
Exercise 7
What This Means For You, Starting Now
Exercise 8
Quiz 2
3 attempts allowed
3. The Six Levels
The Aware
Exercise 9
The Prompter
Exercise 10
The Verifier
Exercise 11
The Habitat Engineer
Exercise 12
The Specification Architect
Exercise 13
The Sovereign Engineer
Exercise 14
The Unified View — Cognitive and Operational
Exercise 15
The Key Insight
Exercise 16
Quiz 3
3 attempts allowed
Interlude: The Tango
4. The Three Disciplines
Context Engineering
Exercise 17
Architectural Constraints
Exercise 18
Guardrail Design
Exercise 19
The Interplay
Exercise 20
Quiz 4
3 attempts allowed
5. The Collaboration Space
What a Collaboration Space Is
Exercise 21
How Individual Levels Combine
Exercise 22
The Two-Tier Model
Exercise 23
The Risk of Separation
Exercise 24
What Leaders Can Actually Do
Exercise 25
The Assessment Question
Exercise 26
A Deeper Pattern
Exercise 27
Quiz 5
3 attempts allowed
Interlude: The Confidence of the Djinn
The Confidence Problem
Exercise 28
The Vulnerability You Didn’t Know You Had
Exercise 29
The Inversion
Exercise 30
The Practice
Exercise 31
The Djinn Is Still Worth Having
Exercise 32
Quiz 6
3 attempts allowed
6. Reference Frames and the Amplifier
What Intelligence Means When There Are Two Kinds
Exercise 33
Your Reference Frame Is the Irreplaceable Ingredient
Exercise 34
The Answer to “Will AI Replace Me?”
Exercise 35
From Thesis to Practice
Quiz 7
3 attempts allowed
7. Meet Your AI
The Underwhelm Problem
What Claude Code Actually Is
Setting Up
Your First Real Interaction
Exercise 36
What Just Happened
Exercise 37
The Shift
Exercise 38
The Courage of the First Step
Quiz 8
3 attempts allowed
8. The Art of Intent
Three Prompts Walk Into a Codebase
Exercise 39
The Gap Between What You Said and What You Meant
Exercise 40
The Producer’s Mindset
Exercise 41
Patterns That Work (and Why)
Chain of Thought: Making the AI Show Its Work
Few-Shot: Teaching by Example
Role-Based: Setting the Lens
The Meta-Pattern: Constrain Without Constricting
Exercise 42
Anti-Patterns That Seem Smart
The Vague Delegation
The Kitchen Sink
The Contradictory Persona
The Implicit Standard
The Infinite Context
Exercise 43
The Pre-Prompt Pause
Exercise 44
The Untranslatable Residue
Exercise 45
What You Now Know
Exercise 46
Quiz 9
3 attempts allowed
9. The Slop Detector
The Function That Looked Perfect
Exercise 47
What Slop Looks Like
Subtle bugs
Security holes
Architectural drift
Cargo-culted patterns
Unnecessary complexity that looks sophisticated
Exercise 48
The Spot-the-Bug Challenge
Exercise 49
The Trust Protocol
Step 1: Classify the risk
Step 2: Ask the five questions
Step 3: Predict before you run
Step 4: Track your confidence
Exercise 50
When to Trust and When to Verify
Exercise 51
The Five Dimensions of Slop
Exercise 52
The 41% Tax
Exercise 53
The Instinct Behind the Protocol
Exercise 54
What You Are Actually Detecting
Exercise 55
Quiz 10
3 attempts allowed
Field Note: The Busy Factory
The Invisible Assembly Line
The Metaphor That Won’t Die
Exercise 56
What You Can’t See Will Hurt You
Exercise 57
The Factory Floor You Actually Need
Exercise 58
The Itch
Quiz 11
3 attempts allowed
10. Testing as Thinking
The Counterintuitive Truth
Exercise 59
Tests as Specification
The Three-Layer Verification Model
Exercise 60
The Feedback Loop
The Inner Loop Has a Cost
Exercise 61
The TDD Exercise
Exercise 62
The Green Dashboard Problem
Exercise 63
What to Never Delegate
A Cognitive Discipline Underneath
Exercise 64
The Perception-Reality Gap
Exercise 65
Where You Sit on the Testing Ladder
Exercise 66
The Lingering Question
Exercise 67
Quiz 12
3 attempts allowed
11. The Living Harness
The Flip
What a Harness Is
Exercise 68
Surfacing What You Already Know
Exercise 69
CLAUDE.md: Your Project’s Constitution
Exercise 70
HARNESS.md: The Architectural Constraints
Exercise 71
The Boundary Map: Constraints on Authority
Exercise 72
Hooks: Automated Enforcement
Exercise 73
How Do You Know the Harness Is Working?
Exercise 74
Four Layers of Harness Observability
Exercise 75
Where You Sit on the Observability Ladder
Exercise 76
The Governance Audit Cycle
Exercise 77
Why All Three Components Matter
Exercise 78
Building Your First Harness
Exercise 79
The Harness Improves Through Failure
Where Does the Learning Land?
Exercise 80
The Plugin Reveal
The Cost of Context
Exercise 81
What You Have Now
Exercise 82
Quiz 13
3 attempts allowed
12. Architecture as Guardrails
The Same Prompt, Twice
Exercise 83
The Constraint Paradox
Exercise 84
Literate Programming as Constraint
Rule 1: Every file opens with a narrative preamble
Rule 2: Documentation explains reasoning, not signatures
Rule 3: Order of presentation follows logical understanding
Rule 4: Each file has one clearly stated concern
Rule 5: Comments explain WHY, not WHAT
Exercise 85
CUPID as Review Lens
C, Composable: plays well with others
U, Unix philosophy: does one thing well
P, Predictable: does what you expect
I, Idiomatic: feels natural
D, Domain-based: speaks the domain’s language
Exercise 86
The Before/After
Exercise 87
When Constraints Become Cages
Exercise 88
The Negative Space
Exercise 89
Putting It Together
Exercise 90
The Architecture Is the Collaboration
Exercise 91
Quiz 14
3 attempts allowed
13. The Parallel Workflow
One at a Time Is a Habit, Not a Law
Why Parallelism Matters
Exercise 92
Git Worktrees: Your Isolation Mechanism
Exercise 93
Dispatching Tasks
Exercise 94
Your First Parallel Run
Exercise 95
The Reviewer Stance
Exercise 96
The Anti-Patterns
Exercise 97
The Orchestrator Pattern
Exercise 98
What the Merge Teaches You
Exercise 99
Scaling the Pattern
Exercise 100
What Changes Permanently
Exercise 101
From Dispatching to Authoring
Why a fresh harness beats one tired context
Six patterns you will compose
Elect deliberately
The workflow proposes; you dispose
Exercise 102
Where You Sit on the Composition Ladder
Exercise 103
Quiz 15
3 attempts allowed
Field Note: Riding the Wave
Exercise 104
Quiz 16
3 attempts allowed
The Twentieth Watt
Exercise 105
What Changes at Each Level
Exercise 106
The Thinking Move: The Depletion Check
Exercise 107
Things to Avoid
Exercise 108
From Principle to Plugin
Exercise 109
Quiz 17
3 attempts allowed
14. The Communication Bottleneck
The Telephone Game at Machine Speed
Why Natural Language Fails at Scale
The Vibe-Coding Trap
Fourteen Features, Zero Specifications
The Invisible Decisions
Exercise 110
Specification by Example
Exercise 111
The Anatomy of a Good Spec
Given, When, Then
Three Patterns for Three Shapes
Exercise 112
The Spec Exercise
Exercise 113
When the Spec Is Wrong
The Spec That Was Too Perfect
Specs as Conversation Records
The Specification That Survived
The Feedback Loop
Exercise 114
The Deeper Truth
Exercise 115
Quiz 18
3 attempts allowed
Interlude: The Coherent Banquet
Exercise 116
Quiz 19
3 attempts allowed
15. Design-First Collaboration
The Convergence
Exercise 117
Brainstorming with AI
Exercise 118
Slicing the Work
Exercise 119
From Slice to Spec
Exercise 120
From Spec to Plan
Exercise 121
The Test-First Turn
Exercise 122
Implementation: The AI’s Heaviest Lift
Exercise 123
The Review
Exercise 124
The Full Cycle
Exercise 125
When to Break the Pipeline
Exercise 126
The Compound Effect
Exercise 127
The Three Gates
Exercise 128
The Roles, Made Explicit
Exercise 129
The Living Pipeline
Exercise 130
Quiz 20
3 attempts allowed
Interlude: The Governance of Meaning
Exercise 131
Quiz 21
3 attempts allowed
16. The Cognitive Substrate
The Question Most Engineers Don’t Ask
Exercise 132
Three Principles
The Decision Hierarchy
The Sovereignty Test
Data Gravity
Exercise 133
The Decision Framework
Exercise 134
Techniques on a Spectrum
Exercise 135
Hosting Options
Exercise 136
The Hybrid Architecture
Exercise 137
Lifecycle and Maintenance
Exercise 138
Sovereignty Maturity Across the Levels
Exercise 139
The Other Substrate
Exercise 140
Why This Comes Before Sovereignty
Exercise 141
What You Have Now
Quiz 22
3 attempts allowed
17. The Answerable Engineer
The Handover
Exercise 142
Two Kinds of Handover
Exercise 143
What Answering Actually Requires
Exercise 144
The Answerable Position
One: The Comprehension Band
Two: Real Selection
Three: Involvement
Four: Recovery Capacity
Anything Less Is Attendance
Who Holds It
Exercise 145
Why the Position Decays
Exercise 146
Class Before Handoff
The Limit You Cannot Design Away
The Gap, and What It Is Not
Exercise 147
The Sound of a Sink
The Sound Itself
Exercise 148
Presence, Measured and Bought
Exercise 149
What the Agents Owe You
Exercise 150
Across the Levels
Exercise 151
The Third Leg
Exercise 152
What You Have Now
Exercise 153
Quiz 23
3 attempts allowed
18. The Sovereign Engineer
Look at Where You Are
The Platform Builder
Exercise 154
The Teacher
Exercise 155
Sovereignty at Scale
Multi-Repo Orchestration
Governance Audit Cycles
Exercise 156
Where You Sit on the Governance Ladder
Portfolio-Level Literacy Assessment
Exercise 157
Maintaining Understanding
The Answerable Position
Exercise 158
The Enchiridion
Exercise 159
Your First Entry
The Journey Continues
Quiz 24
3 attempts allowed
Appendix A: The AI Coding Tool Capability Matrix
How to Read This Matrix
The Matrix
Level 0: The Aware
Level 1: The Prompter
Level 2: The Verifier
Level 3: The Habitat Engineer
Level 4: The Specification Architect
Level 5: The Sovereign Engineer
Summary View
Exercise 160
What This Matrix Does Not Tell You
Exercise 161
Quiz 25
3 attempts allowed
Appendix B: Cost Discipline in Practice
The Model Routing Strategy
Exercise 162
Token Economics
Exercise 163
Real Cost Examples
Exercise 164
The Decision Framework
Exercise 165
When to Spend More
Exercise 166
The Quarterly Cost Capture
Exercise 167
Estimating Before You Spend
Exercise 168
Beneath the Invoice: The Cache and the Attention Budget
Exercise 169
The Sovereignty Dimension
Exercise 170
Quiz 26
3 attempts allowed
Appendix C: The ALCI Assessment
What the ALCI Measures
Exercise 171
The Assessment Process
Self-Assessment (Start Here)
Team Assessment
Exercise 172
Part D: Operational Axes
Composition
Testing
Observability
Governance
Part D Output
Exercise 173
The Scoring Rubric
Exercise 174
Interpreting Your Results
The Perception-Reality Gap
The Habitat Build Gap
Worked example: a positive gap
Worked example: a negative gap
Exercise 175
Governance as Meaning-Alignment
Exercise 176
What to Do Next
Exercise 177
Running It Quarterly
Exercise 178
Quiz 27
3 attempts allowed
Appendix D: The ai-literacy-superpowers Quick Reference
Level 1: The Prompter
Level 2: The Verifier
Level 3: The Habitat Engineer
Level 4: The Specification Architect
Exercise 179
Level 5: The Sovereign Engineer
Operational
Agents you will see invoked
The Sentinels: Agents That Guard the Human
Exercise 180
A note on freshness
Quiz 28
3 attempts allowed
Appendix E: Commands, Skills, and Agents — Choosing the Right Abstraction
The Three Abstractions
Exercise 181
The Three Decision Axes
Exercise 182
Worked Example One: Three Shapes of the Same Need
Exercise 183
Worked Example Two: Where Should cupid-code-review Live?
Exercise 184
How This Plays Out in Claude Code
Exercise 185
A Named Sub-Category: The Sentinel
Exercise 186
Three Mistakes I Keep Seeing
Exercise 187
A Final Note on Names
Quiz 29
3 attempts allowed
Appendix F: The Cognitive Debt Workbook
What cognitive debt is
Exercise 188
The detection battery
Test 1: The explain-this-module test
Test 2: The departed-engineer test
Test 3: The slop scale, generalised
Test 4: The reflection-log test
Test 5: The constraint-defence test
Test 6: The spec-to-code trace test
Exercise 189
What it looks like in the wild
Exercise 190
The remediation playbook
Stage 1: Detect and triage
Stage 2: Externalise what still lives
Stage 3: Anchor with characterisation tests
Stage 4: Install the prevention disciplines
Stage 5: Re-grounding cadence
Exercise 191
What this workbook cannot do
Exercise 192
Quiz 30
3 attempts allowed
Glossary
Exercise 193
Quiz 31
3 attempts allowed
Recommended Reading
On Software Craft
On Systems Thinking
On Learning and Cognition
On Consciousness and Embodied Cognition
On Architecture and Habitability
On AI and Its Implications
On Accountability and Automation
On Philosophy and Practice
Index
The Sovereign Engineer (The Course)
AI Literacy for Software Professionals
AI is an amplifier. It magnifies whatever engineering discipline — or lack of it — already exists, which means the bottleneck was never AI's capability; it is the collaboration space you design around it.
This course is a six-level progression from early AI panic to sovereign engineering: the discipline of designing the environment in which human and artificial intelligence produce work worth keeping. It moves past prompting into the practices that compound — verification, habitat engineering, specification-first development, and the platform discipline that scales the practice across teams.
The habitat is yours to design. Let's build it well.
Minimum price
$129
$179
You pay
Author earns
About
About the Course
From Panic to Partnership — A Practical Framework for Human-AI Collaboration
You have installed the plugins. You have subscribed to the newsletters. You have read the threads, watched the demos, run the prompt engineering courses, and tried, with varying degrees of success, to integrate AI into your daily work.
And yet something is wrong.
The fast teams have got faster, and the broken teams have got more broken — at scale, at speed, with confidence. Senior engineers are quietly losing trust in code they did not write and cannot fully audit. Reviews are getting shorter while pull requests are getting longer. Tests pass that should not pass. Architecture drifts in directions nobody chose. The 2025 DORA report named what many of us already suspected: AI is an amplifier. It magnifies whatever engineering discipline — or lack of it — already exists.
This course is about what to do about that.
The Thesis
The quality of your AI-assisted work depends almost entirely on the quality of the collaboration space you design. Not on the model. Not on the temperature setting. Not on whether you say "please" in your prompts. On the creative, collective habitat in which human and artificial intelligence meet.
Most of the literature on AI for engineers stops at prompting. Prompting is one micro-skill at one level, and if you stay there, you are leaving most of the value on the table. The real leverage comes from designing the environment where collaboration happens: the documents that encode your team's accumulated wisdom, the architectural constraints that give AI the context it cannot intuit, the verification loops that catch drift before it compounds, the specifications that define intent precisely enough for a different kind of intelligence to act on.
This is not prompt engineering. It is habitat engineering — and it is the discipline that separates the engineers who thrive over the next decade from the ones who drown in their own AI-generated code.
What This Course Is
A professional development framework for human-AI collaboration, structured as a progression from awareness to sovereignty across six levels of literacy:
- Level 0 — Understand the landscape: what AI actually is, what it is not, and what kind of intelligence you are about to work with.
- Level 1 — Communicate effectively through prompts and structured context.
- Level 2 — Develop verification discipline: detect when AI output has drifted from reality.
- Level 3 — Design habitats: persistent, evolving collaboration environments that make good AI output the default rather than the exception.
- Level 4 — Work through specifications: formal, lossless encodings of intent that survive multiple implementations.
- Level 5 — Operate at the level of systems: orchestrate multiple AI agents within organisational structures you have deliberately designed.
Each level represents a qualitative shift in how you think about the collaboration, not just a quantitative improvement in your tool use.
The course is structured in two acts. Act I — The Thesis lays out the intellectual framework: the amplifier thesis, the two kinds of intelligence, the six levels, the three disciplines, the collaboration space itself as an engineering artefact. A tech lead can read Act I alone and walk away with a complete strategic picture. Act II — The Practice is a hands-on journey through the levels using working tools: building a slop detector, writing a living harness, designing architectural guardrails, running parallel agent workflows, authoring executable specifications, choosing your cognitive substrate deliberately, and ultimately scaling the practice across teams and portfolios.
Interludes and field notes provide breathing room between the dense chapters. Exercises throughout demand that you stop and try the thing rather than nod along.
What This Course Is Not
It is not a tool manual. Tools change quarterly. The disciplines in this framework have a longer shelf life because they are grounded in how intelligence — both human and artificial — actually works. Specific tools appear where they illustrate a concept; if you want a step-by-step guide to configuring your IDE plugin, this is the wrong course.
It is not an anti-AI polemic. I am not here to warn you about the dangers of artificial intelligence or to argue that real programmers do not use AI. That position is as useful as arguing that real navigators do not use charts.
It is not a prediction. Nobody knows what AI will be capable of in five years, and anyone who claims otherwise is selling something. What I can tell you is that the disciplines of designing good collaboration spaces, making implicit knowledge explicit, enforcing structural boundaries, and building feedback loops that catch drift are valuable regardless of what the next model can do. They were valuable before AI. They will be valuable after whatever comes next.
It does not promise a 10x productivity boost. It might, in specific contexts, for specific tasks, if you have designed the collaboration well. Or it might make you slightly faster at things that were not your bottleneck while introducing failure modes you have never encountered before. The honest answer depends on how seriously you take the design of the collaboration.
Who It Is For
Individual contributors who want to get seriously good at AI collaboration. Not "I can get Copilot to write a function" good. Seriously good. The kind of good where you design a working environment that makes your AI collaborator consistently produce output worth keeping, where you can assess the quality of generated code with the same rigour you bring to a human colleague's pull request, and where you understand the cognitive asymmetry between your intelligence and the AI's well enough to leverage it deliberately.
Tech leads and engineering managers who need to assess and grow their team's AI collaboration capability. You have team members at wildly different comfort levels — some enthusiastic but undisciplined, some sceptical but potentially brilliant collaborators given a framework that respects their craft. You need a shared vocabulary, a progression model, and concrete practices you can introduce without it feeling like a mandate from management. The course includes calibrated assessment instruments at each level, designed to give you a picture of where your team actually is, not where they think they are or where you hope they are.
Platform engineers and architects thinking beyond personal productivity to organisational capability. The final act covers multi-repo orchestration, governance audit cycles, portfolio-level literacy assessment, and the platform-builder discipline that makes good AI collaboration a property of the system rather than the individual.
The Philosophical Spine
There is a philosophical thread running through this course that I should be upfront about, because it will surface in places you might not expect.
The Stoic tradition — particularly Epictetus — provides the ethical backbone. The core insight is ancient and urgently relevant: distinguish what is in your control from what is not. You do not control the existence of AI, its pace of development, or whether your organisation adopts it. You do control the quality of the collaboration space you design, the rigour of your verification practices, and the clarity of your professional judgment.
Richard Gabriel's concept of habitability, borrowed from Christopher Alexander's architecture, supplies the design backbone. Gabriel asked a question most software methodologies ignored: is this code a good place to live? Not "is it correct?", but can the people who must understand it, change it, and grow it over years do so with comfort and confidence? This course extends that question into the AI era. If code is a habitat for programmers, then the entire development environment — code, configuration, documentation, conventions, specifications, agents, and the feedback loops that bind them — is a habitat for the combined intelligence of humans and AI working together. The inhabitants have changed. The design question has deepened. The principle remains.
The closing chapter borrows from Marcus Aurelius and Epictetus a final practice: the enchiridion — a personal handbook of hard-won principles, written for yourself, revised against reality, passed forward. By the time you finish the course, you will have started writing yours.
What You Will Walk Away With
A vocabulary precise enough to discuss AI collaboration with colleagues without arguing past each other. A six-level progression model you can locate yourself and your team on. Concrete practices for verification, harness engineering, specification-first development, parallel agent orchestration, and cost discipline. An assessment instrument calibrated against the framework. A philosophical posture that treats AI neither as saviour nor as threat, but as a powerful collaborator whose value depends entirely on the quality of the collaboration you design.
And — if you do the exercises rather than skim them — the beginning of a sovereign practice that survives whichever model is fashionable next quarter.
An Invitation
The engineers who thrive in the next decade will not be the ones who use the most AI or the least AI. They will be the ones who understand both kinds of intelligence well enough to design spaces where each contributes what it does best. They will be sovereign over their craft — not because they rejected AI, and not because they surrendered to it, but because they learned to be the architect of the collaboration rather than a passive consumer of its outputs.
That is what this course teaches. It is a progression. It requires practice. Some of it will be uncomfortable.
But the habitat is yours to design. Let's build it well.
Instructor
About the Instructor
Russ Miles is on a mission, as an Author, Listener, Speaker and Developer to help people thrive in one of the harshest, and potentially impactful, working environments: software system engineering with AI. He's doing this through Habitat Thinking, Theory and Engineering.
As an expert in Platform, Agentic, Chaos & Resilience, and Software Engineering, Russ helps people navigate the complicated and complex to succeed in software through his talks, workshops, consultancy, books, mentorship, open source contributions, his Software Enchiridion blog and his daily work.
Episode 334
An Interview with Russ Miles
Material
Course Material
The Leanpub 60 Day 100% Happiness Guarantee
Within 60 days of purchase you can get a 100% refund on any Leanpub purchase, in two clicks.
See full terms...
Earn $8 on a $10 Purchase, and $16 on a $20 Purchase
We pay 80% royalties on purchases of $7.99 or more, and 80% royalties minus a 50 cent flat fee on purchases between $0.99 and $7.98. You earn $8 on a $10 sale, and $16 on a $20 sale. So, if we sell 5000 non-refunded copies of your book for $20, you'll earn $80,000.
(Yes, some authors have already earned much more than that on Leanpub.)
Learn more about writing on Leanpub
Free Updates. DRM Free.
If you buy a Leanpub book, you get free updates for as long as the author updates the book! Many authors use Leanpub to publish their books in-progress, while they are writing them. All readers get free updates, regardless of when they bought the book or how much they paid (including free).
Most Leanpub books are available in PDF (for computers) and EPUB (for phones, tablets and Kindle). The formats that a book includes are shown at the top right corner of this page.
Finally, Leanpub books don't have any DRM copy-protection nonsense, so you can easily read them on any supported device.
Learn more about Leanpub's ebook formats and where to read them
Write and Publish on Leanpub
You can use Leanpub to easily write, publish and sell in-progress and completed ebooks and online courses!
Leanpub is a powerful platform for serious authors, combining a simple, elegant writing and publishing workflow with a store focused on selling in-progress ebooks.
Leanpub is a magical typewriter for authors: just write in plain text, and to publish your ebook, just click a button. (Or, if you are producing your ebook your own way, you can even upload your own PDF and/or EPUB files and then publish with one click!) It really is that easy.