Skip to content

Add Moyu anti-over-engineering cursor rules#211

Closed
uucz wants to merge 1 commit intoPatrickJS:mainfrom
uucz:add-moyu-anti-over-engineering
Closed

Add Moyu anti-over-engineering cursor rules#211
uucz wants to merge 1 commit intoPatrickJS:mainfrom
uucz:add-moyu-anti-over-engineering

Conversation

@uucz
Copy link
Copy Markdown

@uucz uucz commented Mar 25, 2026

New Rule: Moyu Anti-Over-Engineering

Repository: https://github.com/uucz/moyu

Adds Moyu (摸鱼) to the Other section — an anti-over-engineering ruleset for Cursor.

What it does: Constrains AI from writing unnecessary code through three iron rules:

  1. Only change what was asked
  2. Simplest solution first
  3. When unsure, ask

Includes a grinding-vs-moyu comparison table, pre-delivery checklist, and anti-grinding impulse guide.

Benchmarked: 66% code reduction across 6 real coding tasks. Supports 10 AI coding platforms (Claude Code, Cursor, Codex, Copilot, Windsurf, Cline, Kiro, CodeBuddy, Antigravity, OpenCode).

Summary by CodeRabbit

  • Documentation
    • Added new anti-over-engineering guidelines and coding standards to promote simpler, more efficient code changes and reduce unnecessary complexity in development practices.
Adds Moyu (摸鱼), an anti-over-engineering ruleset that constrains AI from
writing unnecessary code. Three iron rules: only change what was asked,
simplest solution first, ask when unsure. Benchmarked at 66% code reduction.

More info: https://github.com/uucz/moyu
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai bot commented Mar 25, 2026

📝 Walkthrough

Walkthrough

A new rule configuration called "Moyu Anti-Over-Engineering" was added to the repository, comprising a prompt file defining guidelines for minimalist code changes and a corresponding README entry documenting its availability.

Changes

Cohort / File(s) Summary
Moyu Anti-Over-Engineering Rule
README.md, rules/moyu-anti-over-engineering-cursorrules-prompt-file/.cursorrules
Introduced new rule entry documenting anti-over-engineering principles with a prompt file defining assistant behavior for minimal, focused code changes and constraints against unnecessary patterns (over-abstraction, excessive error handling, unsolicited files/tests/docs).

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

Suggested reviewers

  • PatrickJS

Poem

🐰 Behold, the Moyu way is clear,
No fancy tricks nor bloat appear,
Keep changes small and scope in sight,
Simplicity's the golden light!

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'Add Moyu anti-over-engineering cursor rules' directly and clearly summarizes the main change: adding a new cursor rules file for the Moyu anti-over-engineering methodology to the repository.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧹 Nitpick comments (2)
rules/moyu-anti-over-engineering-cursorrules-prompt-file/.cursorrules (2)

51-55: Define the "PUA" acronym for clarity.

The section mentions "PUA" without explanation. Readers unfamiliar with this term won't understand the compatibility claim or what "PUA" is.

📝 Suggested clarification
 ## Works with PUA
 
-PUA fixes laziness (AI does too little). Moyu fixes over-engineering (AI does too much). Install both for best results.
+PUA (Pursue Until Acceptance) fixes laziness (AI does too little). Moyu fixes over-engineering (AI does too much). Install both for best results.

