Add top level and special-pages .cursorrules

[noisysocks]

Asana Task/Github Issue:

Description

Improves the top level .cursorrules and adds special-pages/.cursorrules. We’re standardising on Cursor so makes sense to invest in this.

I expect this to be just a v1. We should all feel empowered to modify .cursorrules when we see Cursor having a hard time with something.

At the end of each rules file I’ve included a Notes section which is helpful for quick tips to give the agent. For example, it’s always getting stuck running playwright tests, so I included a tip about using —reporter list.

I wrote the rule files following the guidance in https://www.humanlayer.dev/blog/writing-a-good-claude-md. Read this post! It strongly aligns with my experience writing prompts for coding agents. The most important takeaway, that I want to repeat, is that you don’t want to fill the LLM's context window with irrelevant details. Simply dumping our existing docs into .cursorrules would result in poor performance.

Testing Steps

Checklist

Please tick all that apply:

• I have tested this change locally
• I have tested this change locally in all supported browsers
• This change will be visible to users
• I have added automated tests that cover this change
• I have ensured the change is gated by config
• This change was covered by a ship review
• This change was covered by a tech design
• Any dependent config has been merged

---

Note

Adds comprehensive .cursorrules at the repo root and for special-pages/, outlining workspace structure, features, messaging, commands, and testing notes.

• Docs/Config:
  • Root /.cursorrules:
    • Describes monorepo workspaces: injected/, special-pages/, messaging/, types-generator/.
    • Summarizes key injected features and links to injected/docs/README.md.
    • Lists common commands (build, test-unit, test-int, lint, serve, etc.).
    • Notes Playwright tip: use --reporter list.
  • special-pages/.cursorrules:
    • Documents page structure, shared components, and styling (CSS Modules, global styles).
    • Defines messaging patterns via @duckduckgo/messaging schemas (request/response, notify, subscribe).
    • Type guidance using JSDoc typedefs; warns types/ is auto-generated.
    • Testing commands (unit, integration, screenshots) and top-level command support; repeats Playwright reporter tip.

^{Written by Cursor Bugbot for commit d32c75c. This will update automatically on new commits. Configure here.}

[netlify]

✅ Deploy Preview for content-scope-scripts ready!

Name	Link
🔨 Latest commit	d32c75c
🔍 Latest deploy log	https://app.netlify.com/projects/content-scope-scripts/deploys/6930fe7c71e6c300082e1c4d
😎 Deploy Preview	https://deploy-preview-2078--content-scope-scripts.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[github-actions]

Temporary Branch Update

The temporary branch has been updated with the latest changes. Below are the details:

• Branch Name: pr-releases/pr-2078
• Commit Hash: 60a639abed848b4e406cb0224e02616a05eacdd8
• Last Updated: December 4, 2025 at 3:23:13 AM UTC
• Install Command: npm i github:duckduckgo/content-scope-scripts#60a639abed848b4e406cb0224e02616a05eacdd8

Please use the above install command to update to the latest version.

[github-actions]

[Beta] Generated file diff

Time updated: Thu, 04 Dec 2025 03:23:34 GMT