docs-layout

Overview

Use this skill to place documentation in a predictable docs/ structure and choose filenames that communicate document lifecycle. Create folders only when adding the first file; never scaffold empty folders. Naming conventions encode time semantics: phased files for ordered work, dated files for time-anchored events, and flat names for living references.

Placement workflow

1. Identify the document's lifecycle: decision, phased plan, dated report, runbook, handoff, reference, brand asset, or wireframe.
2. Choose the destination from the placement table below.
3. Create only the needed parent folder.
4. Name the file with the convention for that folder.
5. If none of the categories fit, add a domain-specific folder only when it answers a clear lookup question.

Layout

Shared spine — applies to every project: