Interactive guide · Day 1 · Agents Series

From code to intent

For decades, programming has been an act of translation: understand the problem, design a solution, then render it in syntax — curly braces, semicolons, types. That friction is now collapsing. This guide summarizes the paper "The New SDLC With Vibe Coding" (Addy Osmani, Shubham Saboo & Sokratis Kartakis) in interactive form: quizzes, simulators and cheatsheets to help you master the transition from ad-hoc prompting to agentic engineering.

📄 Original paper: Day_1_v3.pdf ⏱ ~15 min of study 🎮 3 simulators ✅ 8-question quiz
👥 Who this guide is for
👩‍💻 Software engineers 🧭 Engineering managers 🏛 Architects 🎯 Technical leaders

The goal: understand how AI is reshaping the SDLC and adopt these capabilities without sacrificing the discipline that production software demands. It assumes familiarity with modern development practices — not with the specifics of AI or machine learning.

dev@2026: ~/product — the developer's new interface
dev@2026:~/product$ agent "build a support bot that answers questions from our docs" ▸ planning changes across 14 files… ok ▸ writing implementation, tests and evals… ok ▸ running suite in sandbox… 42/42 passed ▸ opening pull request for human review… PR #231 dev@2026:~/product$
0%
of professional devs already use coding agents regularly (early 2026)
0%
use agents every day at work
0%
of all new code is already AI-generated
01

AI Agents in 60 seconds

First, a shared vocabulary. A chatbot produces a response and waits. An agent runs its own loop: you give it a goal, and it decides the next step.

The climb: from autocomplete to autonomy

⌨️
~2021
Autocomplete
Token prediction inside the editor
🧩
~2023
Inline suggestions
Completes entire functions
💬
~2024
Chat
Describe in natural language, receive an implementation
🤖
2025→
Autonomous agents
Clone repos, plan, run in sandbox, test and open PRs

The agent loop — click each step

GOALgiven by you🎯🎯 Perceive🧠PlanAct👁️Observe🔁Iterate

🎯 Perceive

The agent reads the current state: the goal it received, the available context, the result of the last action. It's the "scan the scene" step before deciding anything. → click the other steps in the diagram.

The 5 parts of every agent

🧠
MODEL
The reasoning engine: reads the context and decides the next thought or tool call
🔧
Tools
Connect the model to the world: APIs, executable code, databases, other agents
💾
Memory
The state: past interactions, project rules, context across sessions
🎛️
🎛️ Orchestration
The code that runs the loop: assembles context, dispatches tools, decides whether to continue
🚀
Deployment
From prototype to service: hosting, identity, observability, production infrastructure
💡 Core ideaThe loop perceive → plan → act → observe → iterate is the beating heart of every agent. Everything else in this paper — and in the course — is a variation on this loop.
02

The spectrum: vibe coding → agentic engineering

In Feb 2025, Andrej Karpathy described vibe coding: "fully give in to the vibes, forget that the code even exists." The term went viral — and became a confusing umbrella. In 2026, Karpathy himself proposed agentic engineering for the disciplined end. It's not a binary: it's a spectrum. The differentiator isn't whether you use AI — it's how much structure, verification and human judgment surrounds the output.

creative chaosproduction discipline
DimensionVibe CodingStructured AI-AssistedAgentic Engineering
Intent specificationCasual natural-language promptsDetailed prompts with examples and constraintsFormal specs, architecture docs, memory files
Verification"Does it seem to work?"Manual testing, spot-checkingAutomated suites, CI/CD gates, LM judges
Codebase understandingMinimal — the dev may not even read the generated codeSelective review of critical pathsFull review of architecture; AI handles the details
Error handlingCopy the error back into the promptDev diagnoses the root cause, AI implements the fixAgents self-diagnose within bounds; humans handle the architectural
Appropriate scopePrototypes, scripts, personal projects, hackathonsFeatures within established codebasesProduction systems, team-scale development
Risk profileHigh — acceptable for disposable codeModerate — human judgment at key checkpointsLow — systematic verification at every stage
⚠️ The line that separates the two ends The biggest divider is verification. In agentic engineering, two mechanisms work together: tests verify the deterministic (this input → that output, checked by code) and evals verify the non-deterministic (did the agent take the right trajectory? choose the right tools? does the final response meet the bar? — checked by labelled datasets, rubrics and LM judges). Without both, it's vibe coding — no matter how sophisticated the prompts are.
🎯 Applied tipThe right position on the spectrum depends on the stakes. A weekend prototype → pure vibe coding. A production API handling financial transactions → agentic engineering. The skill is knowing where to draw the line for each task.
03

