# Docs Plan Ia

> Plan the documentation information architecture: pages, Diataxis modes, audiences and owners. Use after the surface inventory, before any page is written.

- Skill: `drmoisan/docs-plan-ia` (Agent Skill)
- Install (CLI): `npx get-skill add drmoisan/docs-plan-ia`
- Raw SKILL.md: https://api.skillmd.com/api/skills/drmoisan/docs-plan-ia/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: drmoisan (https://skillmd.com/u/drmoisan)
- Updated: 2026-11-15
- Page: https://skillmd.com/skills/drmoisan/docs-plan-ia

---


# Docs Plan IA

## When to Use This Skill

[docs-architect](../../../.codex/agents/docs-architect.toml) 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 `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

1. Call `run_docs_coverage` with `workspace_root` and `profile` to list the
   elements without a documented, excluded or deferred disposition.
2. Call `run_docs_check` with `workspace_root`, `profile` and optionally `paths`
   to list the findings on existing pages.
3. Call `run_docs_inventory` again only when the surface changed during planning.
4. 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.
5. 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.

