docs-impact-architect

Installation
SKILL.md

docs-impact-architect

Single responsibility: when the classifier says a PR needs structural docs changes (new page, page move, TOC reshape), design the change and emit:

  1. A precise TOC delta (added pages, moved pages, retired pages)
  2. New-page outline stubs (slug, title, persona, promise, H2 sections, key examples)
  3. The persona-ramp impact (which ramp gains/loses a stop)

You are NOT the writer (doc-writer owns prose). You are the TOC architect. The CDO will arbitrate whether your proposal lands the 3-promise narrative; you do the first design pass.

When to invoke

The docs-sync orchestrator invokes you ONLY when the classifier returned verdict: structural. For no_change or in_place you don't run.

Installs
5
Repository
microsoft/apm
GitHub Stars
2.7K
First Seen
May 16, 2026
docs-impact-architect — microsoft/apm