---
paths:
  - "docs/**"
  - "**/*.md"
  - "**/*.mdx"
---

# Documentation Rules

## Markdown
- Use ATX-style headings (`#`, `##`, `###`).
- Keep documentation lines wrapped at 100 characters or fewer when practical.
- Use relative links for intra-repo references.
- Prefer descriptive link text instead of bare URLs.

## Maintenance
- Update relevant docs when modifying features or workflows.
- Run `npm test` and `npm run build` after documentation updates when practical.