Skip to content

[docs] Update documentation for features from 2026-04-01 #524

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
danielmeppiel wants to merge 1 commit into from
Closed

[docs] Update documentation for features from 2026-04-01 #524

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions docs/astro.config.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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' },
],
},
{
Expand Down
42 changes: 42 additions & 0 deletions docs/src/content/docs/integrations/agentrc.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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)
Copy link

Copilot AI Apr 1, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The link to ../../reference/primitive-types/#instructions appears to be a broken anchor: primitive-types.md does not define an #instructions section (it doesn't document primitive-type subsections). Consider linking to the Instructions section in introduction/key-concepts (or another page that actually documents the .instructions.md primitive) so the link resolves correctly.

Suggested change
- [APM Instructions primitive](../../reference/primitive-types/#instructions)
- [APM Instructions primitive](../../introduction/key-concepts/#instructions)

Copilot uses AI. Check for mistakes.
- [Authoring APM packages](../../guides/pack-distribute/)
Loading