claudeers.

🔓 unclaimed — this page was auto-generated from GitHub. Are you the creator?

Claim this page →
// MCP Servers

agentic-engineering-handbook

The definitive OpenAI, Claude, MCP, Harness, Evals, and Production Agent Systems learning roadmap.

// MCP Servers[ cli ][ api ][ desktop ][ web ][ mobile ][ claude ]#claude#agentic-engineering#agents#ai-agents#anthropic#claude-code#llm#mcp#mcp-serversMIT$open-sourceupdated 15 days ago
Actively maintained
98/100
last commit 12 days ago
last release none
releases 0
open issues 0
// install
{
  "mcpServers": {
    "agentic-engineering-handbook": {
      "command": "npx",
      "args": ["-y", "https://github.com/keyuchen21/agentic-engineering-handbook"]
    }
  }
}

Agentic Engineering Handbook

The definitive OpenAI, Anthropic, Google, MCP, Harness, Evals, and Production Agent Systems learning roadmap.

If this repository helps you, consider giving it a ⭐


Why This Repository?

The AI industry has entered the Agentic Era. Building production-grade AI systems now requires mastering agents, tool use, MCP, memory, long-running workflows, coding agents, agent harnesses, evals, and safety — but the knowledge is scattered across OpenAI blogs, Anthropic engineering posts, SDK docs, cookbooks, and research papers.

This repository consolidates 161 curated resources into one structured learning roadmap.

The goal: Become a world-class Agentic Engineer.


How To Use This Handbook

Pick the path that matches your starting point:

  • New to agents: follow the Learning Roadmap from Phase 0 to Phase 6. Treat each Read First, Then Read, and Build Exercise as a checklist.
  • Already building LLM apps: start at Phase 2 or Phase 3, then fill gaps in agent loop, tool calling, evals, and production engineering.
  • Trying to build projects: use the phase-level Build Exercise prompts, then branch into Applied Practice Tracks for coding agents, security, code review, or SRE.
  • Looking for references: jump to the Full Reading Table. Read P0 first, use P1 for implementation detail, and keep P2 as optional background.

Learning Roadmap

Phase 0 — Agent Loop From Scratch

If you treat Claude Code as a coding CLI, many capabilities can feel like magic: it reads files, runs commands, edits code, delegates work, and stays oriented during complex tasks.

From an engineering perspective, the core is much simpler:

model + tools + one loop.

Understanding that loop makes the rest of the system easier to reason about:

  • When the agent should plan first, and when it should act immediately
  • Why an explicit todo list reduces drift in longer tasks
  • Why subagents improve exploration while protecting the main context
  • How skills, MCP, and hooks each add capability around the same core loop

These pages are based on the upstream English Markdown tutorials from shareAI-lab/mini-claude-code, with added Study Notes and inline source code for this handbook.

StepPageCode
v0Bash is All You Needv0_bash_agent.py
v1Model as Agentv1_basic_agent.py
v2Structured Planningv2_todo_agent.py
v3Subagent Mechanismv3_subagent.py
v4Skills Mechanismv4_skills_agent.py

Supporting files are included in the same folder: requirements.txt, .env.example, v0_bash_agent_mini.py, and skills/.


Phase 1 — Agent Foundations

Build shared vocabulary for workflow vs agent, tool loop, handoff, guardrails.

Key Mental Models

