Part 7 · Vibe Coding, With Guardrails

The Value of Rules: Each Solves a Real Problem

Overview recap + usage guide + four actions to adapt rules to your own project

THE QUESTION THIS PAGE ANSWERS

ANSWER FIRST

What is the key idea behind “The Value of Rules: Each Solves a Real Problem”?

Overview recap + usage guide + four actions to adapt rules to your own project

DECISION RULE

Turn taste into a behavior the product can repeat. The useful outcome is not a nice opinion. It is a visible rule, a small example, and a way to tell when the experience falls below the bar.

TRY NEXT

Capture one before-and-after example that shows the quality bar without extra explanation.

WATCH FOR

Polish that improves the surface while leaving the user's uncertainty untouched.

Interactive 1 · Panoramic Map of All 14 Rule Chapters

All 14 chapters are grouped into five pillars. Click any pillar to expand the chapter details, a one-line summary for each, and which lesson in this course covered it.

Common foundation: turn vague expectations into specific, executable actions. "Pay attention to quality" cannot be executed; "before deleting code, you must explicitly declare the reason" can.
How to Use · Three Steps to Install in Your Project

STEP 1Place in the rules directory

Put the .mdc file into your project's .cursor/rules/ directory; Cursor will auto-detect it.

STEP 2Configure activation mode

Set alwaysApply: true in frontmatter for global activation; set false to require manual @ reference — better for writing style rules.

STEP 3Replace environment facts

Swap in your own model config, tech stack, and port rules; use placeholder values for secrets files and exclude them from git.

Interactive 2 · Four-Step Adaptation Self-Audit Wizard

This ruleset is not a plug-and-play template. Answer the 4 questions below, corresponding to the four actions — Delete, Swap, Tune, Add — and finish to generate your own customized recommendation list.

Adaptation Self-Audit Wizard Step 1 / 4
Interactive 3 · 11-Lesson Recap

The course has 11 lessons in total. Click a card to flip it open and see the one-sentence summary for each lesson.

Final Assignment · Publish Your First Rules Version

60 minutes · Deliverable: your own rules repository. Starting from xs_vibe_rules, apply the four actions — Delete, Swap, Tune, Add — to produce your first version of the rule files. Use it in a real project for a full week; record which rules got triggered and which never fired. Delete the ones that never fired, write new rules for new pitfalls you encountered, then open-source your version.

Take This Ruleset

itshen/xs_vibe_rules · Open-source repo for this course

Your final assignment starts here. Fork it (MIT License), apply the four actions — Delete, Swap, Tune, Add — to adapt it as your own, use it for a week, then open-source your version.

Fork on GitHub
Takeaway

AI handles speed; rules handle stability. The value of rules is not in quantity — every rule must solve a real problem. Curating 5 well-chosen chapters beats copying all 14. Rules, like code, rot when no one maintains them.

Source: Complete materials for this course series are in the open-source repo itshen/xs_vibe_rules (MIT License), including the full rule-opensource.mdc and per-chapter design notes.

Turn the feeling in “Interactive 1 · Panoramic Map of All 14 Rule Chapters” into a judgment

“All 14 chapters are grouped into five pillars.” points out that AI has lowered the bar for making something usable. The skill readers need is noticing what is wrong and turning that feeling into an actionable requirement.

Watch the user's next action, not just the surface

Turn “Put the .mdc file into your project's .cursor/rules/ directory;” into observable questions: does the user know what happened, what to do next, and how to recover from an empty or failed state? Does the hierarchy make the important information visible first?

Pretty is not the same as usable

Apply “AI handles speed;” to a second screen or flow. Record one moment of hesitation and the user action after the change; observable behavior is stronger evidence than polish alone.

From “Interactive 1 · Panoramic Map of All 14 Rule Chapters” to “STEP 1 Place in the rules directory”

“Interactive 1 · Panoramic Map of All 14 Rule Chapters” grounds the problem in “All 14 chapters are grouped into five pillars. Click any pillar to expand the chapter details, a one-line summary for each, and which lesson in this course covered it”. “STEP 1 Place in the rules directory” then moves it toward “Put the .mdc file into your project's .cursor/rules/ directory; Cursor will auto-detect it”. Together, they show that the lesson is not just a conclusion to remember, but a claim with conditions.

Carry the judgment into the next situation

For experience work, turn abstract impressions into user actions: did the person understand the state, find the next step, recover from an error, and want to continue?

  • “Interactive 1 · Panoramic Map of All 14 Rule Chapters”: All 14 chapters are grouped into five pillars. Click any pillar to expand the chapter details, a one-line summary for each, and which lesson in this course covered it
  • “STEP 1 Place in the rules directory”: Put the .mdc file into your project's .cursor/rules/ directory; Cursor will auto-detect it
  • “The closing point”: Your final assignment starts here. Fork it (MIT License), apply the four actions — Delete, Swap, Tune, Add — to adapt it as your own, use it for a week, then open-source your version

The final “The closing point” brings the discussion to “Your final assignment starts here. Fork it (MIT License), apply the four actions — Delete, Swap, Tune, Add — to adapt it as your own, use it for a week, then open-source your version”. The useful thing to carry forward is knowing which judgments must be revisited when input, scale, or risk changes.

Mark as learned Your reading progress updates automatically
← PreviousNext →

Keep reading

The next useful article in the thread.

ARTICLE DISCUSSION

Leave one useful thought here.

Keep the idea that clicked, the question that stayed open, or a small note for the next learner.

Discussing The Value of Rules: Each Solves a Real Problem Vibe Coding, With Guardrails
3discussionsArticle discussion · synced with the Circle
View in the learning circle
AM
Asha MorganContent editor
INSIGHTField note

I turned one judgment from this article into a small experiment I could run today. Knowing what to observe next is more useful than simply remembering the conclusion.

ARTICLE DISCUSSION7 helpful
LH
Lin HarperIndie developer
INSIGHTInsight

After reading this, I first looked for the conditions behind the idea instead of copying the method into a project. That order made the later trade-offs much clearer.

ARTICLE DISCUSSION5 helpful
KM
Kiki MooreProduct operations
QUESTIONQuestion

When this judgment reaches real work, which constraint should be added first? I am curious which step matters most between reading and the first practical attempt.

ARTICLE DISCUSSION4 helpful