| name | follow-workspace-rules |
| description | Aligns code with this repository's Cursor rules in `.cursor/rules/` (layered architecture, naming, styling, performance, anti-patterns). Use when implementing or refactoring features, reviewing diffs, fixing lint or convention issues, or when the user asks to follow project standards, workspace rules, or AGENTS.md. Use when this capability is needed. |
| metadata | {"author":"andraderaul"} |
Follow workspace rules
Source of truth
Project conventions live in .cursor/rules/*.mdc (always applied in Cursor). Do not rely on memory alone—open and follow the relevant .mdc file when the task touches that area.
Also heed AGENTS.md (Next.js: consult node_modules/next/dist/docs/ before using framework APIs you are unsure about).
Rule map (what to read when)
| File | Use when |
|---|
architecture.mdc | Deciding where new code belongs; import direction (App → Features → Lib/Components); feature public API via index.ts |
layers.mdc | Placing or reviewing code under src/app/, src/features/, src/components/, or src/lib/ |
naming.mdc | New files, folders, hooks, services, tests |
styling.mdc | Tailwind/cn(), NavLink, design tokens, globals.css utilities |
anti-patterns.mdc | Quick pass for common violations (duplicate link styling, wrong layer imports, hook misuse, etc.) |
performance.mdc | State placement, lists, memoization, context providers |
Repo path (for search/open): .cursor/rules/<file>.
Workflow
- Classify the change: Which layers and files are involved (
app, features, components, lib)?
- Pull in rules: At minimum, skim
architecture.mdc + layers.mdc for anything that adds imports or new modules. Add styling.mdc for UI; naming.mdc for new files; performance.mdc when changing state, context, or large lists.
- Implement so that:
- Dependency flow matches the architecture table (no upward imports; no feature-to-feature imports;
lib stays free of feature/component imports).
- UI matches styling rules (
NavLink for links, cn() for conditional classes, tokens from tailwind.config.js / globals—not ad-hoc patterns that break safelisting).
- Before finishing: Re-read
anti-patterns.mdc for a fast sanity check on the touched surface.
Conflict resolution
If a suggestion conflicts with .cursor/rules, the rules win. If two rules seem to conflict, prefer architecture / layers for structure, then styling and anti-patterns for UI and React habits.
Relation to other project skills
ui-design-review focuses on visual quality and hierarchy; this skill covers repository-wide conventions (layers, naming, Tailwind/NavLink rules, performance guardrails). Use both when polishing UI that must also match project standards.
Source: andraderaul/random-fy — distributed by TomeVault.
