Developer roadmap 2026
From idea to production
31 steps, 454 checks, one path. For any language or framework. AI agents help along the way, but never skip the checks.
Follow the path from top to bottom. Click a yellow step or any topic under it to open its checklist. Progress is saved in this browser. Want deeper, per-technology roadmaps? roadmap.sh is the classic, and inspired this one.
Separate roadmap · for vibecoders
Building with AI coding agents?
Prompting, context files, AGENTS.md and CLAUDE.md, testing and security for Codex, Claude Code, Copilot and Cursor. 15 levels, 65 downloadable Markdown templates and 17 copyable prompts.
Decide what to build, and how, before writing code.
Know the problem, who has it, and what done looks like before a single line of code.
Check what exists before you build it. The best code is code you didn't have to write.
Set the shape of the system before asking an agent to generate it. Start simple and grow on evidence.
A deliberate visual system, so the product looks designed, not generated.
Make the next action obvious and every action answer back.
Build it in from the first component. A final audit finds problems too late and too expensive to fix.
Write code that people and agents can maintain.
Readable, typed, boring code. Clarity is what lets people and agents change it safely later.
Ship less JavaScript, render on the server where it helps, and keep the main thread free.
Agents can read, edit and run your repository. You stay responsible for every line they write.
The definition of done for every agent task. Far more useful than telling an AI not to look vibe-coded.
A predictable contract that's documented, validated and safe to retry.
Optimize the query before you scale the database, and cache with a clear invalidation plan.
Pick a gateway or a merchant of record, then let verified webhooks drive every order.
Plan for other languages early. Retrofitting i18n touches every string in the app.
Design security in. Never bolt it on at the end.
Anchor on OWASP Top 10:2025 for awareness and OWASP ASVS when you need a verifiable standard.
Treat coding agents and MCP servers as privileged automation, not magical employees.
Every dependency, action and credential is part of your attack surface.
Collect less, keep it for less time, and let people take their data with them.
Prove it works, is fast, and can be found.
Test where failure hurts most first, then check it in real browsers and devices.
Automate the checks so nothing, and no agent, can skip them.
Fast and measurable. Optimize Core Web Vitals with data from real users.
Make every page crawlable, understandable and worth ranking.
Generative engine optimization: make your content easy for AI systems to understand, retrieve and cite.
Release safely, with a way back.
One-command setup, automated pipelines, and environments that match production.
Know how to roll back before you roll out.
Production is never a black box.
See what's slow, failing, expensive and unused, from production evidence.
Watch spend like a metric, and scale only the part that's actually the bottleneck.
For AI products: evaluate outputs like you test code, so a model update can't silently break production.
Decide what happens when everything breaks, before it does.
Keep it healthy, and let others help.
A project people can install, understand and contribute to in minutes.
A project isn't finished when it's deployed. Keep a weekly and monthly rhythm.
Two loops to remember
AI speeds up the loop. You own it.
The AI-first loop
Agents can help at every step, but every change goes through you and the same gates.
- YouDefine the problem
- YouDefine the design
- YouGive the AI context
- AIAI implements
- YouYou review the diff(wrong? fix or retry)
- GateTests
- GateSecurity
- GatePerformance
- ShipDeploy and monitor
- ShipLearn, then iterate
The optimization loop
Don't optimize what you haven't measured. Works for speed, queries, cloud bills and tokens.
- 1. Measure
- 2. Identify
- 3. Profile
- 4. Change
- 5. Test
- 6. Measure again
- Better? Keep itWorse? Revert
Levels
Grow one level at a time
Pick your level and the path highlights the steps that matter for it.
Final production checklist
Before you say “ship it”
Product
Architecture
Code
AI
Security
Testing
Accessibility
Performance
SEO and GEO
Privacy
Deployment
Observability
Open source
Maintenance
Tips and tricks
Small habits, big difference
- 1Use git bisect to find the commit that caused a regression.
- 2Profile before optimizing. Measure before and after.
- 3Ship risky changes behind feature flags.
- 4Keep pull requests small; make one architectural change at a time.
- 5Prefer boring technology for boring problems.
- 6Automate anything you do twice.
- 7Read error messages completely before asking an AI.
- 8Give AI the error, the relevant code and the expected behavior.
- 9Ask an agent for a plan before any large change.
- 10Never paste production secrets into an AI model.
- 11Record important decisions as ADRs.
- 12Use staging before production, and have a rollback plan before deploying.
- 13Treat dependencies as part of your attack surface.
- 14Treat AI agents as privileged automation, not magical employees.
- 15Delete code when it's no longer needed.
- 16Make setup one command: clone, install, run.
If an AI agent makes a change, you should be able to explain what changed, why, what could break, and how it was tested.