microsoft / microsoft/agentrc

epic: APM integration — make agentrc output distributable and governed

Open
#96 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement
Dominant language
TypeScript
Stars
1.1k
Forks
94
Avg merge
8d 3h
Merged PRs (30d)
7

Description

Why

AI coding agents are only as effective as the context they receive. agentrc solves the creation problem — it analyzes real code and generates tailored instructions. But creation without distribution is a dead end. Teams need to share instructions across repos, govern what agent packages are allowed, and audit them in CI.

APM (Agent Package Manager) solves the distribution problem — transitive dependency resolution, security scanning, multi-platform compilation, and enterprise policy enforcement for agent primitives.

Together: agentrc generates. APM distributes. Neither tool needs the other to be useful, but together they close a loop that neither closes alone.

What

This epic tracks the first wave of agentrc × APM integration:

  1. Readiness scoring — agentrc scores repos on APM adoption (#91)
  2. Init bridgeagentrc init detects APM and offers to set it up (#93)
  3. Cross-documentation — README sections establishing the ecosystem narrative

Key design principles

  • agentrc never writes apm.yml — it delegates to apm init (APM owns its manifest)
  • Formats are compatible by default.instructions.md files work in both tools without conversion
  • Explicit opt-in — APM is suggested, never imposed; --yes skips it entirely
  • Subprocess integration — tools call each other via CLI, respecting the Python/TypeScript boundary

Child issues

  • #91 — feat(readiness): Add APM awareness to ai-tooling pillar → PR #92
  • #93 — feat(init): Bridge to APM during init → PR #94
  • Cross-documentation (README updates) → PR #95

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Review the completed child issues #91 and #93 and their linked PRs #92 and #94, then check the README cross-documentation work in PR #95. The listed first wave is already implemented, so identify any remaining integration scope before starting work on this epic.

Written by the indexing model from the issue text.

Assessment

Tech stack
python, typescript
Domain
developer-experience, documentation, tooling
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
15/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.