@microsoft/agentrc 2.0.1-10 → 2.0.1-100

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -18,7 +18,7 @@ AgentRC reads your codebase and generates the files that close that gap — then
18
18
  npx github:microsoft/agentrc
19
19
  ```
20
20
 
21
- Works 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+.
21
+ Works 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 22+.
22
22
 
23
23
  ![AgentRC — Measure, Generate, Maintain cycle](docs/assets/agentrc-overview.png)
24
24
 
@@ -48,6 +48,21 @@ Context goes stale as your codebase evolves. Evaluate whether your instructions
48
48
  npx github:microsoft/agentrc eval
49
49
  ```
50
50
 
51
+ ## AgentRC maintains itself with GitHub Agentic Workflows
52
+
53
+ This repository dogfoods [GitHub Agentic Workflows](https://github.github.com/gh-aw/) for recurring maintenance and demos:
54
+
55
+ | Workflow | Purpose | Output |
56
+ | --------------------------------------------------------------------------- | ------------------------------------------------------------------------- | ------------------------------ |
57
+ | [AgentRC Readiness Report](.github/workflows/agentrc-readiness-report.md) | Runs AgentRC against this repository and explains the highest-impact gaps | One short-lived issue |
58
+ | [AgentRC Readiness Upgrade](.github/workflows/agentrc-readiness-upgrade.md) | Improves one evidence-backed instruction and verifies the result | One draft PR |
59
+ | [Issue Triage](.github/workflows/issue-triage.md) | Classifies new issues and asks for missing information | Bounded labels and one comment |
60
+ | [CI Failure Doctor](.github/workflows/ci-doctor.md) | Diagnoses failed CI from logs and repository changes | One issue or one comment |
61
+
62
+ The source workflows are Markdown. `gh aw compile` generates the reviewable `.lock.yml` workflows that GitHub Actions executes. CI fails when those generated files drift.
63
+
64
+ See [Agentic Workflows](docs/agentic-workflows.md) for the architecture and maintenance commands. Use the [golden demo runbook](docs/agentic-workflows-demo.md) for the lone-maintainer narrative, exact stage flow, and fallback plan.
65
+
51
66
  ## Works at every scale
52
67
 
53
68
  | Workflow | Command |
@@ -71,20 +86,34 @@ Works with **GitHub** and **Azure DevOps**. Supports monorepos, multi-root VS Co
71
86
 
72
87
  > 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).
73
88
 
89
+ ## Works with APM
90
+
91
+ [APM](https://github.com/microsoft/apm) (Agent Package Manager) distributes agent instructions, skills, and prompts across repos — like npm for AI agent configs.
92
+
93
+ AgentRC generates the content. APM distributes it:
94
+
95
+ - **In your project** — run `agentrc init` to generate instructions, then `apm install org/standards` to pull in shared agent packages from your team
96
+ - **For your team** — create a dedicated APM package with your best instructions and skills, then teammates install it with `apm install`
97
+ - **At scale** — `apm audit` scans for security issues; `apm-policy.yml` enforces org standards across all repos
98
+
99
+ The `.instructions.md` format is shared by both tools — no conversion needed when moving instructions into APM packages.
100
+
74
101
  ## Documentation
75
102
 
76
- | | |
77
- | ---------------------------------------------- | ------------------------------------------------------- |
78
- | **[Getting Started](docs/getting-started.md)** | Prerequisites and first run |
79
- | **[Concepts](docs/concepts.md)** | Maturity model, readiness pillars, how generation works |
80
- | **[Commands](docs/commands.md)** | Full CLI reference |
81
- | **[Configuration](docs/configuration.md)** | Areas, workspaces, monorepos |
82
- | **[Policies](docs/policies.md)** | Custom readiness scoring |
83
- | **[At Scale](docs/at-scale.md)** | Batch processing across orgs |
84
- | **[CI Integration](docs/ci-integration.md)** | GitHub Actions & Azure Pipelines |
85
- | **[VS Code Extension](docs/extension.md)** | Sidebar views, commands, settings |
86
- | **[Agent Plugin](plugin/README.md)** | Install as a Copilot agent plugin with built-in skills |
87
- | **[Examples](examples/)** | Configs, evals, and policies |
103
+ | | |
104
+ | -------------------------------------------------- | ------------------------------------------------------- |
105
+ | **[Getting Started](docs/getting-started.md)** | Prerequisites and first run |
106
+ | **[Concepts](docs/concepts.md)** | Maturity model, readiness pillars, how generation works |
107
+ | **[Commands](docs/commands.md)** | Full CLI reference |
108
+ | **[Configuration](docs/configuration.md)** | Areas, workspaces, monorepos |
109
+ | **[Policies](docs/policies.md)** | Custom readiness scoring |
110
+ | **[At Scale](docs/at-scale.md)** | Batch processing across orgs |
111
+ | **[CI Integration](docs/ci-integration.md)** | GitHub Actions & Azure Pipelines |
112
+ | **[VS Code Extension](docs/extension.md)** | Sidebar views, commands, settings |
113
+ | **[Agent Plugin](plugin/README.md)** | Install as a Copilot agent plugin with built-in skills |
114
+ | **[Agentic Workflows](docs/agentic-workflows.md)** | Dogfooding, maintenance, and live demo guide |
115
+ | **[Golden Demo](docs/agentic-workflows-demo.md)** | Lone-maintainer story and stage-ready runbook |
116
+ | **[Examples](examples/)** | Configs, evals, and policies |
88
117
 
89
118
  [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)
90
119