Should I build an agent? (4-question checklist from Barry Zhang's talk)

QuestionIf No → WorkflowIf Yes → Agent
Is the task complex enough?Decision tree is fully mappableAmbiguous problem space
Is the task valuable enough?<$0.10 per run>$1 per run, cost doesn't matter
Are all core capabilities doable?Weak links break the chainModel handles every step well
Is error cost low & detectable?High cost + hard to detect → human-in-the-loopErrors caught by tests/CI

Think like the agent. Most failures come from designing with a human perspective. Put yourself inside the agent's context window: you only see ~10K–20K tokens (system prompt + tool descriptions + recent observations). Ask: does the agent have enough information to act correctly at each step?

→ Source: How We Build Effective Agents

Read First

#TitleVendor
1System PromptsAnthropic
2Prompt guidanceOpenAI
3Function CallingOpenAI
4Tool use overviewAnthropic
5Function calling - Gemini APIGoogle
6Building effective agentsAnthropic
7New tools for building agentsOpenAI
8Agents SDK overviewOpenAI

Then Read

TitleVendor
How We Build Effective Agents: Barry Zhang, AnthropicAnthropic
Phistory — Claude Code & Codex CLI System Prompt Diff HistoryCommunity
Coding Agents 101: The Art of Actually Getting Things DoneCognition
OpenAI Agents SDK examplesOpenAI
Structured Outputs for Multi-Agent SystemsOpenAI

Build Exercise

Build a customer service/ticket triage agent: router → specialist → evaluator, with all outputs constrained by structured schemas.


Phase 2 — MCP & Tool Ecosystem

Understand MCP server/client, remote vs local, tool loading, approval, connector boundaries.

Read First

#TitleVendor
1Introducing the Model Context ProtocolAnthropic
2MCP and ConnectorsOpenAI
3Building MCP servers for ChatGPT Apps and API integrationsOpenAI

Then Read

TitleVendor
Code execution with MCP: Building more efficient agentsAnthropic
Writing effective tools for AI agents - with AI agentsAnthropic
Model Context Protocol - CodexOpenAI
Build a Remote MCP serverCloudflare
Introducing the MCP RegistryMCP
OpenAI Docs MCPOpenAI
Build your ChatGPT UIOpenAI

Build Exercise

Build a read-only repo/docs MCP server, then create an eval to verify the agent correctly cites documentation.


Phase 3 — Context, Memory & Skills

Learn to control context window, short/long-term memory, skills/plugins, CLAUDE.md/AGENTS.md.

Read First

#TitleVendor
1Agent Skills SpecificationAgent Skills
2Effective context engineering for AI agentsAnthropic
3How Long Contexts FailDrew Breunig
4Context RotChroma
5Progressive disclosureClaude-Mem
6Equipping agents for the real world with Agent SkillsAnthropic
7Agent SkillsAnthropic
8SkillsOpenAI
9Building Reliable Agents with Memory and CompactionOpenAI

Then Read

TitleVendor
Custom instructions with AGENTS.md - CodexOpenAI
Best practices for Claude CodeAnthropic
Agent Skills - CodexOpenAI
Skills in OpenAI APIOpenAI

Build Exercise

Implement the same task as a Skill/Plugin, then measure accuracy and token cost across three variants: no skill, long prompt, and skill-based.


Phase 4 — Harness & Long-Running Agents

Master agent runtime: event stream, thread, tool execution, state, sandbox, approval, recovery.

Read First

#TitleVendor
1Unrolling the Codex agent loopOpenAI
2Unlocking the Codex harness: how we built the App ServerOpenAI
3Agent Harness Engineering: A SurveyAcademic
4Effective harnesses for long-running agentsAnthropic

Then Read

TitleVendor
The next evolution of the Agents SDKOpenAI
Using PLANS.md for multi-hour problem solvingOpenAI
Build long-running AI agents that pause, resume, and never lose context with ADKGoogle
Harness design for long-running application developmentAnthropic
Scaling Managed Agents: Decoupling the brain from the handsAnthropic

Build Exercise

Build a mini coding harness: plan file, shell tool, apply patch, test gate, event log, and resume capability.


Phase 5 — Coding & Workspace Agents

Compare Codex vs Claude Code product/SDK forms; learn multi-agent, IDE, workspace collaboration.

Read First

#TitleVendor
1Introducing CodexOpenAI
2Best practices for Claude CodeAnthropic
3How Claude Code works in large codebasesAnthropic
4Enabling Claude Code to work more autonomouslyAnthropic

Then Read

TitleVendor
Introducing the Codex appOpenAI
Introducing workspace agents in ChatGPTOpenAI
Apple's Xcode now supports Claude Agent SDKAnthropic
Building Consistent Workflows with Codex CLI & Agents SDKOpenAI
Best practices for Claude CodeAnthropic
The spec is dead, long live the spec!Ravi on Product
How Anthropic teams use Claude CodeAnthropic
Multi-stack Web App BuildsCommunity

Build Exercise

Run both OpenAI/Codex and Claude Code style workflows on the same repo: issue → plan → patch → tests → PR summary.


Phase 6 — Evals, Safety & Production

Build pre/post-launch eval loop, trace loop, safety boundaries, permissions, regression monitoring.

Read First

#TitleVendor
1Demystifying evals for AI agentsAnthropic
2Testing Agent Skills Systematically with EvalsOpenAI
3Build an Agent Improvement Loop with Traces, Evals, and CodexOpenAI

Then Read

TitleVendor
Running Codex safely at OpenAIOpenAI
How we contain Claude across productsAnthropic
Evals API Use-case - MCP EvaluationOpenAI
Measuring AI agent autonomy in practiceAnthropic

Build Exercise

Build a smoke/macro eval suite for your agent: task success rate, tool misuse, prompt injection resistance, latency, cost, and human approval count.


Applied Practice Tracks

Use these tracks after the core roadmap when you want to practice agentic engineering in real engineering workflows.

TrackStart HereWhy It Matters
Agentic coding workflowCoding Agents 101, How Claude Code works in large codebases, How Anthropic teams use Claude CodeTurns agent theory into day-to-day engineering habits: prompting, checkpoints, verification, parallel work, and team rollout.
Spec-driven buildingThe spec is dead, long live the spec!, Multi-stack Web App BuildsTreats specs, prompts, and assignments as executable source material for agents.
Context failure modesHow Long Contexts Fail, Context Rot, Progressive disclosureHelps diagnose context poisoning, distraction, confusion, context degradation, and retrieval overload.
MCP operationsBuild a Remote MCP server, Introducing the MCP RegistryShows how MCP moves from local prototypes to authenticated, discoverable, production-grade tool ecosystems.
Agent securityOWASP Top Ten, SAST vs. DAST vs. RASP, Copilot Remote Code Execution via Prompt InjectionGrounds agent security in classic AppSec plus new prompt-injection and tool-permission failure modes.
Code review systemsHow to Review Code Effectively, AI-Assisted Assessment of Coding Practices in Modern Code Review, AI Code Review Implementation Best PracticesConnects human review quality with AI-assisted review, automated comments, and review policy design.
Production and SRE agentsML and LLM system design, Introduction to Site Reliability Engineering, Observability Basics You Should KnowExtends agents beyond coding into incidents, observability, root-cause analysis, on-call, and production operations.

Full Reading Table

Priority guide: P0 = must-read (architectural/conceptual), P1 = highly useful (implementation detail), P2 = optional context (background/releases).

PriorityTitleVendorTopicKey IdeaDate
P0OpenAI for Developers in 2025OpenAIAgents; MCP; PlatformAnnual overview: systematic walkthrough of Responses API, Agents SDK, AgentKit, Codex, MCP, Apps SDK, and AGENTS.md.2025-12-30
P0New tools for building agentsOpenAIAgents; Responses API; ToolsKey starting point for OpenAI's agent platform: Responses API, built-in web/file/computer tools, Agents SDK, tracing/observability.2025-03-11
P0Introducing AgentKitOpenAIAgents; Evals; AgentKitAgentKit, expanded evals, agent RFT: the official agent toolchain from prototype to production.2025-10-06
P0Prompt guidanceOpenAIPrompting; Models; Agent UXOfficial model-specific prompting guidance for outcome-first prompts, reasoning effort, preambles, and validation rules in tool-heavy workflows.Current docs
P0System PromptsAnthropicSystem prompts; Claude; BehaviorClaude web/mobile system prompt release notes; useful for studying production prompting patterns and behavioral scaffolding.Current docs
P0Agents SDK overviewOpenAIAgents; SDKOfficial SDK entry point: concepts and boundaries of agent, tool, handoff, guardrail, and tracing.Current docs
P0Introducing the Model Context ProtocolAnthropicMCP; StandardsThe origin article for MCP: an open standard connecting AI assistants to data, tools, and systems.2024-11-25
P0Building effective agentsAnthropicAgents; Patterns; FrameworksEssential agent primer: workflow vs agent, prompt/tool/retrieval, orchestrator-worker, evaluator-optimizer patterns.2024-12-19
P0Coding Agents 101: The Art of Actually Getting Things DoneCognitionCoding agents; Workflows; PracticeProduct-agnostic guide to prompting, delegation, verification, environment setup, security, and cost management for coding agents.2025-06
P0New tools and features in the Responses APIOpenAIMCP; Responses API; ToolsResponses API extended to remote MCP servers, image/code/file tools; see how OpenAI integrates MCP into its runtime.2025-05-21
P0MCP and ConnectorsOpenAIMCP; Connectors; Responses APIOfficial guide to connecting remote MCP servers and connectors; includes approvals and security considerations.Current docs
P0Building MCP servers for ChatGPT Apps and API integrationsOpenAIMCP; ChatGPT Apps; APIOfficial guide to writing MCP servers: supply tools/knowledge to ChatGPT Apps, deep research, and API integrations.Current docs
P0Building a Deep Research MCP ServerOpenAIMCP; Deep researchMinimal implementation of a search/fetch MCP server for Deep Research.2025-06-25
P0Model Context Protocol - CodexOpenAIMCP; CodexHow Codex CLI/IDE connects to MCP servers, adding Figma, browser, docs, and internal tool context to agents.Current docs
P0Introducing CodexOpenAIAgents; Coding; SandboxCloud-based software engineering agent: parallel tasks, repo sandbox, running tests/linters/type checkers, producing auditable evidence.2025-05-16
P0Agent Harness Engineering: A SurveyAcademicHarness; Taxonomy; Agent architectureSurvey that frames harness engineering as its own system layer and introduces the ETCLOVG taxonomy: Execution, Tooling, Context, Lifecycle, Observability, Verification, and Governance.2026
P0Unrolling the Codex agent loopOpenAIHarness; Agent loop; CodexHow Codex CLI chains prompt, tool schema, MCP tools, Responses API, and context management into an agent loop.2026-01-23
P0Unlocking the Codex harness: how we built the App ServerOpenAIHarness; Codex App Server; JSON-RPCCore harness article: Codex core, App Server, JSON-RPC, streaming progress, approval, diff, and thread management.2026-02-04
P0From model to agent: Equipping the Responses API with a computer environmentOpenAIHarness; Responses API; SandboxResponses API + shell tool + hosted containers form the agent runtime; essential for understanding the model-to-agent execution environment.2026-03-10
P0Harness engineering: leveraging Codex in an agent-first worldOpenAIHarness; Agent-first engineeringDesign product code, tests, CI, docs, and observability to be agent-readable/executable; learn agent-first repo organization.2026-02-11
P0The next evolution of the Agents SDKOpenAIHarness; Agents SDK; MCP; SkillsAgents SDK harness becomes more complete: memory, sandbox orchestration, Codex-like filesystem tools, MCP, skills, AGENTS.md.2026-04-15
P0Building Consistent Workflows with Codex CLI & Agents SDKOpenAIMCP; Codex; Agents SDKCodex CLI as an MCP server integrated with Agents SDK; real multi-agent dev workflow.2025-10-01
P0Building Reliable Agents with Memory and CompactionOpenAIMemory; Compaction; ReliabilityMemory and compaction design for long-context/multi-turn agents.2026-05-01
P0Build an Agent Improvement Loop with Traces, Evals, and CodexOpenAIEvals; Traces; Self-improvementConnect traces, evals, and Codex fixes into an agent improvement loop.2026-05-12
P0Eval Driven System Design - From Prototype to ProductionOpenAIEvals; ProductionUse evals as the driving force for system design; ideal for moving agents from demo to production.2025-06-02
P0Testing Agent Skills Systematically with EvalsOpenAIEvals; Skills; AgentsSystematically test agent skills with evals; establish quality gates before skill release.2026-01-22
P0Evals API Use-case - MCP EvaluationOpenAIMCP; EvalsEvaluate QA/retrieval capabilities with MCP tools; ideal for building an MCP regression suite.2025-06-09
P0Running Codex safely at OpenAIOpenAISafety; Sandbox; CodexHow OpenAI runs Codex internally: sandbox, approvals, network policy, agent-native telemetry.2026-05-20
P0Building Governed AI Agents - A Practical Guide to Agentic ScaffoldingOpenAIGovernance; Guardrails; AgentsGoverned agent scaffolding: permissions, guardrails, auditing, and organizational policies.2026-02-23
P0Macro Evals for Agentic SystemsOpenAIEvals; Agentic systemsEvaluate agents at the end-to-end/macro level, not just individual step outputs.2026-05-19
P0Best practices for Claude CodeAnthropicCoding agents; Claude CodeClaude Code methodology: verification loop, explore-plan-code, CLAUDE.md, permissions, MCP, subagents, context management.2025-04-18
P0Best practices for Claude CodeAnthropicClaude Code; Coding agents; WorkflowOfficial Claude Code docs for planning, CLAUDE.md, verification, tool use, and team workflows.Current docs
P0How Claude Code works in large codebasesAnthropicClaude Code; Large codebases; EnterprisePatterns for large-codebase Claude Code adoption: layered CLAUDE.md, hooks, skills, plugins, MCP, LSP, subagents, and rollout ownership.2026-05-14
P0How we built our multi-agent research systemAnthropicAgents; Multi-agent; ResearchClaude Research multi-agent architecture: planner + parallel research agents + synthesis; production multi-agent experience.2025-06-13
P0Writing effective tools for AI agents - with AI agentsAnthropicTools; MCP; EvalsTool quality determines agent quality: tool descriptions, context budget, eval, and letting Claude optimize its own tools.2025-09-11
P0Effective context engineering for AI agentsAnthropicContext; AgentsContext is the agent's core resource: selection, compression, isolation, persistence, and context pollution control.2025-09-29
P0How Long Contexts FailDrew BreunigContext; Long context; AgentsTaxonomy of context poisoning, distraction, confusion, and clash; practical fixes for overloaded agent contexts.2025-06-22
P0Context RotChromaContext; Long-context evalsResearch on how LLM performance degrades as input grows, especially with distractors and similar-but-wrong context.2025-07-16
P0Enabling Claude Code to work more autonomouslyAnthropicClaude Code; Agent SDK; SubagentsClaude Agent SDK, subagents, hooks, background tasks, checkpoints, and other autonomous coding agent capabilities.2025-09-29
P0Equipping agents for the real world with Agent SkillsAnthropicSkills; AgentsAgent Skills as modular capability packages: instructions, resources, scripts — reducing context burden and improving reliability.2025-10-16
P0Agent SkillsAnthropicSkills; Claude; Progressive disclosureOfficial Claude Agent Skills docs: modular instructions, metadata, scripts, resources, and on-demand loading across Claude products.Current docs
P0SkillsOpenAISkills; API; Shell environmentsOfficial OpenAI API guide for uploading, managing, and attaching reusable Skills to hosted and local shell environments.Current docs
P0Agent Skills SpecificationAgent SkillsSkills; Specification; Progressive disclosureComplete skill package format: SKILL.md frontmatter, optional scripts/references/assets, file references, and validation.Current docs
P0Code execution with MCP: Building more efficient agentsAnthropicMCP; Code execution; ContextKey article on MCP scale challenges: reduce token overhead with code execution/on-demand tools; learn progressive disclosure.2025-11-04
P0Introducing advanced tool use on Claude Developer PlatformAnthropicTools; MCP; Advanced tool useTool search, deferred loading, programmatic tool calling; solving context pollution from large numbers of MCP tools.2025-11-24
P0Effective harnesses for long-running agentsAnthropicHarness; Long-running agentsEssential harness reading: working across multiple context windows, task logging, external state, agent self-recovery.2025-11-26
P0Demystifying evals for AI agentsAnthropicEvals; AgentsAgent evals are more complex than static evals: multi-turn, tools, state changes, creative solutions, failure taxonomy.2026-01-09
P0Measuring AI agent autonomy in practiceAnthropicAgents; Autonomy; MeasurementQuantify agent autonomy using metrics like task duration and supervision needs; ideal for building autonomy benchmarks.2026-02-18
P0Harness design for long-running application developmentAnthropicHarness; Application developmentHarness design patterns for delegating long-running app development tasks to agents; compare with OpenAI Codex harness.2026-03-24
P0Scaling Managed Agents: Decoupling the brain from the handsAnthropicManaged agents; HarnessDecouple the model brain from execution hands/harness, keeping interfaces stable as the harness evolves.2026-04-08
P0How we contain Claude across productsAnthropicSafety; Containment; AgentsBlast radius of powerful agent releases, human-in-the-loop, and containment strategies.2026-05-25
P1Structured Outputs for Multi-Agent SystemsOpenAIAgents; Multi-agent; Structured outputsUse strict schemas to constrain structured messages and handoffs between multiple agents.2024-08-06
P1Introducing computer use, a new Claude 3.5 Sonnet, and Claude 3.5 HaikuAnthropicAgents; Computer useClaude computer use beta starting point: the model uses a computer via screenshots and actions.2024-10-22
P1Raising the bar on SWE-bench Verified with Claude 3.5 SonnetAnthropicAgents; Coding; EvalsSWE-bench agent scaffolding article: same model performance strongly depends on harness/scaffolding.2025-01-06
P1Introducing OperatorOpenAIAgents; Computer use; SafetyEarly product form of browser-based agents: model clicks, types, and executes tasks on web pages, emphasizing user confirmation and safety boundaries.2025-01-23
P1Computer-Using AgentOpenAIAgents; Computer useUnderstand how CUA combines vision, mouse/keyboard actions, and environment feedback into an agent loop; compare with Claude computer use.2025-01-23
P1Claude 3.7 Sonnet and Claude CodeAnthropicAgents; Coding; Claude CodeEarly release of Claude Code, marking Claude's entry into the agentic coding tool space.2025-02-24
P1The think tool: Enabling Claude to stop and think in complex tool use situationsAnthropicTools; Reasoning; AgentsGive the model an explicit think tool in complex tool-use chains; learn tool design for policy-heavy/multi-step decisions.2025-03-20
P1Evaluating Agents with LangfuseOpenAIEvals; AgentsObserve and evaluate Agents SDK runs with Langfuse; learn tracing/eval workflows.2025-03-31
P1Parallel Agents with the OpenAI Agents SDKOpenAIAgents; Parallelism; Agents SDKParallel agent patterns: decompose tasks, execute in parallel, aggregate results.2025-05-01
P1Multi-Agent Portfolio Collaboration with OpenAI Agents SDKOpenAIAgents; Multi-agent; PortfolioMulti-agent collaboration business example: research, analysis, combined output.2025-05-28
P1MCP-Powered Agentic Voice FrameworkOpenAIMCP; Voice; AgentsVoice agent + MCP paradigm: real-time interaction, tool extension, task execution.2025-06-17
P1Deep Research API with the Agents SDKOpenAIAgents; Deep research; Agents SDKIntegrate Deep Research API into Agents SDK workflows.2025-06-25
P1Desktop Extensions: One-click MCP server installation for Claude DesktopAnthropicMCP; Claude Desktop; PackagingPackage local MCP servers as one-click install extensions; learn MCP distribution/installation/local permission issues.2025-06-26
P1Building a Supply-Chain Copilot with OpenAI Agent SDK and Databricks MCP ServersOpenAIMCP; Agents; DatabricksEnterprise data platform MCP + Agent SDK business agent example.2025-07-08
P1Introducing ChatGPT agent: bridging research and actionOpenAIAgents; ChatGPT; Computer useEnd-user-facing ChatGPT agent: combining research, browser, computer use, file/slide capabilities.2025-07-17
P1ChatGPT agent System CardOpenAIAgents; Safety; EvalsLearn pre-launch risk classification, evaluation, permissions, human confirmation, and abuse prevention for agent products.2025-07-17
P1Context Engineering - Short-Term Memory Management with SessionsOpenAIContext; Sessions; AgentsHow short-term memory/session state affects agent reliability.2025-09-09
P1Progressive disclosureClaude-MemContext; Memory; Progressive disclosureMake retrieval costs visible and let the agent fetch details on demand, reducing context pollution and attention waste.Current docs
P1Introducing upgrades to CodexOpenAIAgents; Coding; IDECodex evolves from research preview to daily dev tool: CLI, IDE, web/mobile collaboration, and more independent task execution.2025-09-15
P1Introducing Claude Sonnet 4.5AnthropicAgents; Claude Agent SDK; Computer useSonnet 4.5 emphasizes coding, complex agents, computer use, with simultaneous Agent SDK launch.2025-09-29
P1Introducing apps in ChatGPT and the new Apps SDKOpenAIMCP; Apps; ChatGPTApps SDK extends UI and tool server via MCP; entry point for understanding the ChatGPT app / MCP app ecosystem.2025-10-06
P1Build your ChatGPT UIOpenAIMCP; Apps SDK; UIBuild custom UI components that turn structured MCP tool results into interactive ChatGPT app interfaces.Current docs
P1Codex is now generally availableOpenAIAgents; Coding; Codex SDKCodex GA, Slack integration, Codex SDK, admin tools; see how coding agents enter enterprise management.2025-10-06
P1Using PLANS.md for multi-hour problem solvingOpenAICodex; Long-running; PlanningExecPlan files and cross-context task management for multi-hour coding-agent work.2025-10-07
P1Beyond permission prompts: making Claude Code more secure and autonomousAnthropicSafety; Permissions; Claude CodeFrom simple permission prompts to fine-grained security policies, reducing autonomous mode risk and interruptions.2025-10-20
P1Introducing Aardvark: OpenAI's agentic security researcherOpenAIAgents; SecuritySecurity-domain agent form: continuous scanning, issue verification, fix suggestions; later integrated as Codex Security.2025-10-30
P1Build a coding agent with GPT 5.1OpenAIAgents; CodingBuild a coding agent from scratch: understand file editing, command execution, loops, and verification.2025-11-13
P1OpenAI co-founds Agentic AI FoundationOpenAIMCP; Standards; AGENTS.mdMCP, AGENTS.md, and agent standards enter the Linux Foundation/AAIF context; understand ecosystem standardization.2025-12-09
P1Donating MCP and establishing the Agentic AI FoundationAnthropicMCP; Standards; AAIFAnthropic donates MCP to Linux Foundation/AAIF; read alongside OpenAI's AAIF article.2025-12-09
P1Context Engineering for Personalization - Long-Term Memory NotesOpenAIContext; Long-term memory; AgentsHow long-term memory serves as agent personalization/state management.2026-01-05
P1Supercharging Codex with JetBrains MCP at SkyscannerOpenAIMCP; Codex; IDEReal IDE/MCP case study: how Codex CLI accesses IDE context and dev tools via JetBrains MCP.2026-01-11
P1Designing AI-resistant technical evaluationsAnthropicEvals; Technical hiringHow strong agents continuously break technical evaluations; relevant to benchmark contamination prevention and eval design.2026-01-21
P1Inside OpenAI's in-house data agentOpenAIAgents; Data; MemoryInternal data agent case study: memory, Codex, data context, reliability; learn enterprise knowledge/data agents.2026-01-29
P1Introducing the Codex appOpenAIAgents; Coding; Multi-agentDesktop command center for agents: multi-threaded/parallel long tasks, project-level agent workflows.2026-02-02
P1Apple's Xcode now supports Claude Agent SDKAnthropicClaude Agent SDK; Xcode; MCPEmbed Claude Agent SDK in Xcode: harness, subagents, background tasks, plugins, MCP.2026-02-03
P1Quantifying infrastructure noise in agentic coding evalsAnthropicEvals; Coding agents; InfrastructureEnvironment configuration significantly impacts scores in agentic coding evals; control infrastructure noise in both production and benchmarks.2026-02-05
P1Building a C compiler with a team of parallel ClaudesAnthropicMulti-agent; Coding; Long-runningParallel Claude teams completing large engineering tasks; learn multi-agent division of labor, coordination, and long-running execution.2026-02-05
P1Codex Security: now in research previewOpenAIAgents; Security; CodexProductization of an agentic security researcher: vulnerability discovery, verification, fix suggestions, reducing triage noise.2026-03-06
P1Eval awareness in Claude Opus 4.6's BrowseComp performanceAnthropicEvals; Agent awarenessRisk of models recognizing/adapting to evaluations; relevant to agent benchmark credibility discussions.2026-03-06
P1How we built Claude Code auto mode: a safer way to skip permissionsAnthropicSafety; Permissions; AutonomyClaude Code auto mode risk classification, allow/block rules, exception handling, and security testing.2026-03-25
P1Migrate a Legacy Codebase with Sandbox AgentsOpenAIAgents; Sandbox; EvalsSandbox agent evaluation and execution patterns in large legacy code migrations.2026-04-07
P1Codex for (almost) everythingOpenAIAgents; Codex; MCP; PluginsCodex app expanded to Windows/macOS, computer use, in-app browser, memory, plugins, MCP servers.2026-04-16
P1Computer Use Agents in Daytona SandboxesOpenAIComputer use; Sandbox; AgentsComputer-use agents and sandbox runtimes; compare with Operator/CUA/Claude computer use.2026-04-19
P1Introducing workspace agents in ChatGPTOpenAIAgents; Workspace; GovernanceWorkspace agents: shared agents, permissions, tools, memory, safeguards; ideal for team collaboration agent design.2026-04-22
P1Building workspace agents in ChatGPT to complete repeatable, end-to-end workOpenAIWorkspace agents; ChatGPTPractical workspace agents for repeatable end-to-end team workflows.2026-04-22
P1Speeding up agentic workflows with WebSockets in the Responses APIOpenAIAgents; Latency; Responses APIOptimize latency by treating agentic rollouts as long-lived connections/tasks; learn production agent transport and caching.2026-05-01
P1Agents for financial servicesAnthropicAgents; Finance; MCPTen ready-to-run agent templates, Claude Code/Cowork plugins, Managed Agents cookbooks, MCP app.2026-05-05
P1Migrate from the Claude Agent SDK to the OpenAI Agents SDKOpenAIAgents SDK; MigrationCompare Claude Agent SDK and OpenAI Agents SDK from a migration perspective; ideal for dual-stack learning.2026-05-07
P1Build long-running AI agents that pause, resume, and never lose context with ADKGoogleHarness; Long-running agents; ADKPractical ADK tutorial for durable state machines, persistent sessions, event-driven resume, multi-agent delegation, and evals.2026-05-12
P1Building a safe, effective sandbox to enable Codex on WindowsOpenAISafety; Sandbox; CodexCoding agent sandbox design on Windows: file access, network restrictions, approval tradeoffs.2026-05-13
P1Building self-improving tax agents with CodexOpenAIAgents; Evals; Self-improvementCombine production traces, expert feedback, Codex loop, and eval infrastructure into self-improving business agents.2026-05-27
P1SchemaFlow: Agentic Database Change Impact Analysis, SQL Generation, and Eval GuardrailsOpenAIEvals; SQL; Agent guardrailsGuardrails and eval guardrails examples for data/SQL agents.2026-06-05
P1Agents SDK quickstartOpenAIAgents; SDKQuickly build a minimal agent; understand the code patterns of run, tool, and handoff.Current docs
P1OpenAI Agents SDK examplesOpenAIAgents SDK; Patterns; ExamplesPractical examples for agent patterns, MCP, memory, guardrails, approvals, handoffs, and streaming.Current docs
P1MCP Apps compatibility in ChatGPTOpenAIMCP; Apps SDK; UIUnderstand MCP Apps UI standards, iframe/bridge, and compatibility between ChatGPT and other hosts.Current docs
P1Use Codex with the Agents SDKOpenAIMCP; Codex; Agents SDKUse Codex as an MCP server for other agents to call; ideal for multi-agent dev workflows.Current docs
P1Agent approvals and security - CodexOpenAISafety; Approvals; CodexOfficial reference for Codex approval modes, sandbox, network access; read alongside OpenAI/Anthropic safety articles.Current docs
P1Agent Skills - CodexOpenAICodex; Skills; PluginsSkills/Plugins as reusable workflow packages; compare with Anthropic Agent Skills.Current docs
P1Skills in OpenAI APIOpenAISkills; OpenAI APICookbook example for using Skills in the OpenAI API and connecting skill bundles to agent workflows.Current docs
P1Custom instructions with AGENTS.md - CodexOpenAIAGENTS.md; ContextHow AGENTS.md provides persistent project specifications for agents; establish repo-level agent contracts.Current docs
P1Agents SDK integrations and observabilityOpenAIObservability; MCP; TracingTracing, MCP integration, provider/observability; essential for production agent debugging.Current docs
P1Secure MCP TunnelOpenAIMCP; Security; Private toolsSecurely expose private/intranet MCP servers to supported OpenAI surfaces; ideal for enterprise deployment.Current docs

view the full README on GitHub.

// compatibility

Platformscli, api, desktop, web, mobile
Operating systems
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguagePython

// faq

What is agentic-engineering-handbook?

The definitive OpenAI, Claude, MCP, Harness, Evals, and Production Agent Systems learning roadmap.. It is open-source on GitHub.

Is agentic-engineering-handbook free to use?

agentic-engineering-handbook is open-source under the MIT license, so it is free to use.

What category does agentic-engineering-handbook belong to?

agentic-engineering-handbook is listed under mcp-servers in the Claudeers registry of Claude-compatible tools.

4 views
144 stars
unclaimed
updated 15 days ago

// embed badge

agentic-engineering-handbook on Claudeers
[![Claudeers](https://claudeers.com/api/badge/agentic-engineering-handbook.svg)](https://claudeers.com/agentic-engineering-handbook)

// retro hit counter

agentic-engineering-handbook hit counter
[![Hits](https://claudeers.com/api/counter/agentic-engineering-handbook.svg)](https://claudeers.com/agentic-engineering-handbook)

// reviews

// guestbook

0/500

// related in MCP Servers

🔓

f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete…

// mcp-serversf/HTML164,687NOASSERTION[ claude ]
🔓

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io

// mcp-serversfarion1231/Rust112,854MIT[ claude ]
🔓

An open-source AI agent that brings the power of Gemini directly into your terminal.

// mcp-serversgoogle-gemini/TypeScript105,729Apache-2.0[ claude ]
🔓

A collection of MCP servers.

// mcp-serverspunkpeye/90,251MIT[ claude ]
→ see how agentic-engineering-handbook connects across the ecosystem