Cursor rule

1---
2description: "Master index of all available rules - consult when planning multi-step tasks, working with unfamiliar parts of the codebase, or when no language-specific file is open. Lists per-stack router files and pattern rules."
3tags: ["discovery", "routing", "catalog"]
4relatedRules: ["QUICK_START.mdc", "README.md"]
5---
6 
7# Rule Index
8 
9Use this index when you need to discover which rules exist for a given stack or topic. Each **router** file is the table of contents for that stack; read the router first, then the specific rule files it points to.
10 
11## Quick Decision Tree
12 
13- Need first-run guidance or fast navigation? -> `QUICK_START.mdc`
14- Need stack-specific implementation guidance? -> open the matching stack router below
15- Need cross-cutting concepts (testing/security/architecture)? -> use `patterns/*`
16- Need workflow/process guidance (TDD/review/onboarding)? -> use `development/*`
17 
18## Always-Applied Rules (in every context)
19 
20| File | Purpose |
21|------|---------|
22| `agent-behavior.mdc` | Persona, Never Assume, Rule Flagging; links to workflow/TDD/docs |
23| `project-context.mdc` | Project-specific routing: active stacks, directory→router mapping, key deps; generated by onboarding |
24 
25**Agent-requestable (request when needed):** `retrospective.mdc` (end-of-task review, rule gaps, IMPROVEMENTS.md). See agent-behavior.mdc "See also".
26 
27## Per-Stack Routers (glob-activated; read when working in that stack)
28 
29Each stack has **one router** that loads when matching files are open. All other rules in that stack are agent-requestable — the router lists them by task; load the 2–3 relevant to the current sub-task.
30 
31| Stack | Router File | When to Use |
32|-------|-------------|-------------|
33| **AWS Lambda / Node.js** | `languages/aws-lambda/nodejs-lambda.mdc` | Lambda functions, CDK, DynamoDB, SQS, SNS, API Gateway |
34| **Node.js / TypeScript (base)** | `languages/nodejs/nodejs-base.mdc` | Express, Fastify, NestJS, Hono; non-Lambda TS backends |
35| **Java / Spring Boot** | `languages/java/java-spring.mdc` | Spring Boot 3, JPA, Spring Security, Resilience4j |
36| **C# / .NET** | `languages/csharp/csharp-dotnet.mdc` | ASP.NET Core, EF Core, FluentValidation, Polly, Rebus |
37| **React / TypeScript** | `languages/react/react-frontend.mdc` | React 18+, TanStack Query, React Router v7, Tailwind |
38 
39## Agent-Requestable Pattern & Workflow Rules
40 
41| File | Topic |
42|------|--------|
43| `patterns/architecture.mdc` | Clean Architecture, Vertical Slice, CQRS, DDD, SOLID |
44| `patterns/clean-code.mdc` | Index to clean-code sub-rules (naming, functions, design, hygiene) |
45| `patterns/clean-code-naming.mdc` | Naming, vocabulary, abbreviations, negated booleans |
46| `patterns/clean-code-functions.mdc` | Method params, guard clauses, abstraction levels, cognitive load |
47| `patterns/clean-code-design.mdc` | Side effects, immutability, Law of Demeter, composition, dependencies |
48| `patterns/clean-code-hygiene.mdc` | Dead code, magic numbers, comments, fail fast, Rule of Three |
49| `patterns/error-handling.mdc` | Result pattern, RFC 7807 ProblemDetails |
50| `patterns/testing.mdc` | TDD, AAA, test categories, mocking |
51| `patterns/security.mdc` | Secrets, HTTPS, CORS, headers, RBAC |
52| `patterns/api-design.mdc` | REST, HTTP methods, status codes, versioning |
53| `patterns/input-sanitization.mdc` | Validation vs sanitization, SQL/XSS/path traversal |
54| `patterns/cqrs.mdc` | Command/Query separation, pipeline behaviors |
55| `development/tdd-workflow.mdc` | TDD Red/Green/Refactor mandate, escape clause |
56| `development/tdd-planning.mdc` | Test scenario specification, Method_WhenCondition_ShouldResult |
57| `development/code-implementation.mdc` | Pre-work, TDD cycle, Definition of Done, summary format |
58| `development/code-review.mdc` | Code review loop, DoD table, checklist |
59| `development/project-onboarding.mdc` | Analyze repo, detect stacks, map dirs→routers, generate project-context.mdc |
60| `development/context7-docs.mdc` | Context7 MCP — resolve-library-id, get-library-docs |
61| `retrospective.mdc` | End-of-task review, rule gaps, IMPROVEMENTS.md |
62 
63## How to Use
64 
651. **Before implementation:** Always consult the **stack router** for the stack you are working in (see table above). The router is the only glob-loaded rule for that stack; it lists every language-specific rule by task type. Load the 2–3 rules relevant to your current sub-task.
662. **Planning or unfamiliar codebase:** Read this index, then the router for that stack; request the rule files the router points to for your task.
673. **Cross-cutting concept:** Use the pattern or development rules above; request by name when needed.
68 
69## Most Common Workflows
70 
71- API endpoint work: router -> `languages/*/controllers.mdc`, `languages/*/validation.mdc`, `languages/*/error-handling.mdc`
72- Testing work: router `languages/*/testing.mdc` + `patterns/testing.mdc` + `development/tdd-workflow.mdc`
73- Security work: router `languages/*/security.mdc` + `languages/*/input-sanitization.mdc` (+ `languages/*/auth.mdc` if applicable)
74- Large unfamiliar project: `development/project-onboarding.mdc` -> refresh `project-context.mdc` -> router
75 
76**Activation model:** Always-applied: `agent-behavior.mdc`, `project-context.mdc`. Only the five stack routers are glob-activated. All other language-specific rules and all pattern/development rules are agent-requestable — load them on demand via the router or by name to keep context under ~15k–20k tokens per task.
77 
78**See also:** `QUICK_START.mdc`, `README.md` in this folder for full activation model and token budget.
79