Context engineering: the real skill

The quality of generated code depends less on prompt cleverness and more on the quality of the context provided. The question isn't "how do I trick the AI?" — it's: "what would a new team member need to know to contribute well, and how do I encode that?"

The 6 types of context every agent needs

📜
Instructions
The agent's core role, goals and operational boundaries
📚
Knowledge
Retrieved documents, architecture diagrams, domain-specific data
💾
Memory
Short-term (what just happened) + long-term (what the project is)
🧪
Examples
Few-shot demonstrations and codebase reference patterns
🔧
Tools
Precise definitions of the APIs, scripts and services the agent can invoke
🚧
Guardrails
Hard constraints, formatting rules, safety validations

Static × Dynamic: the architecture trade-off

📌 Static context

always loaded · paid on every interaction
  • System instructions and persona
  • Rule files: AGENTS.md, CLAUDE.md, GEMINI.md
  • Global project memory

Cost: every token is present in every interaction, relevant or not. Excess dilutes the signal.

VS

⚡ Dynamic context

loaded on demand · paid only when used
  • Skills triggered by task matching
  • Tool results retrieved during execution
  • Documents via RAG, windowed session history

Efficiency: the agent pays the token cost only when the information is needed.

What is static and what is dynamic is a first-class architectural decision — reviewed and versioned like any other configuration. Too much static wastes tokens; too little and the agent forgets critical rules.

Agent Skills — the winning pattern (click the tabs)

The agent starts as a lightweight generalist. It sees only names and short descriptions of dozens of skills — without paying for the content:

skills_available:
  - deploy-agent:    "deploy ADK agents to Agent Runtime"
  - eval-runner:     "runs evalsets and reports regressions"
  - db-migration:    "safe schema migrations"
  - legacy-refactor: "legacy code refactoring"
  ... (dozens more)
token cost in context~200 tokens

You request a deploy. The agent does matching with the skill deploy-agent and loads the full instructions for that skill — and only that one:

loading skill: deploy-agent
  ✓ pre-deploy checklist (env vars, permissions)
  ✓ publishing steps to Agent Runtime
  ✓ automatic rollback rules
token cost in context~2,000 tokens

Only if the task demands it, the agent pulls the deep reference material — the full API, edge cases, error tables. Progressive disclosure: each level costs more, but is only paid for when needed.

deep reference: deploy-agent/reference.md
  ✓ full agents-cli flags catalog
  ✓ permissions matrix per environment
  ✓ deploy incident runbook
token cost in context~9,000 tokens (only now)

Skills solve 4 classic problems: context rot (overloaded prompts), the lack of procedural memory in LLMs, the overhead of multi-agent architectures, and the need for portability across tools and vendors.

04

The new software development life cycle

AI compresses the cycle unevenly: implementation that once took weeks now takes hours, while requirements, architecture and verification remain at human pace. The result is not a faster old SDLC — it's a different workflow, with phases that blur and iteration cycles of minutes.

⏳ A note on the pace of change The phase-by-phase picture in this guide reflects the state of the AI-driven SDLC as of mid-2026 — and it's shifting fast. Teams are already experimenting with workflows where developers go straight from spec to review, with agents handling implementation, testing and deployment in the background. The boundaries drawn here may look different in 12 months. What remains constant: human judgment, taste, and the skill to verify AI output as machines take on more implementation.

The compression (animated)

📋 Requirements
human pace → AI-assisted
🏛 Architecture
stubbornly human — trade-offs
⚙️ Implementation
weeks → hours ⚡
🧪 Testing & QA
continuous tests + evals
🚦 Review & Deploy
AI as first-pass review
🔧 Maintenance
legacy finally touchable