Or provide a brief inline explanation or link to PUA documentation.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@rules/moyu-anti-over-engineering-cursorrules-prompt-file/.cursorrules` around
lines 51 - 55, The term "PUA" in the section "## Works with PUA" is undefined;
update the text around that heading to expand the acronym and/or add a brief
parenthetical definition or a link to PUA documentation so readers know what PUA
stands for and why it complements Moyu—e.g., change "PUA" to "PUA (Programmatic
User Assistance)" or add "(see PUA docs)" after "PUA" in the same paragraph so
the intent is clear.

1-55: Document the "66% code reduction" benchmark methodology.

The PR summary and README claim "Benchmarked: 66% code reduction across 6 real coding tasks," but this file contains no documentation of the benchmark methodology, test cases, or measurement approach. For credibility and reproducibility, include:

  • Which 6 coding tasks were used
  • How code reduction was measured (lines? tokens? complexity?)
  • Comparison baseline (AI without Moyu rules?)
  • Links to benchmark data or results

Consider adding a "Benchmark Results" section to this file or creating a separate BENCHMARK.md in the same directory documenting the methodology and findings.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@rules/moyu-anti-over-engineering-cursorrules-prompt-file/.cursorrules` around
lines 1 - 55, The PR claims "66% code reduction across 6 real coding tasks" but
provides no methodology; add a reproducible Benchmark Results description either
as a new BENCHMARK.md in the same directory or as a "Benchmark Results" section
appended to .cursorrules that lists the six tasks (briefly name each task),
specifies the measurement method (e.g., lines of code and token count and which
tool/command computed tokens), the baseline used (exact model/config or "without
Moyu rules" plus version), the aggregation method (how the 66% was computed),
and links to raw data/results (CSV or gist) and commands to re-run the
measurements; keep the wording short and factual and only touch .cursorrules or
add BENCHMARK.md as the one file change.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Nitpick comments:
In `@rules/moyu-anti-over-engineering-cursorrules-prompt-file/.cursorrules`:
- Around line 51-55: The term "PUA" in the section "## Works with PUA" is
undefined; update the text around that heading to expand the acronym and/or add
a brief parenthetical definition or a link to PUA documentation so readers know
what PUA stands for and why it complements Moyu—e.g., change "PUA" to "PUA
(Programmatic User Assistance)" or add "(see PUA docs)" after "PUA" in the same
paragraph so the intent is clear.
- Around line 1-55: The PR claims "66% code reduction across 6 real coding
tasks" but provides no methodology; add a reproducible Benchmark Results
description either as a new BENCHMARK.md in the same directory or as a
"Benchmark Results" section appended to .cursorrules that lists the six tasks
(briefly name each task), specifies the measurement method (e.g., lines of code
and token count and which tool/command computed tokens), the baseline used
(exact model/config or "without Moyu rules" plus version), the aggregation
method (how the 66% was computed), and links to raw data/results (CSV or gist)
and commands to re-run the measurements; keep the wording short and factual and
only touch .cursorrules or add BENCHMARK.md as the one file change.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: ba403ee8-40d5-4fc6-abf8-d9da4ca56563

📥 Commits

Reviewing files that changed from the base of the PR and between fc2ce04 and af1705b.

📒 Files selected for processing (2)
  • README.md
  • rules/moyu-anti-over-engineering-cursorrules-prompt-file/.cursorrules
@uucz
Copy link
Copy Markdown
Author

uucz commented Mar 31, 2026

Thanks for the review notes @coderabbitai!

Re: PUA — it's NoPUA, a companion project (not an acronym). PUA pushes AI to try harder, Moyu pulls it back from over-engineering. They're complementary.

Re: Benchmark methodology — we've since expanded the benchmark significantly (8 models × 5 conditions × 12 scenarios × 3 trials = 1,440 runs). Full results with methodology, statistical analysis, and interactive charts are published at https://uucz.github.io/moyu/. The key finding: Moyu reduces code output by ~47% (LOC) while maintaining correctness.

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai bot commented Mar 31, 2026

Tip

For best results, initiate chat on the files or code changes.

@uucz, thanks for the detailed context — both clarifications are very helpful!

Re: NoPUA — That context makes perfect sense now. NoPUA addresses the dynamic where fear-based AI prompting leads to unreliable code and production bugs, with its key finding being +104% more hidden issues found. The complementary framing is clear: NoPUA drives thoroughness while Moyu constrains scope. I'll update my knowledge accordingly.

Re: Benchmark — The expanded methodology (8 models × 5 conditions × 12 scenarios × 3 trials = 1,440 runs) with statistical analysis is a meaningful upgrade in rigor. One thing worth flagging: the current README entry still reads "Benchmarked: 66% code reduction", but your updated benchmark reports ~47% LOC reduction. It may be worth updating that figure in the PR to reflect the more recent and robust result, especially since the expanded benchmark is now the authoritative one published at https://uucz.github.io/moyu/.


✏️ Learnings added
Learnt from: uucz
URL: https://github.com/PatrickJS/awesome-cursorrules/pull/211

Timestamp: 2026-03-31T00:50:00.761Z
Learning: In the PR `#211` for PatrickJS/awesome-cursorrules, the reference to "PUA" in the Moyu anti-over-engineering `.cursorrules` file refers to NoPUA (https://github.com/wuji-labs/nopua), a companion project by wuji-labs. NoPUA is a skill that unlocks AI potential through trust/love rather than fear-based prompting. Moyu (restrains over-engineering) and NoPUA (drives thoroughness) are complementary tools from the same ecosystem.

Learnt from: uucz
URL: https://github.com/PatrickJS/awesome-cursorrules/pull/211

Timestamp: 2026-03-31T00:50:00.761Z
Learning: The Moyu anti-over-engineering project (PR `#211`, PatrickJS/awesome-cursorrules) has an expanded benchmark: 8 models × 5 conditions × 12 scenarios × 3 trials = 1,440 runs total. The updated key finding is ~47% LOC reduction (not 66% as stated in the original PR README). Full results with methodology and interactive charts are published at https://uucz.github.io/moyu/. The README entry may need updating to reflect the ~47% figure from the more rigorous benchmark.

Note: Learnings are effective only in the context of similar code segments. To apply general coding guidelines, please configure review instructions. You can manage existing learnings in the app.

@uucz
Copy link
Copy Markdown
Author

uucz commented Apr 1, 2026

Closing in favor of #218 which has the correct .mdc format.

@uucz uucz closed this Apr 1, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

1 participant