Skip to main content

Cursor Rules Template Download

This feature provides a ready-to-use Cursor workspace rules template as a downloadable ZIP file, generated automatically as part of the Docusaurus build. It is designed for quickly bootstrapping new workspaces with Pacing Agency standards without copying rules by hand.

What It Provides​

  • Downloadable ZIP: cursor-workspace-rules-template.zip served from:
    • /downloads/cursor-workspace-rules-template.zip
  • Unzipped folder name:
    • .cursorrules-EDITABLE
  • Contents inside .cursorrules-EDITABLE:
    • mcp.json – Example MCP configuration for Pacing Docs
    • rules/README.md – Overview of style + documentation rules
    • rules/style/RULE.md – Tone, language, and writing guidelines
    • rules/documentation/RULE.md – How to use the Pacing documentation MCP and avoid duplication

This folder can be dropped into a new repo as a starting point and then customised for that project.

How It Works​

  • Source of truth (version-controlled):
    • Downloadable/Cursor Rules/Cursor Rules TEMPLATE V1/
  • Build script:
    • scripts/build-downloadables.cjs (run from repo root via Docusaurus prebuild)
  • Build output:
    • docusaurus/static/downloads/cursor-workspace-rules-template.zip

On every docs build:

  1. build-downloadables.cjs:
    • Copies the contents of Cursor Rules TEMPLATE V1/ into a temporary .cursorrules-EDITABLE/ folder.
    • Zips that folder into cursor-workspace-rules-template.zip.
  2. Docusaurus serves the ZIP from /downloads/cursor-workspace-rules-template.zip.

This means the download link stays stable, even if the template contents are updated.

Usage​

For Internal Team​

  1. Go to any workspace-setup documentation that references the download, for example:
    • Prompts → Cursor Workspace Setup
  2. Click:
    • Downloadable Cursor workspace rules template (/downloads/cursor-workspace-rules-template.zip)
  3. Unzip the file:
    • You will get a folder named .cursorrules-EDITABLE.
  4. Copy .cursorrules-EDITABLE into the new repository and:
    • Rename or adapt as needed (e.g. convert to Project Rules in .cursor/rules/).
    • Update project-specific details while keeping Pacing-wide standards.

For New Repositories​

Use this template together with:

  • The Cursor New Workspace prompt
  • The Cursor Workspace Setup prompt
  • The Setup New Repo feature

This ensures:

  • Consistent language and tone.
  • Correct usage of the documentation MCP.
  • A predictable starting point for workspace rules across projects.

Implementation Notes​

  • The .tmp-downloadables/ directory used during build is ignored by Git and only exists at build time.
  • The script does not interact with the real .cursor/ directory; it only reads from Downloadable/ and writes to docusaurus/static/downloads/.
  • If the template source directory is missing or renamed, the build script throws a clear error so the docs build fails fast rather than shipping a stale or empty ZIP.