{"id":46614187,"url":"https://github.com/microsoft/agentrc","last_synced_at":"2026-05-30T09:01:11.780Z","repository":{"id":335214223,"uuid":"1144786495","full_name":"microsoft/agentrc","owner":"microsoft","description":"Get your repo ready for AI.","archived":false,"fork":false,"pushed_at":"2026-05-28T07:24:52.000Z","size":3334,"stargazers_count":895,"open_issues_count":34,"forks_count":80,"subscribers_count":7,"default_branch":"main","last_synced_at":"2026-05-29T01:25:36.944Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/microsoft.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":"SECURITY.md","support":"SUPPORT.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-01-29T03:37:22.000Z","updated_at":"2026-05-28T23:48:11.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/microsoft/agentrc","commit_stats":null,"previous_names":["pierceboggan/primer","microsoft/agent-init"],"tags_count":76,"template":false,"template_full_name":null,"purl":"pkg:github/microsoft/agentrc","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2Fagentrc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2Fagentrc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2Fagentrc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2Fagentrc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/microsoft","download_url":"https://codeload.github.com/microsoft/agentrc/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2Fagentrc/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33686018,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-30T02:00:06.278Z","response_time":92,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-03-07T19:31:20.481Z","updated_at":"2026-05-30T09:01:11.722Z","avatar_url":"https://github.com/microsoft.png","language":"TypeScript","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"readme":"# AgentRC\n\n**Context engineering for AI coding agents.**\n\n[![CI](https://github.com/microsoft/agentrc/actions/workflows/ci.yml/badge.svg)](https://github.com/microsoft/agentrc/actions/workflows/ci.yml)\n[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)\n\n\u003e [!WARNING]\n\u003e **Experimental** — Under active development. Expect breaking changes. [Open an issue](https://github.com/microsoft/agentrc/issues) with feedback.\n\n---\n\nAI 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.\n\nAgentRC 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.\n\n```bash\nnpx github:microsoft/agentrc\n```\n\nWorks as a CLI, as a [VS Code extension](docs/extension.md), and in your [CI/CD pipeline](docs/ci-integration.md) to monitor drift. No config needed — runs on any repo with Node.js 20+.\n\n![AgentRC — Measure, Generate, Maintain cycle](docs/assets/agentrc-overview.png)\n\n## What it does\n\n### Measure\n\nScore 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.\n\n```bash\nnpx github:microsoft/agentrc readiness\n```\n\n### Generate\n\nProduce 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.\n\n```bash\nnpx github:microsoft/agentrc instructions\n```\n\n### Maintain\n\nContext 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.\n\n```bash\nnpx github:microsoft/agentrc eval\n```\n\n## Works at every scale\n\n| Workflow                  | Command                                   |\n| ------------------------- | ----------------------------------------- |\n| Interactive hub           | `agentrc`                                 |\n| One-time setup            | `agentrc init`                            |\n| CI quality gate           | `agentrc readiness --fail-level 3 --json` |\n| Batch across an org       | `agentrc batch`                           |\n| Automated PR for any repo | `agentrc pr owner/repo`                   |\n\nWorks with **GitHub** and **Azure DevOps**. Supports monorepos, multi-root VS Code workspaces, and custom [policies](docs/policies.md).\n\n## What gets generated\n\n| File                              | Purpose                                    |\n| --------------------------------- | ------------------------------------------ |\n| `.github/copilot-instructions.md` | Teaches AI agents your repo's conventions  |\n| `.vscode/mcp.json`                | Connects AI to your stack's tools and data |\n| `.vscode/settings.json`           | Tunes VS Code for AI-assisted development  |\n| `agentrc.eval.json`               | Test cases to measure instruction quality  |\n\n\u003e For multi-agent support (Copilot + Claude + others), generate `AGENTS.md` with `--output AGENTS.md`. See [Custom instructions in VS Code](https://code.visualstudio.com/docs/copilot/customization/custom-instructions).\n\n## Works with APM\n\n[APM](https://github.com/microsoft/apm) (Agent Package Manager) distributes agent instructions, skills, and prompts across repos — like npm for AI agent configs.\n\nAgentRC generates the content. APM distributes it:\n\n- **In your project** — run `agentrc init` to generate instructions, then `apm install org/standards` to pull in shared agent packages from your team\n- **For your team** — create a dedicated APM package with your best instructions and skills, then teammates install it with `apm install`\n- **At scale** — `apm audit` scans for security issues; `apm-policy.yml` enforces org standards across all repos\n\nThe `.instructions.md` format is shared by both tools — no conversion needed when moving instructions into APM packages.\n\n## Documentation\n\n|                                                |                                                         |\n| ---------------------------------------------- | ------------------------------------------------------- |\n| **[Getting Started](docs/getting-started.md)** | Prerequisites and first run                             |\n| **[Concepts](docs/concepts.md)**               | Maturity model, readiness pillars, how generation works |\n| **[Commands](docs/commands.md)**               | Full CLI reference                                      |\n| **[Configuration](docs/configuration.md)**     | Areas, workspaces, monorepos                            |\n| **[Policies](docs/policies.md)**               | Custom readiness scoring                                |\n| **[At Scale](docs/at-scale.md)**               | Batch processing across orgs                            |\n| **[CI Integration](docs/ci-integration.md)**   | GitHub Actions \u0026 Azure Pipelines                        |\n| **[VS Code Extension](docs/extension.md)**     | Sidebar views, commands, settings                       |\n| **[Agent Plugin](plugin/README.md)**           | Install as a Copilot agent plugin with built-in skills  |\n| **[Examples](examples/)**                      | Configs, evals, and policies                            |\n\n[Customize AI in VS Code](https://code.visualstudio.com/docs/copilot/customization/overview) · [Custom instructions](https://code.visualstudio.com/docs/copilot/customization/custom-instructions) · [CONTRIBUTING.md](CONTRIBUTING.md)\n\n## Troubleshooting\n\n**\"Copilot CLI not found\"** — Install the [GitHub Copilot Chat extension](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot-chat) in VS Code. The CLI is bundled with it.\n\n**\"Copilot CLI not logged in\"** — Run `copilot` in your terminal, then `/login`.\n\n**\"GitHub auth required\"** — `brew install gh \u0026\u0026 gh auth login`, or set `GITHUB_TOKEN` (or `GH_TOKEN`).\n\n**\"Azure DevOps auth required\"** — Set `AZURE_DEVOPS_PAT` or `AZDO_PAT`.\n\n## License\n\n[MIT](LICENSE)\n\n## Trademarks\n\nThis 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 \u0026 Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general). 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.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicrosoft%2Fagentrc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmicrosoft%2Fagentrc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicrosoft%2Fagentrc/lists"}