Phase by phase — explore

Phase 01 · maximum feedback compression

Requirements become a conversation

Historically, requirements was the phase with the widest gap between intent and implementation. Now AI participates directly in refinement:

  • Generates user stories from product briefs
  • Identifies edge cases that humans miss
  • Produces API schemas from natural-language descriptions
  • Generates interactive prototypes from specification documents
"Requirements stop being a document handed off between teams. They become a conversation between humans and AI that produces specification and initial implementation simultaneously."
✓ in practice
From description to working prototype in minutes — the requirements-to-prototype loop trends toward zero.
⚙ try it
Take a real brief and ask: "generate user stories + acceptance criteria + 5 edge cases I didn't consider"
Phase 02 · the most human of all

Architecture remains ours

Architectural decisions are fundamentally about trade-offs: consistency × availability, complexity × flexibility, build × buy. They depend on business context, organisational constraints and long-term strategy that AI cannot fully grasp.

  • AI excels at implementing architectural decisions once they are made
  • Given a clear architecture doc, agents scaffold entire applications with consistent patterns
  • Your role shifts from writing boilerplate to making and documenting the structural decisions
"The developer stops writing the boilerplate and starts making and documenting the structural decisions that the boilerplate implements."
✗ don't delegate
Strategic trade-offs, business constraints, long-term decisions.
✓ delegate
Scaffolding, generation of consistent patterns across modules, conformance to conventions.
Phase 03 · real gains, nuanced picture

From writing to reviewing, guiding and verifying

Modern agents generate entire features from natural-language descriptions, complex algorithms, and coherent multi-file changes.

  • Industry surveys report 25–39% productivity gains, with projections of 30–35% across the full process
  • But the METR study found that experienced developers were 19% slower on certain tasks — due to time spent verifying, debugging and correcting AI output
  • AI does not eliminate implementation work: it transforms it
"AI does not eliminate implementation work — it transforms it from writing to reviewing, guiding and verifying."
📊 both sides of the coin
+25–39% average productivity in surveys · −19% on senior dev tasks without structure (METR, Feb 2026). The difference? Verification.
Phase 04 · the quality flywheel

Tests and evals: the language of intent

Testing AI-generated code requires evaluating not just what the agent produced, but how it got there:

  • Output evaluation: the final artifact — does it compile? do the tests pass?
  • Trajectory evaluation: the full sequence of tool calls and intermediate reasoning
  • A fluent output that skipped its verification steps is a more dangerous failure than a visible error
  • Agents generate test cases — including edge cases and property-based tests — that humans wouldn't think of
"A well-written eval suite tells the AI what 'correct' means — and provides an automated way to verify it."
✓ the continuous flywheel
1. Evaluate against a benchmark → 2. Diagnose failures by clustering root causes → 3. Optimize prompts/tools → 4. Verify against a regression suite → 5. Monitor production. Each cycle compounds.
Phase 05 · AI-aware pipelines

Augmented review, vigilant deployment

AI acts as a first-pass reviewer: potential bugs, style violations, security vulnerabilities and performance issues — before a human ever sees the code.

  • It doesn't replace human review: decisions about design, maintainability and strategic alignment remain with us
  • It drastically reduces the cognitive load on reviewers
  • Agents monitor deployment health, perform automatic rollbacks, and predict risk based on the nature of the changes
"Deployment pipelines are becoming AI-aware — with feedback loops between production behaviour and development decisions."
⚙ division of labor
AI: bugs, style, security, performance.
Human: design, maintainability, strategy.
Phase 06 · the underestimated transformation

Legacy finally stops being untouchable

Legacy codebases that were impenetrable to new members can now be navigated, understood and modified with AI assistance.

  • The agent reads the codebase, understands its patterns, identifies the relevant files, and implements while respecting the existing architecture
  • Code that was "too risky to touch" can be refactored, modernized and extended safely
  • Framework migrations, updating deprecated APIs, modernizing test suites — tasks that previously simply never happened
