Docs Inventory Surface
When to Use This Skill
docs-architect runs this skill to
build the surface inventory and compare it with the persisted snapshot named by
the profile artifact_paths.inventory_snapshot.
Prerequisites
Root steps run Invoke-DocsCommand.ps1 from the docs helper library that the Claude customization push-down delivers, under PowerShell 7.4 or later. Without that library every root step in this skill is unavailable; the docs MCP tools stay available.
Steps
- Call
run_docs_inventorywithworkspace_root,profile, and optionallyanalyzersandrevision(40 or 64 lowercase hexadecimal characters). The tool returns the snapshot in its result and never writes it. - Compare the returned elements with the persisted snapshot: list added, removed and changed element ids.
- When the snapshot must be persisted, report that the root step below is
required; the role does not write the snapshot.
Root step (unavailable without the docs helper library):
Invoke-DocsCommand.ps1 -Command inventory -Profile docs/documentation-estate/docs-profile.json -Write
Result
Report the snapshot path, the element counts by kind and the element ids that changed.