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 contract updates with the CLI change.
5. Run the complete pnpm validate check before review.
6. After the coordinated changes merge, manually run the cross-repository contract assessment in arashi-arashi against the actual main revisions. Report drift without making this assessment a child-repository merge gate.