"Maintenance is perhaps the most underestimated transformation of all."
✓ technical debt
Debt that only the original author understood becomes a viable target for systematic refactoring — the risk drops when AI can explain before changing.
05

The factory model

The mental model that ties it all together: the developer's primary output is not the code — it's the system that produces code. A factory manager doesn't assemble every widget by hand: they design the assembly line and ensure quality control.

👷

You design the system

Specifications, context, success criteria — not step-by-step instructions

🤖

Agents produce the code

They translate specs into implementation and iterate on their own within the boundaries

Tests verify the output

Quality gates and feedback loops route failures back for automatic correction

The 5 parts of your factory

📜 Specifications & context 🤖 Implementation agents 🧪 Tests & quality gates 🔁 Feedback loops (failure → agent) 🚧 Behavioral guardrails
🏭 Golden ruleSuccess comes from giving agents success criteria — not step-by-step instructions — and letting them iterate. If you're dictating every keystroke, you've become the bottleneck of your own factory.
06

Harness: what surrounds the model

It's tempting to treat the model as the system: "a new model came out, the agent got smarter." That intuition is wrong. The model is one input. Everything else — prompts, tools, context policies, hooks, sandboxes, sub-agents, observability — is the harness: the scaffolding that lets the model actually finish things.

AGENT = MODEL + Harness
a raw model is not an agent — it becomes one when the harness gives it state, execution, feedback and constraints
🧠
MODEL
reasoning engine

📜 Instructions & rule files

The text that defines who the agent is, what it cares about, and what it is forbidden from doing: AGENTS.md, CLAUDE.md, GEMINI.md, skill files and sub-agent prompts. It's the cheapest, highest-impact piece.

The harness in every SDLC phase

1 · Requirements & Architecture → Configuring the harness

Before any production code: create the AGENTS.md, define architectural constraints, choose the tools (APIs, schemas) and the unbreakable rules.

2 · Implementation → Running the harness

The model generates code and executes it inside the harness's isolated sandbox. Needs to read a file or fetch something? It uses the tools the harness provides — nothing beyond.

3 · Testing & QA → The feedback loop

Test failed? The orchestration captures the error from the sandbox and routes it back to the model, asking for another attempt. The harness creates the automatic think → act → observe loop.

4 · Review, Deployment & Maintenance → Observing the harness

Deterministic hooks block the commit with a hardcoded password. Observability tracks token cost, latency and drift — you audit why the agent decided what it decided.

outside the Top 30 → Top 5

On Terminal Bench 2.0, one team moved a coding agent up the ranking by changing only the harness — zero model change.

+13.7 points

A LangChain study on the same benchmark: tweaks only to system prompt, tools and middleware around a fixed model.

🔧 Honest diagnosisWhen an agent fails, the instinct is to blame the model. More often than not, the failure comes from a missing tool, a vague rule, an absent guardrail, or a context window full of noise. Most agent failures are configuration failures.
07

Conductor × Orchestrator: your new role

Two working modes you'll fluidly alternate between. Neither is "better" — each serves a type of task.

🎻

The Conductor

hands-on · real-time
  • You're in the IDE, watching code appear, guiding with prompts and corrections
  • Fine-grained control over every change
  • Ideal for: complex logic, hard debugging, unfamiliar codebases
  • Risk: if you dictate every keystroke, you become the bottleneck
GitHub CopilotGemini Code AssistCursorWindsurf
🎼

The Orchestrator

async · multi-agent
  • You define goals, delegate to agents and review results — without watching line by line
  • Agents work in parallel, in the background, in sandboxes
  • Ideal for: bug fixes, features against established patterns, migrations, test generation
  • Demands: specification, decomposition, evaluation and system design
Google JulesCopilot agent modeCursor backgroundClaude Code

The 80% problem — click the bar

80% — AI generates fast ⚡
the hard 20%
🟩 80%: straightforward implementation of well-specified tasks 🟥 20%: where the danger lives — and your value

What makes up the 20%:

  • Edge cases and realistic error handling
  • Integration points with other systems
  • Subtle correctness requirements
  • Wrong assumptions about business logic
  • Failure to seek clarification on ambiguous requirements
  • Architectural decisions that create invisible maintenance debt

