# Info Architecture

> Propose mechanical file and doc reorg; durable topology belongs to FIRST Documentation. Use when the user types /info-architecture.

- Skill: `blockmatic/info-architecture` (Agent Skill)
- Install (CLI): `npx skillmds@latest add blockmatic/info-architecture`
- Raw SKILL.md: https://api.skillmd.com/api/skills/blockmatic/info-architecture/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: blockmatic (https://skillmd.com/u/blockmatic)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/blockmatic/info-architecture

---


## Purpose and inputs

Improve discoverability of files and docs without discarding information. Durable documentation topology is `/f-info-architect`. Ask before renaming or moving trees.

## Steps

1. Map the current layout against repository file-organization rules and docs MDX. Load `/f-info-architect` if the change is durable IA.
2. Propose groupings, kebab-case names, and shallower trees. Do not invent a second docs hierarchy.
3. Show the proposed moves. Apply only after the user confirms destructive renames.
4. Update imports and cross-references in the same work. Preserve unrelated files.

## Verification

- [ ] Proposed moves follow existing file-organization rules.
- [ ] User confirmed before bulk rename/move.
- [ ] Affected imports or doc links were updated.

## Handoff

Return the proposal or the applied moves. Durable IA decisions still go through `/f-info-architect`.