Skip to main content

Docs Page Fixer Agent

The Docs Page Fixer is a custom Cursor agent that applies approved documentation drafts from the docs agent queue to the correct source files.

It is the counterpart to the Docs Page Auditor.

Workspace: Full (TechStackMain) · MCP: None

Purpose​

  • Take a reviewed, approved markdown draft and apply it safely.
  • Ensure the correct source-of-truth file is updated (not generated output).
  • Create backups and applied logs for every change.
  • Run basic diagnostics and verify the applied file matches the approved draft.

Source and Configuration​

  • Agent definition: .cursor/agents/docs-page-fixer.md
  • Queue folder: .cursor/plans/docs-agent-queue/

Source-of-Truth Rules (Non-Negotiable)​

The fixer must never edit generated docs under:

  • docusaurus/docs/tools/
  • docusaurus/docs/scripts/

Instead, it maps targets to these source locations:

  • Tool docs → tools/<tool>.md
  • Script docs → scripts/resources/<tool>/README.md (and sibling .md subpages)
  • Custom pages → docusaurus/docs/**/*.md (excluding generated output)

What the Fixer Does​

Given:

  • an approved draft path in .cursor/plans/docs-agent-queue/drafts/, and
  • a target source file path,

the fixer:

  1. Validates source-of-truth.
  2. Creates a backup:
    • .cursor/plans/docs-agent-queue/backups/<YYYY-MM-DD>/<slug>--before.md
  3. Applies the approved draft.
  4. Runs diagnostics (for example, lints).
  5. Verifies draft-vs-target parity.
  6. Writes an applied log:
    • .cursor/plans/docs-agent-queue/applied/<YYYY-MM-DD>/<slug>--applied.md