These errors are more insidious because the code "looks right" and may even pass basic tests. The best devs use AI for what it does well and reserve their own attention for what it doesn't — they don't try to be faster by accepting everything.

08

Coding agents in practice

Three places in your day — and most devs use all three on the same day. The right starting point depends on the task, not on which category sits higher on the autonomy ladder.

In the editor

Continuous flow

Inline completions, chat that explains/modifies in place, whole-codebase awareness. Where most people first meet AI in coding.

CopilotCursorWindsurfJetBrains AI
Use when: you're mid-code and want suggestions, quick edits or explanations without leaving the flow.
In the terminal

Multi-file with execution

You give a goal in natural language; the agent traverses the codebase, runs tools and tests, and iterates on what it observes. Where serious vibe coding happens today.

Claude CodeCodex CLIGemini CLIClineAntigravity
Use when: multi-file work, exploring an unfamiliar codebase, tasks that require running code and reacting.
In the background

Delegate and review later

The agent takes the task and runs autonomously in a cloud sandbox — sometimes for hours — and delivers a pull request as output.

Google JulesCopilot agent modeCursor backgroundAlphaEvolve
Use when: the task fits in a paragraph — a known bug, a test suite, a framework migration.

And when the product is an agent?

A support bot, a research assistant, a compliance monitor — these aren't tasks for a coding agent to solve: they're products that need their own persistent memory, scoped permissions, eval coverage and observability. The same terminal workflow that produces prototype scripts now reaches these production agents — the build → evaluate → deploy → observe → refine cycle lives in one place:

agents-cli — from laptop to production without rewriting
# one-time setup — gives your coding agent 7 ADK lifecycle skills uvx google-agents-cli setup # then, in your coding agent (Claude Code, Codex, whichever you prefer): > Build a support agent that answers questions from our docs. > Evaluate it on the FAQ dataset. > Deploy it to Agent Engine. ▸ scaffolding project from template ......... ▸ ADK code written + evalset generated ............... ▸ evals running against the agent ..................... 94% passed ▸ deploying to Agent Runtime ........................... ✓ production # prefer to drive directly? the same commands exist as CLI: agents-cli create · agents-cli playground · agents-cli eval · agents-cli deploy

🔗 MCP

Model Context Protocol — the standard for tool access across agents and vendors.

🤝 A2A

Agent2Agent — the protocol for delegation between agents. Together, MCP + A2A are the connective tissue of multi-agent systems.

🦀 Real proof

In early 2026, Anthropic's agent teams built a C compiler in Rust in two weeks — humans set direction and reviewed, without writing the implementation.

09

The economics: CapEx × OpEx in the token era

The conversation usually starts and ends with "how fast can we write code?". For leaders, the critical metric is TCO — and in the AI era, OpEx is dictated by the token economy.

🎲 Vibe CodingLow CapEx · HIGH OpEx (and compounding)
CapEx ~
OpEx: token burn + maintenance + security ↗↗
Monthly subscription + casual prompts. Looks cheap — until the bill arrives: token burn rate (huge files dumped into context, expensive "fix it again" loops), maintenance tax (spaghetti code to reverse-engineer months later) and security remediation (a vulnerability in production costs exponentially more than at design time).
🏗 Agentic EngineeringHigh CapEx · LOW OpEx
CapEx: schemas, tests, structured context
OpEx: marginal cost per feature plummets ↘
Deliberate investment before the first line of production code: API schemas, deterministic test suites and, above all, structuring the context. The output comes out structurally sound, pre-tested and aligned with standards.

Context as a financial lever + intelligent routing

🧠 Large & expensive models

  • Requirements and refinement
  • Architecture decisions
  • Complex initial implementation

High-complexity tasks — where judgment outweighs costfrontier

automatic
routing

⚡ Small & cheap models

  • Test generation
  • First-pass code review
  • CI/CD monitoring

Deterministic, low-complexity tasks — paying premium prices here is wastefast/cheap

