new-guide

# Guide authoring **Diátaxis determines where information lives. User intent determines how readers enter it.** A reader who does not know any pack or skill names must still be able to begin a real task from the first screen. Create or substantially revise one user-facing documentation surface. Use Diátaxis to determine the page's job. Use conversation-first design to determine what the reader encounters first. ## Prerequisites - Read the actual skills, commands, or workflows the page documents. - Identify one primary reader and one primary job. - Preserve verified commands, permissions, defaults, and side effects. - For generated pages, edit their source data or template — not the rendered output. ## Procedure ### Step 1 — Choose mode **Create** a new guide, or **revise** an existing one. Revise mode applies to substantial changes: restructuring the page's flow, correcting the quadrant, major rewrites, adding conversation-first structure, or auditing for inventory-first writing. Minor edits — a typo fix, a single updated command, a broken link, a version number — are a **normal PR against the existing file**. Stop here and redirect to that path; do not proceed with this skill for minor edits. ### Step 2 — Pick the slug or confirm the file - **Create:** choose a kebab-case slug matching what the reader would have searched for. `rotate-credential-token`, not `how-to-rotate-your-token-step-by-step`. The quadrant subdir carries the "how-to" / "tutorial" framing; ...