diff --git a/docs/astro.config.mjs b/docs/astro.config.mjs index fb447ed49..68dd0153c 100644 --- a/docs/astro.config.mjs +++ b/docs/astro.config.mjs @@ -93,6 +93,7 @@ export default defineConfig({ { label: 'IDE & Tool Integration', slug: 'integrations/ide-tool-integration' }, { label: 'AI Runtime Compatibility', slug: 'integrations/runtime-compatibility' }, { label: 'GitHub Rulesets', slug: 'integrations/github-rulesets' }, + { label: 'agentrc', slug: 'integrations/agentrc' }, ], }, { diff --git a/docs/src/content/docs/integrations/agentrc.md b/docs/src/content/docs/integrations/agentrc.md new file mode 100644 index 000000000..58f772802 --- /dev/null +++ b/docs/src/content/docs/integrations/agentrc.md @@ -0,0 +1,42 @@ +--- +title: "agentrc" +description: "How APM works with agentrc to distribute AI-generated instructions across teams." +sidebar: + order: 6 +--- + +[agentrc](https://github.com/microsoft/agentrc) analyzes your codebase and generates tailored agent instructions -- architecture, conventions, build commands -- from real code, not templates. + +Use agentrc to author high-quality instructions, then package them with APM to share across your org. + +## How They Work Together + +| Tool | Role | +|------|------| +| **agentrc** | Generates `.instructions.md` files from your actual codebase | +| **APM** | Packages and distributes those instructions across repositories and teams | + +agentrc handles **authoring**. APM handles **distribution and governance**. + +## Shared Format + +The `.instructions.md` format is shared by both tools -- no conversion needed when moving instructions from agentrc into APM packages. Files generated by agentrc can be placed directly into an APM package's primitives directory. + +## Workflow + +```bash +# 1. Use agentrc to generate instructions from your codebase +agentrc generate + +# 2. Add the generated instructions to an APM package +# (place .instructions.md files in your package's .apm/instructions/ directory) + +# 3. Install and distribute via APM +apm install your-org/your-instructions-package +``` + +## Learn More + +- [agentrc repository](https://github.com/microsoft/agentrc) +- [APM Instructions primitive](../../reference/primitive-types/#instructions) +- [Authoring APM packages](../../guides/pack-distribute/)