Agentic Coding Primer

March 2026 Edition

Agentic
Coding
Field Guide

The complete orientation for developers entering the agentic era — what it is, how it works, which tools to use, and how to get running fast.

85%
Devs using AI tools regularly
22%
GitHub projects using coding agents
7mo
Task complexity doubles every 7 months
15+
Serious agentic CLI tools available
01 — What Is This

The Agentic Coding Primer

For years, AI coding tools meant autocomplete — smarter IntelliSense that could suggest the next line or block. That era is over. Agentic coding is fundamentally different: instead of suggesting, AI agents act.

An agentic coding tool understands your repository, forms a plan, executes it across multiple files, runs your tests, reads the output, fixes what broke, and opens a pull request — all from a single English sentence you wrote in a GitHub issue.

The shift in one sentence: You used to say "help me write this function." Now you say "build this feature" and go review another PR while the agent works.

In the first half of 2025, virtually every major AI provider shipped a coding agent. By early 2026, an estimated 15–22% of active GitHub projects show agent contributions — a remarkable adoption rate for a technology less than a year old at scale.

The agents that matter most today operate with tool use: they can read files, write files, execute terminal commands, run tests, search the web, and call external APIs. The underlying model reasons about which tool to use next, calling them in sequence like a developer working through a problem step by step.

02 — Vocabulary

Core Concepts

🧠
Agentic Loop
The agent's core cycle: receive goal → plan → execute a tool → observe result → update plan → repeat. This loop is what makes agents feel autonomous rather than reactive.
🔧
Tool Use
Agents call predefined functions: read_file, write_file, run_terminal, web_search, apply_edit, and more. Each call gives the model new information to reason with.
🔌
MCP (Model Context Protocol)
An open standard by Anthropic that lets agents connect to external tools portably. One MCP server works across Claude Code, Cline, Cursor, and any MCP-compatible agent.
👁️
Human-in-the-Loop
Most tools offer approval modes where agents propose changes before executing. You review the diff, approve, and the agent continues. Critical for safe deployment.
📋
Context Files (CLAUDE.md)
Markdown files in your repo that give agents persistent instructions — coding standards, preferred libraries, project goals. The agent reads these every session automatically.
🪄
Subagents / Orchestration
Complex tasks can be broken into specialists. An orchestrator assigns subtasks to focused subagents — a test agent, a doc agent, a security agent — and synthesizes results.
📦
RAG
Agents use semantic search over your codebase to pull in relevant files before reasoning. This is how they handle large repos without exhausting their context window.
🌊
Async vs Sync Agents
Async agents work in the background while you do other things. Sync agents execute in real-time with you watching every step. Most tools now support both modes.
🎯
SWE-Bench
The standard benchmark for coding agents — real GitHub issues scored by autonomous completion rate. 50%+ is frontier-grade. The number all tools race to improve.
03 — How It Works

The Agentic Development Workflow

Here's the typical flow from task to merged PR when using a modern coding agent:

01
You Describe
File a GitHub issue or write a prompt in plain English
02
Agent Reads
Explores repo structure, RAG retrieves relevant code
03
Agent Plans
Creates a multi-step plan with tool calls
04
Executes Loop
Writes code → runs tests → reads output → fixes → repeats
05
You Review
Agent opens draft PR; you review and comment
06
Iterates
Agent picks up PR comments and applies changes
07
Merge
CI passes, human approves, PR merges to main
# Project Instructions for AI Agents## Stack - Backend: FastAPI (Python 3.11+) - Frontend: Next.js 14, TypeScript, Tailwind - Tests: pytest (backend), Vitest (frontend)## Conventions - All API routes live in app/routes/ - Run `make test` before every commit - Every new feature needs a corresponding test## Do NOT - Never modify database migrations manually - Don't add new dependencies without discussion
04 — Tool Landscape

IDE & Editor Agents

Paid / Subscription Full-featured agentic IDEs & extensions
Cursor
IDE ForkMost PopularMulti-file
★ Industry Std
The current baseline for individual developers. A VS Code fork with AI natively embedded — agent mode, background agents running async, composer for large multi-file changes. Cursor is what everyone compares against.
💰 $20/mo Pro 🔗 cursor.com 🧠 Multi-model
GitHub Copilot
Agent ModeAsyncEnterprise
Now includes a full async coding agent — assign a GitHub issue to Copilot and it clones the repo, writes code, runs tests, opens a draft PR, and iterates on your review comments. Powers the new GitHub Agentic Workflows (Feb 2026).
💰 $10–$39/mo 🔗 github.com/copilot 🧠 GPT/Claude/Gemini
Windsurf
CascadeMemoryIDE Fork
Codeium's agentic IDE with Cascade — a persistent memory system that remembers your preferences, project decisions, and style guidelines across sessions. Strong for developers frustrated by agents forgetting everything.
💰 $15/mo Pro 🔗 codeium.com/windsurf 🧠 Multi-model
Cline
Open SourceMCPPlan Mode
★ 50k+ stars
The leading open-source VS Code extension for agentic coding. Plan Mode lets you review the agent's full execution plan before a single command runs. Every file change and terminal call requires your permission.
💰 Free (pay model) 🔗 github.com/cline/cline 🧠 Any model
Continue
Open SourceLocal-firstVS Code / JetBrains
The most customizable open-source assistant. Connect to 200+ models including fully local ones via Ollama. Ideal for teams wanting full model control or strong privacy requirements.
💰 Free 🔗 github.com/continuedev 🧠 200+ models
Kiro
Spec-DrivenEmerging
Generating real developer excitement around spec-driven development — write a formal spec and the agent implements against it. Early adopters praise the concept; performance consistency is still maturing.
💰 Beta 🔗 kiro.dev 🧠 Claude-backed
05 — Terminal Agents