💰 The mathContext engineering is a financial strategy: passing a 100,000-token repository into every prompt is unviable at scale. A dense, high-signal payload (a precise AGENTS.md + architectural guardrails) raises the first-pass success rate — and eliminates the expensive trial-and-error loops that haunt vibe coding.
10

Conclusion: Intent as the new Interface

The transition from syntax to intent is not a future prediction — it's a present reality. Developers are already spending more time describing what they want than specifying how to build it. The SDLC is already being compressed, restructured, and reimagined around AI capabilities. The question is not whether this transformation will happen, but how effectively individual developers, teams, and organizations will navigate it.

The framework presented in this paper — the spectrum from vibe coding to agentic engineering, the conductor-to-orchestrator model of developer roles, the taxonomy of ambient, workflow, and autonomous agents, and the factory model of software production — provides a set of mental models for making sense of a rapidly evolving landscape. These models will remain useful even as the specific tools and capabilities evolve.

Three durable principles

🏗 Structure scales, vibes don't

Vibe coding is valid for exploration, prototyping, and personal projects. But for software that organizations depend on, the discipline of agentic engineering — specifications, tests, guardrails, and human oversight of architecture — is not optional. The gap between 'it seems to work' and 'it works correctly under all conditions' is where production outages, security vulnerabilities, and maintenance nightmares live.

🔊 AI amplifies your engineering culture

Organizations with strong testing practices, clear architectural standards, and healthy code review processes get dramatically more value from AI-assisted development than those without. AI is a force multiplier — and it multiplies both your strengths and your weaknesses.

🧠 The human role is evolving, not diminishing

The builders who understand architecture, can define precise specifications, evaluate output critically, and design effective systems of constraints and feedback loops are more valuable than ever. The skills that matter are shifting from implementation to judgment, from writing code to designing the systems that produce code.

We're at the beginning of a transformation that will reshape not just how software is built, but what kind of software is possible to build. Smaller teams will be able to tackle larger problems. Individual developers will be able to build and maintain systems that previously required entire departments. The barrier to creating software will continue to fall, opening the practice of software development to a broader population.

The teams that thrive will be those that embrace AI as a powerful tool while maintaining the engineering discipline that has always been the foundation of reliable software. They'll be the ones who understand that the future of software engineering isn't about choosing between human expertise and AI capability — it's about designing systems where both contribute their unique strengths.

Generation is solved. Verification, judgment, and direction are the new craft.
11

Quiz: test your understanding

8 questions covering the whole guide. No rush — each answer's explanation is part of the study.

12

Ready-to-copy cheatsheets

Three artifacts you can use today. Click copy and paste into your project.

📜AGENTS.md — 10-line starter
# AGENTS.md

## Stack
TypeScript 6.x · Next.js 16 · Postgres (Drizzle ORM) · Vitest

## Conventions
- Pure functions whenever possible; errors via Result<T, E>, never bare throw
- Names in English, comments explain "why", not "what"
- Every API handler validates input with zod before touching the database

## Hard rules (unbreakable)
- NEVER commit secrets; use env vars via .env.local
- NEVER install a dependency without confirming with me
- NEVER modify migrations already applied in production

## Workflow
1. Read docs/ before implementing  2. Write the test first
3. Run `pnpm test` until green     4. Describe the diff before committing
🧪Review checklist for AI-generated code
# REVIEWING AI-GENERATED CODE

