feat: add skills and docs for writing new rules

[rayhanadev]

Why

Documents the process for creating high-quality React Doctor rules.

The guide gives contributors a concrete workflow for moving from rule idea to implementation, evals, PR description, and review follow-up. It uses PR #491 as the reference example for adversarial testing, RDE workflows, detector scoping, and false-positive review.

What changed

• Added docs/HOW_TO_WRITE_A_RULE.md.
• Includes a table of contents and end-to-end rule authoring workflow.
• Documents the two RDE workflows: validating ideas against OSS, and testing implemented rules against OSS.
• Adds examples for detector precision, adversarial tests, AST vocabulary, review triage, and PR structure.
• Adds pre-implementation, pre-PR, and pre-merge checklists.

Test plan

Not run. Docs-only change.

Made with Cursor

---

Note

Low Risk
Documentation-only addition with no changes to lint rules, runtime behavior, or dependencies.

Overview
Adds docs/HOW_TO_WRITE_A_RULE.md, a contributor guide for authoring React Doctor oxlint rules end to end.

The doc walks from defining a one-sentence bug and runtime rationale through research, RDE pre- and post-implementation OSS evals, scoping (syntax / scope- / path-aware detectors), adversarial tests, detector implementation, AST vocabulary, naming and utilities, local verification commands, PR description structure, review triage, checklists, and common failure modes. PR #491 (no-mutating-reducer-state) is the reference example throughout.

No runtime or rule code changes—documentation only.

^{Reviewed by Cursor Bugbot for commit 928ab91. Bugbot is set up for automated code reviews on this repo. Configure here.}

---

[reactreview]

✅ No new issues

^{Reviewed by reactreview for commit 928ab91. Configure here.}

[aidenybai]

bugbot run

[cursor]

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

^{Reviewed by Cursor Bugbot for commit 928ab91. Configure here.}

[devin-ai-integration]

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no bugs or issues to report.