How to Add Pages

Workflow

1. Choose the destination section: getting-started, commands, or contributing.
2. Create a new Markdown file under docs/<section>/.
3. Add frontmatter:

---
title: Your Page Title
description: One sentence explaining why this page exists.
---

1. Add links from at least one section index or related page.
2. Update sidebar navigation in astro.config.mjs if the page needs top-level visibility.
3. Run validation commands before opening a pull request.

Required Checks

pnpm lint
pnpm validate:links:internal
pnpm validate:a11y

Review Expectations

• Follow Content Style.
• Follow Navigation Rules.
• Use Page Template for new operational pages.

Command Contract Changes

When the CLI adds, removes, or renames a top-level command, keep the canonical command surfaces in sync:

1. Add, remove, or rename docs/commands/<command>.md.
2. Update the command list in docs/commands/index.md.
3. Add the page to coreOrder in scripts/generate-agent-exports.ts when it belongs in the curated command sequence. The generated files under public/ are outputs, not canonical command catalogs.
4. Coordinate the companion skills coverage manifest and cross-repository contract check with the CLI change.
5. Run the complete pnpm validate check before review.