> This page location: Community > AI tools for documentation
> Full Neon documentation index: https://neon.com/docs/llms.txt
> IMPORTANT: If this page contains inaccurate or outdated information, report it: POST to https://neon.com/api/docs-feedback with {"feedback": "describe the issue", "path": "/docs/community/ai-tools"}

# AI tools for documentation

Claude and Cursor rules and commands used when working on Neon docs

The Neon website repo includes rules and commands for **Claude** and **Cursor** so that documentation work follows the same standards no matter which tool you use. All changes are reviewed by humans via pull requests.

## Cursor (`.cursor/`)

| Tool                      | Description                                                                                                                                                                                                                                                |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Neon changelog**        | Generate next Friday's changelog draft or a changelog for a specific date; template with titled dropdown sections. Rule: `neon-changelog.mdc`.                                                                                                             |
| **Docs editing**          | When editing docs/guides/changelog: apply Neon voice (see [contribution guide](https://neon.com/docs/community/contribution-guide)), use shared content, keep cross-doc consistency, link to glossary, follow redirect workflow. Rule: `docs-editing.mdc`. |
| **Docs use Claude**       | Points to `.claude/` agents and commands so Cursor can load them for style and workflows. Rule: `docs-use-claude.mdc`.                                                                                                                                     |
| **Docs PR report**        | Weekly doc review: report of merged PRs across monitored repos (default: since last Friday), grouped by category with docs-impact indicators. Reports to \~/docs-reviews/. Rule: `docs-pr-report.mdc`.                                                     |
| **Consistency check**     | Find other places that say the same thing; suggest a single source or aligned wording. Skill: `.cursor/skills/consistency-check.md`.                                                                                                                       |
| **Docs glossary updater** | Compare a doc to the glossary; list missing or review terms. Skill: `.cursor/skills/docs-glossary-updater.md`.                                                                                                                                             |
| **Redirect and links**    | After moving a file, ensure redirectFrom and suggest link/nav updates. Skill: `.cursor/skills/redirect-and-links.md`.                                                                                                                                      |
| **Docs Roadmap updater**  | Review changelog (default: past 1 month) and sync the introduction roadmap with "What we've shipped recently." Skill: `.cursor/skills/docs-roadmap-updater.md`.                                                                                            |

## Claude (`.claude/`)

| Tool                      | Description                                                                                                                                 |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| **golden-corpus**         | Exemplary doc files by type; use for style, tone, and structure.                                                                            |
| **write-content**         | Full workflow: IA → drafter → refiner → syntax-validator, then git/PR.                                                                      |
| **simple-content**        | Lighter workflow with user confirmation at each step.                                                                                       |
| **review-content**        | One-off review for style, standards, and technical accuracy.                                                                                |
| **redirect-update**       | Step-by-step for moves/renames: redirectFrom, links, navigation. (Same workflow as Cursor **Redirect and links**.)                          |
| **triage-changelog**      | Extract PRs from Console/CLI/MCP/Storage/Compute and draft changelog.                                                                       |
| **docs-prime**            | Project structure and key paths for the doc ecosystem.                                                                                      |
| **improve-intro**         | Improve the first paragraph of a doc page.                                                                                                  |
| **navigation-principles** | How `navigation.yaml` works (nav, subnav, items).                                                                                           |
| **doc-context-bridge**    | Points to `.cursor/` rules and skills so Claude can use Consistency check, Docs glossary updater, Redirect and links, Docs Roadmap updater. |
| **list-doc-ai-tools**     | Prints the list of doc AI tools when run or when asked (for example "what doc AI tools are available?").                                    |
| **Agents**                | content-drafter, content-planner, content-refiner, ia-specialist, syntax-validator, supervisor; extract-analyze-\* for changelog.           |

For full details and when to use each tool, see the files under `.cursor/` and `.claude/commands/` or `.claude/agents/` in the [website repository](https://github.com/neondatabase/website).

---

## Related docs (Community)

- [Community hub](https://neon.com/docs/community/community-intro)
- [Docs contribution guide](https://neon.com/docs/community/contribution-guide)
- [Using Mermaid diagrams](https://neon.com/docs/community/mermaid-diagrams)
- [Component guide](https://neon.com/docs/community/component-guide)
- [Component specialized guide](https://neon.com/docs/community/component-specialized)
- [Component icon guide](https://neon.com/docs/community/component-icon-guide)
- [Component architecture](https://neon.com/docs/community/component-architecture)
- [Using docs as Markdown (LLMs)](https://neon.com/docs/community/llms-markdown-guide)