CLI & Terminal Agents

The terminal is making a comeback. These tools let you delegate work directly from the command line — no GUI required.

Claude Code
TerminalGitHub NativeAnthropic
★ Top Pick
Anthropic's own agentic coding CLI. Lives in your terminal, understands your codebase through deep retrieval, handles git workflows, and executes tasks autonomously. Tag @claude in GitHub for async PR work. Best for complex reasoning and multi-step tasks.
💰 API usage 🔗 github.com/anthropics/claude-code 🧠 Claude
OpenAI Codex CLI
Terminalskills.mdOpenAI
Reborn as a serious agent-first CLI in 2025. Praised for follow-through on multi-step tasks. Supports a skills.md file for encoding team knowledge. Strong for teams already in the OpenAI ecosystem.
💰 API usage 🔗 github.com/openai/codex 🧠 GPT-5 Codex
Aider
Open SourceGit-nativeTerminal
★ 30k+ stars
The battle-tested terminal pair programmer. Every change is automatically committed with a meaningful message — your git log tells the whole story. Excellent for power users who want precise control and full visibility.
💰 Free (pay model) 🔗 github.com/Aider-AI/aider 🧠 Any model
Goose (by Block)
Open SourceExtensionsTerminal
Block's open-source developer agent with a rich plugin system for building custom tools for specific workflows. MCP-compatible, runs locally. Strong CLI UX and a growing enterprise community.
💰 Free 🔗 github.com/block/goose 🧠 Multi-model
Crush
Cross-platformMCP
Broadest platform support of any CLI tool: macOS, Linux, Windows, Android, FreeBSD. Supports mid-session model switching while preserving context and granular tool permissions per project.
💰 Free (pay model) 🔗 charmbracelet/crush 🧠 Any via OpenRouter
Open Interpreter
Open SourceLocal-first
Runs LLMs fully locally and lets them execute code and shell commands in a controlled environment. Exceptional for scripting, data wrangling, and reproducible automation. Your code never leaves your machine.
💰 Free 🔗 github.com/OpenInterpreter 🧠 Local models
06 — Cloud & Platform Agents

Platform-Level & Cloud Agents

GitHub Agent HQ
Multi-agentGitHub NativeFeb 2026
GitHub's unified platform for running multiple coding agents side-by-side. Run Claude, OpenAI Codex, and Copilot agents on the same issue and compare results. Mission Control dashboard tracks all running sessions.
💰 Copilot Pro+ 🔗 github.com 🧠 Claude/GPT/Gemini
GitHub Agentic Workflows
Tech PreviewNew Feb 2026
Write automation in plain Markdown instead of YAML. Drop a .md file in .github/workflows/ describing what you want — triage issues, fix CI failures, update docs — and the AI figures out execution.
💰 Copilot 🔗 GitHub Blog
OpenHands
Open Source65k+ starsSaaS
The leading open-source autonomous software agent platform. Solves 87% of bug tickets same-day. Native integrations with GitHub, GitLab, CI/CD, and Slack. Model-agnostic. Raised $18.8M in 2025.
💰 OSS / SaaS 🔗 github.com/All-Hands-AI 🧠 Any model
Devin (Cognition)
Autonomous SWEEnterprise
One of the first "autonomous software engineer" products. Now available in Agent HQ. Extended autonomous coding sessions with a full browser, terminal, and editor in a sandboxed VM. Enterprise audit trails included.
💰 Enterprise 🔗 cognition.ai
Augment Code
Codebase IndexEnterpriseSWE-Bench #1
Maintains a live semantic index of your entire codebase. Their "Auggie" agent claims first place on SWE-Bench Pro. Customers include MongoDB, Spotify, and Webflow.
💰 Enterprise 🔗 augmentcode.com 🧠 Claude + others
SWE-Agent (Princeton)
Open SourceResearch
The academic research agent that helped define the category. Takes a GitHub issue URL and autonomously attempts to fix it using your model of choice. Great for experimentation and benchmarking.
💰 Free 🔗 github.com/SWE-agent 🧠 Any model
07 — GitHub Projects & Ecosystems

Notable Open Source Projects

