Agent Framework AI Context Pack for Claude Code, Codex, Cursor, and Aider

Pack version: v1.0.0 · Last updated: 2026-05-15

Languages: English | 中文

Copy / Run / Verify

This is an independent AI context resource pack for microsoft/agent-framework: host instructions, prompt preview, evals, pitfalls, and recovery rules you can load into Claude Code, Codex, Cursor, Aider, and other AI coding agents.

1. Copy AGENTS.md into your AI coding host (or CLAUDE.md for Claude Code).
2. Run the first prompt in 01_PROMPT_PREVIEW.md.
3. Verify behavior with 06_EVALS/smoke_check.md.
4. If verification fails, recover with 03_PITFALL_LOG.md.

Quick links: Start · Prompt · Evals · Pitfalls · Manual

When This Helps

Use this pack when you want an AI coding agent to understand the upstream project context, setup boundaries, common pitfalls, and verification steps before it edits files, installs dependencies, or claims the tool is ready.

What You Get

• AGENTS.md / CLAUDE.md for AI coding agent hosts.
• Prompt preview in 01_PROMPT_PREVIEW.md.
• Acceptance checks in 06_EVALS/.
• Pitfall log and recovery steps in 03_PITFALL_LOG.md.
• Boundary and risk card in 04_BOUNDARY_RISK_CARD.md.
• Source attribution in SOURCE_MAP.md.

AGENTS.md for Claude Code and AI Coding Agents

See AGENTS.md for host instructions. Claude Code reads .md files in the project root as agent instructions.

microsoft/agent-framework Pitfalls and Recovery

Top 3 most actionable:

1. .NET SDK version conflict — causes MissingMethodException or FileNotFoundException at runtime; verify SDK version matches agent-framework release requirements.
2. Model configuration ignored — agent uses wrong model or ignores API key; set AGENT_MODEL_* env vars before runtime init.
3. Multi-agent initialization failure — agents hang or CustomStatus overflow; use separate runtime instances per agent role.

Real failure modes and recovery paths are documented in 03_PITFALL_LOG.md.

Source Attribution

Pack assembled by Doramagic. Upstream: https://github.com/microsoft/agent-framework (MIT license).

• Upstream/source: https://github.com/microsoft/agent-framework
• License: MIT
• Pack contents: prompts, host instructions, checks, guardrails, and validation notes
• Relationship: independent pack; not affiliated with or endorsed by microsoft/agent-framework unless explicitly stated

If this pack helps your agent work from evidence, star the repo or open an issue for bugs, usage questions, or new pitfall reports.