Docs Plan IA
When to Use This Skill
docs-architect runs this skill after
docs-inventory-surface to decide which pages exist, which Diataxis mode each
page uses and which surface elements each page covers.
Prerequisites
Root steps run the docs helper library at .claude/lib/docs/ under PowerShell 7.4 or later.
Steps
- Call
run_docs_coveragewithworkspace_rootandprofileto list the elements without a documented, excluded or deferred disposition. - Call
run_docs_checkwithworkspace_root,profileand optionallypathsto list the findings on existing pages. - Call
run_docs_inventoryagain only when the surface changed during planning. - Assign each uncovered element to a planned page. Choose the Diataxis mode from
the templates of
docs-author-page: tutorial, how-to, explanation or one of the four reference families. - Give each planned page an owner and an audience from the profile.
Result
Write a ## Information Architecture section into the report with one line per
planned page: its repository-relative path, Diataxis mode, audience, owner and the
element ids it covers.