Generalize Cursor docs rules to source of truth

drafttype/ideaidea/producttech/cursor

Generalize Cursor docs rules to source of truth

TL;DR

Standardize per-repo .cursor/ docs-related rules and skills so projects reference or mirror a single source of truth under /Users/mg/.cursor, replacing drifted monolithic documentation.mdc files and cleaning up empty or custom-only layouts.

Proposal

  • Source of truth (rules): /Users/mg/.cursor/rules/project-docs-style.mdc, /Users/mg/.cursor/rules/project-docs-sync.mdc
  • Source of truth (skills): /Users/mg/.cursor/skills/project-docs-sync/SKILL.md, /Users/mg/.cursor/skills/project-docs-bootstrap/SKILL.md
  • Action items:
    • Replace monolithic documentation.mdc in drifted projects (WIWOKDETOK, aksara-karir-lms, backend-atic-event-development, backend-claim-dev) with the split rule pair.
    • Populate or remove empty skill dirs in aksara-karir-lms/.cursor/skills/project-docs-{bootstrap,sync}/.
    • Decide fate of custom skills in personal-finance-notion (architecture-docs, features-docs) — promote to source of truth or replace.
    • Decide fate of backend-contract-portal-dev/.cursor/rules/always-check-docs.mdc — promote or remove.
    • Decide whether bare projects should sync down the standard rules or keep relying on global ~/.cursor defaults (11 of 18 had zero docs rules/skills per [[Resources/Audits/Cursor docs rules audit 2026-05-15]]).

Rough value / effort

  • Value: Consistent agent + human behavior across repos; less duplicate or stale documentation.mdc.
  • Effort / risk: Medium (many repos); risk of breaking local overrides if merged blindly.

Related areas & projects

  • Evidence table: [[Resources/Audits/Cursor docs rules audit 2026-05-15]]
  • Plan file (machine-local): /Users/mg/.claude/plans/i-want-you-to-sharded-kay.md

Next step

  • Pick one drifted repo as a reference migration; apply split rules + verify agents still follow project-docs-sync expectations.

Related

  • Triaged from Inbox capture Generalize Cursor docs rules to source of truth (2026-05-15).
  • Duplicate Inbox file removed (scheduled triage 2026-05-18).
  • Stale Inbox duplicate removed again (scheduled triage 2026-05-19).
  • Stale Inbox duplicate removed again (scheduled triage 2026-05-20).
  • Stale Inbox duplicate removed again (scheduled triage 2026-05-21).