Context engineering for AI coding agents.
Warning
Experimental — Under active development. Expect breaking changes. Open an issue with feedback.
AI coding agents work best when they know how to build, test, and lint your code — plus your architecture, conventions, and the external services your team relies on. Most repos ship none of that.
AgentRC reads your codebase and generates the files that close that gap — then evaluates whether they actually help, so the context doesn't go stale as your code evolves.
npx github:microsoft/agentrcWorks as a CLI, as a VS Code extension, and in your CI/CD pipeline to monitor drift. No config needed — runs on any repo with Node.js 20+.
Score your repo’s AI-readiness across 9 pillars and a 5-level maturity model. Find out what context is missing — from basic linting to MCP server configs.
npx github:microsoft/agentrc readinessProduce tailored instruction files, evals, and dev configs via the Copilot SDK. No templates — AgentRC reads your actual code and generates context specific to your stack.
npx github:microsoft/agentrc instructionsContext goes stale as your codebase evolves. Evaluate whether your instructions still improve agent responses, and run the check in CI so drift doesn't slip through.
npx github:microsoft/agentrc eval| Workflow | Command |
|---|---|
| Interactive hub | agentrc |
| One-time setup | agentrc init |
| CI quality gate | agentrc readiness --fail-level 3 --json |
| Batch across an org | agentrc batch |
| Automated PR for any repo | agentrc pr owner/repo |
Works with GitHub and Azure DevOps. Supports monorepos, multi-root VS Code workspaces, and custom policies.
| File | Purpose |
|---|---|
.github/copilot-instructions.md |
Teaches AI agents your repo's conventions |
.vscode/mcp.json |
Connects AI to your stack's tools and data |
.vscode/settings.json |
Tunes VS Code for AI-assisted development |
agentrc.eval.json |
Test cases to measure instruction quality |
For multi-agent support (Copilot + Claude + others), generate
AGENTS.mdwith--output AGENTS.md. See Custom instructions in VS Code.
| Getting Started | Prerequisites and first run |
| Concepts | Maturity model, readiness pillars, how generation works |
| Commands | Full CLI reference |
| Configuration | Areas, workspaces, monorepos |
| Policies | Custom readiness scoring |
| At Scale | Batch processing across orgs |
| CI Integration | GitHub Actions & Azure Pipelines |
| VS Code Extension | Sidebar views, commands, settings |
| Examples | Configs, evals, and policies |
Customize AI in VS Code · Custom instructions · CONTRIBUTING.md
"Copilot CLI not found" — Install the GitHub Copilot Chat extension in VS Code. The CLI is bundled with it.
"Copilot CLI not logged in" — Run copilot in your terminal, then /login.
"GitHub auth required" — brew install gh && gh auth login, or set GITHUB_TOKEN (or GH_TOKEN).
"Azure DevOps auth required" — Set AZURE_DEVOPS_PAT or AZDO_PAT.
This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsoft's Trademark & Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party's policies.