Skip to content

How to Use This Guide

You have three AI coding tools to learn, hundreds of pages of documentation to navigate, and a sprint deadline next Thursday. You do not have time to read everything front-to-back. You need to find the techniques that will help you right now, and build deeper expertise as you go.

This article is your navigation map. It tells you exactly where to start, what to read next, and what to skip (for now) based on your specific situation.

  • A personalized reading order based on your role, experience, and tool choice
  • Time estimates for each learning path so you can plan accordingly
  • A reference map of the guide’s structure so you can find what you need later
  • Clear guidance on which sections matter most for your daily workflow

Answer these three questions to find your path:

Already chose a tool? Jump directly to its section:

Not sure which tool? Read the Tool Comparison section first, or try the Quick Wins article which shows all three tools in action.

Using multiple tools? Start with one, get comfortable, then expand. Read the Shared Workflows section which covers techniques that work across all three tools.

For developers who need to be productive by end of day.

  1. Read Quick Wins for techniques you can use in the next 30 minutes (30 min)
  2. Complete the Quick Start for your chosen tool: Cursor, Claude Code, or Codex (2 hours)
  3. Pick a real task from your backlog and tackle it using the PRD-to-implementation workflow (1-2 hours)
  4. Bookmark the Command Reference and Keyboard Shortcuts for daily reference

Path 2: The Comprehensive Learner (1 Week)

Section titled “Path 2: The Comprehensive Learner (1 Week)”

For developers who want to build deep competence with one or more tools.

Day 1-2: Foundations

  • Read the full Introduction section (this page plus the three companion articles)
  • Complete the Quick Start for your primary tool
  • Apply Quick Wins techniques to a real project
  • Set up your context file (CLAUDE.md, .cursorrules, or AGENTS.md)

Day 3-4: Core Workflows

  • Work through 5-7 Lessons for your chosen tool
  • Practice on your actual codebase, not toy examples
  • Read 2-3 Shared Workflow articles relevant to your daily work (debugging, testing, refactoring)

Day 5-6: Advanced and Extended

  • Explore Advanced Techniques for your tool
  • Set up 2-3 MCP integrations relevant to your stack
  • Install useful skills from the skills ecosystem
  • Read Cookbook recipes for your primary framework

Day 7: Optimization

  • Review Productivity Patterns for workflow optimization
  • Create custom rules or slash commands for your recurring tasks
  • Read Cost Optimization to manage your spending
  • If using multiple tools, start the Quick Start for your second tool

For tech leads rolling out AI tools across their team.

Week 1: Personal mastery

  • Complete the Sprint Starter path on Day 1
  • Spend Days 2-5 working through Lessons and building real features
  • By end of week, you should have shipped 2-3 features using AI tools

Week 2: Team enablement

  • Read Enterprise Development for team-wide patterns
  • Create a team-specific context file that encodes your project’s conventions
  • Set up shared MCP configurations and custom commands
  • Run a pilot with 2-3 early adopters on the team
  • Measure before/after metrics (task completion time, PR size, test coverage)
  • Prepare a short internal demo showing real wins from your project

Here is a map of the entire guide so you can find what you need:

The strategic overview. Why these tools matter, how they work, and how to navigate this guide.

  • Quick Start: Installation, setup, first feature
  • Lessons: 20+ real-world scenarios (new features, debugging, refactoring, testing)
  • Advanced Techniques: Agent modes deep dive, custom rules, MCP servers, checkpoints, background agents
  • Productivity Patterns: Workflow optimization, prompt engineering, efficiency hacks
  • Tips and Tricks: Configuration tweaks, large codebase handling, team collaboration
  • Shared Workflows: Techniques that work across all three tools (debugging, testing, refactoring, deployment, MCP ecosystem, enterprise development)
  • Cookbook: Framework-specific and language-specific recipes (React, Next.js, Node.js, Python, PHP, Elixir, databases, DevOps)
  • Comparison: Feature matrix, cost analysis, migration guides between tools
  • Appendices: Command reference, keyboard shortcuts, migration checklists

Every workflow article in this guide follows a consistent structure:

  1. Problem Hook — A real scenario you will recognize from your own work
  2. What You Will Walk Away With — Concrete outcomes, not abstract goals
  3. The Workflow — Step-by-step instructions with real prompts and tool interactions
  4. Copy-Paste Prompts — Ready-to-use prompts highlighted in tip blocks
  5. When This Breaks — Failure modes and recovery strategies
  6. What is Next — Links to related articles

You do not need to read articles in order. Each one is self-contained. Jump to whatever is most relevant to your current task and follow the “What is Next” links to explore related topics.

As you work through the guide, you will discover prompts and workflows that are particularly effective for your projects. Capture these in your context file:

Add effective prompts to .cursorrules in your project root:

## Proven Prompts for This Project
### Feature Implementation
When implementing new API endpoints, always:
- Follow the pattern in src/routes/users.ts
- Include input validation with Zod
- Write integration tests in tests/api/
### Debugging
When debugging, start by checking:
- Recent changes in git log
- Error patterns in the logging service
- Related test failures

Common mistakes when using this guide:

  • Trying to learn everything at once. Pick one tool, get productive, then expand. Do not bounce between all three sections simultaneously.
  • Reading without doing. Every article includes prompts you should try on your real project. Reading alone will not build the muscle memory.
  • Skipping the context file setup. The single highest-impact thing you can do is set up a good CLAUDE.md / .cursorrules / AGENTS.md. Without it, every other technique works worse.
  • Ignoring the “When This Breaks” sections. These are where the real expertise lives. Anyone can follow the happy path. Knowing what to do when things go wrong is what separates productive users from frustrated ones.

You have the map. Now it is time to start capturing value. The Quick Wins article gives you techniques that work in the next 30 minutes, no matter which tool you chose.