awesome-claude-code-subagents
100+ SubagentsClaude Code
A curated collection of 100+ specialized Claude Code subagents covering all major development domains — security auditing, test generation, architecture review, documentation, DevOps, and more.
wshobson/agents
112 Agents72 Plugins
112 specialized agents, 16 multi-agent workflow orchestrators, 146 agent skills, and 79 development tools — organized into 72 focused, installable plugins for Claude Code.
kyrolabs/awesome-agents
Curated ListAll Frameworks
The go-to curated list of AI agent tools, frameworks, and projects. Covers everything from CrewAI and LangGraph to domain-specific agents for vision, voice, DevOps, and security.
CrewAI
FrameworkMulti-agentOpen Source
Orchestrate role-playing, autonomous AI agent teams. Define agents with personas, goals, and tools — then set them loose as a crew. Popular for pipelines where specialists collaborate.
Mastra
TypeScriptFrameworkOpen Source
An opinionated TypeScript framework for building AI applications quickly. Great for Node/TS teams who want product-grade AI features — workflows, memory, tool use — without reinventing the wheel.
Tabby
Open SourceSelf-hosted
The best open-source, self-hosted autocomplete server for teams. Deploy on your own infrastructure, connect VS Code or JetBrains — no vendor caps, no data leaving your network.
08 — Quick Reference

Tool Comparison Matrix

ToolAsync AgentLocal ModelsMCPGit-nativeOpen SourceBest For
Claude CodeComplex reasoning, multi-step tasks
Cursor~Daily development, fast flow
GitHub Copilot~GitHub-native, enterprise
ClineControl + transparency, any model
AiderTerminal-first, clean git history
OpenHandsAutonomous cloud agents, OSS enterprise
Windsurf~Persistent memory across sessions
ContinuePrivacy, local-first, customization
SWE-Agent~Research, benchmarking

✓ = full  ·  ~ = partial/planned  ·  ✗ = not supported (March 2026)

09 — Getting Started

How to Get Started

Three paths depending on your setup and goals:

🚀
Path A — Fastest Start (5 min)
Install Cline from VS Code marketplace. Add your Anthropic or OpenRouter API key. Open a project, type a task, review and approve each step.

Best for: Anyone who wants to try agentic coding with full transparency.
🖥️
Path B — Terminal-First
Install Claude Code via npm. Navigate to your project. Run claude. Describe a task. Watch the agent plan, execute, and check back at decision points.

Best for: Backend devs, devops engineers, terminal-comfortable developers.
🏢
Path C — Team & Enterprise
Enable GitHub Copilot Agent Mode for your org. Create a .github/copilot-instructions.md with your team's standards. Assign issues to Copilot and review draft PRs.

Best for: Teams already on GitHub who want minimal tool change.

Your First 3 Agentic Tasks

Start here — these are ideal first agent assignments:

# 1. Write tests for existing code "Write pytest tests for the functions in app/utils.py with at least 90% coverage, following our existing test patterns"# 2. Refactor a module "Refactor auth.py to use the new JWT library in requirements.txt, maintaining backwards compatibility"# 3. Fix a specific bug "Issue #42: pagination breaks when result set is empty. Investigate and fix it."
10 — Craft

Pro Tips for Working with Agents

01

Write a CLAUDE.md or agents.md

Every project should have a markdown file with your stack, conventions, and constraints. Agents read this automatically — it's like onboarding your AI colleague.

02

Delegate low-to-medium complexity first

Agents excel at writing tests, fixing bugs, refactoring, updating docs, and adding features to established patterns. Start there and push harder as you learn the agent's strengths.

03

Run agents on well-tested codebases

Test coverage is a safety net for agents. When agents can run your tests and see failures, they can iterate toward correctness. Zero tests = agent flying blind.

04

Use Plan Mode before execution

Tools like Cline and Claude Code offer "plan first" mode. Always review the agent's plan before execution. Catching a wrong assumption at the plan stage takes 10 seconds.

05

Parallelize with multiple agents

Assign 3–5 GitHub issues to agents simultaneously, then spend your time reviewing PRs. Mission Control in Copilot and multi-session Claude Code make this practical today.

06

Use MCP to extend context

Connect MCP servers to give your agent access to your database schema, Jira tickets, Figma designs, internal docs, or Slack threads. MCP makes this portable across tools.

07

Treat agent output like a junior dev's PR

Don't rubber-stamp. Read the diff. Think about edge cases. Leave comments. The agent will iterate. Your review skills are now more valuable than ever.

08

Keep tasks scoped and clear

Vague tasks produce vague results. "Improve the backend" disappoints. "Add rate limiting to /api/users POST using the existing Redis client, returning 429 with retry-after header" impresses.

09

Encode team knowledge in skills

The skills.md pattern and Claude Code's plugin system let you encode your team's patterns and domain knowledge. New members — human or AI — inherit this immediately.

Let's Build

FS Studio is your strategic partner in unlocking the next frontier of product development and enterprise transformation

If you can imagine it, we can simulate it.