[ ] Real imports          — does each package exist? compatible version?
                              (dependency hallucination is error #1)
[ ] Nothing "too clever"  — if it looks too clever, be suspicious;
                              code the team doesn't understand = debt
[ ] Real error handling   — covers realistic failure modes, not just
                              the happy path that passes the test
[ ] Business edge cases   — the AI doesn't know your refund rule;
                              verify business-logic assumptions
[ ] Trajectory, not just output — did the agent RUN the tests or just
                              say it did? check logs / CI hooks
[ ] Secrets and permissions — nothing hardcoded; minimal access scope
[ ] You could explain this diff — if you can't explain it, don't ship it
🗺️The paper's mind map in 12 lines
# THE NEW SDLC — MIND MAP

shift       : syntax → intent (you say WHAT, the machine the HOW)
spectrum    : vibe coding ──────── ai-assisted ──────── agentic eng.
divider     : verification (tests = deterministic · evals = non-determ.)
skill       : context engineering (6 types: instructions, knowledge,
              memory, examples, tools, guardrails)
trade-off   : static context (always paid) × dynamic (paid on demand)
key pattern: Agent Skills — lightweight generalist becomes specialist on demand
factory     : your output is the SYSTEM that produces code, not the code
harness     : AGENT = MODEL + HARNESS · agent failures ≈ config failures
roles       : conductor (real-time) ⇄ orchestrator (async, multi-agent)
80/20       : AI does 80% fast; your value is in the 20% (edge, integration, subtlety)
economics   : vibe = CapEx↓ OpEx↑↑ · agentic = CapEx↑ OpEx↓ + model routing
motto       : "Generation is solved. Verification, judgment and direction are the new craft."
13

Where to start — interactive checklists

Check the boxes as you progress. Progress is saved in your browser.

👩‍💻 Individual devs

Create a 10-line AGENTS.md: stack, conventions, hard rules, workflow. Add a rule every time the agent errs.
Install a set of skills (e.g. Agents CLI) to build, evaluate and deploy agents.
Pick one repetitive workflow and turn it into your first agent, from prototype to production.
Write tests and evals BEFORE generating the code — they are the contract with the AI.
Review every line that will ship. Be skeptical of anything that looks clever. Check for real imports.
Maintain your skills: debugging, system design, performance intuition. AI is a lever, not a substitute.

🧭 Engineering leaders

Make context engineering a first-class practice: prompts, evals and skills reviewed in PRs, versioned, with an owner.
Set the bar at the eval, not the demo — with explicit rubrics (success, tool use, trajectory, hallucination).
Re-shape code review for generated code: train reviewers on the typical failure modes.
Separate prototyping from production in team norms — a prototype that ships by accident is the symptom of a blurred boundary.
Invest in the harness as a shared asset: build once, refine many times.

🏢 Organizations

Treat AI-assisted development as an engineering investment, not a productivity feature.
Build the production substrate BEFORE scaling: evals in CI, traces, scoped permissions, security review.
Adopt open standards (MCP for tools, A2A for delegation) — preserve the option to switch vendors.
Plan for hybrid human+agent teams: review, on-call and team structure need to evolve.
Hire and develop for judgment, not just implementation — those who direct agents well are worth more than those who write the most code.
14

Pocket glossary

Vibe Coding
Describing what you want in natural language and accepting the output; when it breaks, pasting the error back into the prompt. Valid for prototypes and disposable code.
Agentic Engineering
AI as an implementation engine inside human-designed systems: constraints, tests, evals and architecture oversight.
Context Engineering
The practice of providing the agent with rich, structured information about the codebase, architecture, conventions and intent — the central skill of the new SDLC.
Harness
All the scaffolding around the model: instructions, tools, sandboxes, orchestration, hooks and observability. Agent = Model + Harness.
Eval (evaluation)
Verification of the non-deterministic: trajectory of steps, tool selection and final-response quality, via labelled datasets, rubrics and LM judges.
Agent Skills
Portable packages of procedural knowledge loaded on demand — progressive disclosure that keeps the agent a lightweight generalist.
The factory model
The dev designs the system that produces code (specs + agents + tests + feedback + guardrails) instead of producing code directly.
The 80% Problem
AI generates ~80% fast; the final 20% (edge cases, integrations, subtle correctness) demands deep contextual knowledge — and that's where human value lives.
Conductor × Orchestrator
Two working modes: real-time direction in the IDE (conductor) vs. async delegation to multiple agents with result review (orchestrator).
MCP / A2A
Model Context Protocol (tool access) and Agent2Agent (delegation between agents) — the open standards that connect multi-agent systems.
01

Structure scales, vibes don't

Vibe coding is fine for exploration. For software the organization depends on, the discipline of agentic engineering — specs, tests, guardrails, oversight — is not optional. It's in the gap between "it seems to work" and "it works correctly under all conditions" that production failures live.

02

AI amplifies your engineering culture

Teams with strong tests, clear standards and healthy review extract dramatically more value. AI is a force multiplier — and it multiplies both your strengths and your weaknesses.

03

The human role is evolving, not diminishing

Those who understand architecture, specify precisely, evaluate critically and design systems of constraint and feedback are more valuable than ever. Skills are migrating from implementation to judgment.

"Generation is solved.
Verification, judgment and direction
are the new craft."
— paper conclusion
15

Continue the journey: the companion papers

This guide is Day 1 of a series. The full series has four companions that deepen the themes introduced here — note where to go next.

16

Resources to continue

The original sources underpinning this guide, for when you want to go beyond the summary.

17

References (the paper's endnotes)

The numbered footnotes from the original paper, so you can trace each claim to its source.

1GetPanto — AI Coding Assistant Statistics 2025-2026; Index.dev — Developer Productivity Statistics with AI Tools.
2Karpathy, A. — “Vibe Coding”, X/Twitter, Feb 2025; Wikipedia — “Vibe coding”.
3Osmani, A. — “Agentic Engineering”, addyosmani.com.
4Karpathy, A. — “From Vibe Coding to Agentic Engineering”, 2026; The New Stack — “Vibe Coding is Passe”.
5Glide Blog — “What is Agentic Engineering?”; The New Stack — “Vibe Coding, Agentic Engineering”.
6CircleCI — “AI-Native SDLC”.
7GroovyWeb — “SDLC in the AI Era: Software Development 2026”; EPAM — “From Traditional Software to a Native AI SDLC”.
8Osmani, A. — “The Factory Model”, addyosmani.com.
9Deloitte — “AI in Software Engineering: Productivity Gains 2025-2026” (projecting 30-35% gains).
10METR — “Uplift Update: Measuring the Impact of AI Coding Tools”, Feb 2026.
11Google — “Introduction to Agents”, Agents Whitepaper Series, Nov 2025.
12Osmani, A. — “From Conductors to Orchestrators: The Future of Agentic Coding”, addyosmani.com.
13Google — “Jules: AI-Powered Coding Agent”, Google Developers Blog.
14Osmani, A. — “The 80% Problem in Agentic Coding”, addyo.substack.com.
15Medium, Dave Patten — “The State of AI Coding Agents 2026”.
16Lawfare — “When the Vibes Are Off: The Security Risks of AI-Generated Code”.
17Google — “Introduction to Agents”, section Multi-Agent Systems and Design Patterns, Nov 2025.
18Google — “Agent Development Kit (ADK)”; Kartakis, S. — “From Zero to Multi-Agents: A Beginner’s Guide to Google ADK”, Medium.
19Google — “Agent-to-Agent (A2A) Protocol”; Kartakis, S. & Hotz, H. — “Generative AI in the Real World: Understanding A2A”, O’Reilly Podcast.
20TLDL — “AI Coding Tools 2026”; Kanerika — “GitHub Copilot vs Claude Code vs Cursor vs Windsurf”.
21Google — “Gemini Code Assist”, Google Cloud.
22Dark Reading — “Coders Adopt AI Agents, but Security Pitfalls Lurk in 2026”.
23Google — “Gemini CLI”, GitHub.
24Google — “Agent Tools: Interoperability with Model Context Protocol (MCP)”, Agents Whitepaper Series, Nov 2025.
25Google — “Agent Quality” and “Prototype to Production”, Agents Whitepaper Series, Nov 2025.
26Lawfare — “When the Vibes Are Off: The Security Risks of AI-Generated Code”.
27DevOps.com — “AI-Generated Code Packages Can Lead to Slopsquatting Threat”.
28Osmani, A. — “Beyond Vibe Coding”, O’Reilly Media, 2025-2026.
29“Awesome LLM Apps”, GitHub.
30Osmani, A. — “My LLM Coding Workflow Going Into 2026”, addyosmani.com.
31Questera — “7 AI Coding Trends to Watch in 2026”.
32DEV Community — “Programming in the Age of AI: From Code to Intent”.