# Docs Corpus Audit

Use this skill to run a holistic regrounding pass on the entire microsoft/apm...

- Repository: https://github.com/microsoft/apm (4171 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-10-30
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add microsoft/apm --skill docs-corpus-audit -g -a claude-code -y`
Codex: `npx skills add microsoft/apm --skill docs-corpus-audit -g -a codex -y`
Cursor: `npx skills add microsoft/apm --skill docs-corpus-audit -g -a cursor -y`
Gemini CLI: `npx skills add microsoft/apm --skill docs-corpus-audit -g -a gemini-cli -y`

## Description

Use this skill to run a holistic regrounding pass on the entire microsoft/apm documentation corpus against current source code, page-by-page, and emit surgical fixes for stale claims. Activate when the maintainer wants a WHOLE-CORPUS audit (not per-PR review) -- typical triggers include "audit the docs", "reground the corpus", "check every page against code", "pre-release docs sweep", "the docs have drifted everywhere", or "we just reshaped the TOC, find dead links". Wave-batched and S7-verified; scales to the full ~112-page corpus in ~10 minutes wall-time. This is a SIBLING to docs-sync, not a replacement: docs-sync is per-PR (triggered by a diff); this skill is per-corpus (triggered by a maintainer ask). They share agent personas, schemas, and the docs index, but their triggers MUST NOT collide. Does NOT auto-merge, does NOT push without maintainer review, and does NOT replace per-PR drift detection.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# docs-corpus-audit -- whole-corpus regrounding pass

The docs corpus drifts silently between releases. `docs-sync` catches
drift introduced by individual PRs at PR-open time. This skill catches
the **accumulated** drift that slips past per-PR review -- stale flag
names, dead nav links from past IA reshuffles, deprecation banners
that outlived their version targets, factual claims whose source-side
truth has moved.

The pattern is **A1 PANEL + WAVE EXECUTION + S7 DETERMINISTIC TOOL
BRIDGE + A8 ALIGNMENT LOOP + A9 SUPERVISED EXECUTION**. The corpus is
split into disjoint page scopes; one verifier subagent owns each
scope; agents extract factual claims, S7-verify against source, apply
surgical fixes inline. The orchestrator then runs an alignment-loop
pass to re-verify that applied edits actually ground out true.

This skill is ADVISORY but ACTIONABLE: agents apply edits inline on a
working branch. The orchestrator is the sole writer to git -- stages,
commits, pushes. Maintainer reviews the resulting PR.

## Sibling contract with docs-sync

These two skills share substrate. Be explicit:

| Shared resource | Owner | Both use |
|---|---|---|
| `.apm/docs-index.yml` (corpus map) | docs-sync | yes |
| [doc-writer](../../../.apm/agents/doc-writer.agent.md) persona | shared | yes (per-page edits) |
| [python-architect](../../../.apm/agents/python-architect.agent.md) persona | shared | yes (S7 verification) |
| [editorial-owner](../../../.apm/agents/editorial-owner.agent.md) persona | shared | optional (voice pass at scale) |
| [cdo](../../../.apm/agents/cdo.agent.md) persona | shared | yes (final synthesis) |
| `assets/panelist-return-schema.json` | docs-sync (mirrored) | yes |

**Trigger boundary (avoid DISPATCH COLLISION):**

The rest: https://github.com/microsoft/apm/blob/HEAD/.agents/skills/docs-corpus-audit/SKILL.md