Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add rules/zoxknez/ai-coding-rules/74-api-designgit clone --depth 1 https://github.com/zoxknez/ai-coding-rulesWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00000 | $0.00345 |
| Opus 5 | $0.00000 | $0.00172 |
| Sonnet 5 | $0.00000 | $0.00069 |
| Haiku 4.5 | $0.00000 | $0.00034 |
Grade A, and why
74-api-design scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
Copies of this mod
1 near-identical copy found in the catalogue:
- 74-api-design — 100% identical, 0 lines differ
What it actually says
API Design Rules
RESTful Conventions
- GET: Retrieve resources (idempotent)
- POST: Create resources
- PUT: Replace resources (idempotent)
- PATCH: Partial update
- DELETE: Remove resources (idempotent)
URL Design
- Use nouns for resources:
/users,/orders - Use hyphens for readability:
/order-items - Nest for relationships:
/users/:id/orders - Version your API:
/v1/users
Request/Response
// Consistent error shape
interface ApiError {
code: string; // "USER_NOT_FOUND"
message: string; // User-friendly message
details?: unknown; // Additional context
}
// Paginated response
interface PaginatedResponse<T> {
data: T[];
meta: {
total: number;
page: number;
limit: number;
};
}
Status Codes
- 200: Success
- 201: Created
- 204: No Content (DELETE)
- 400: Bad Request (validation)
- 401: Unauthorized (authn)
- 403: Forbidden (authz)
- 404: Not Found
- 422: Unprocessable Entity
- 500: Internal Server Error
Best Practices
- Validate inputs at the boundary
- Use rate limiting
- Add request IDs for tracing
- Document with OpenAPI/Swagger
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 2d ago First seen · 59 lines · 0 tokens per session scan A ab46bc58c363
74-api-design is a cursor rule published in the GitHub repository zoxknez/ai-coding-rules (27 stars, last pushed 4mo ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 345 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other cursor rules, from other repositories
angular-20
This rule provides comprehensive best practices and coding standards for Angular development, focusing on modern TypeScript, standalone components, signals, and performance optimizations.
dev-standard
Apache Superset development standards and guidelines for Cursor IDE.
cli-error-handling
CLI command error handling patterns.
prefer-direct-imports-over-module-mocks
Prefer extracting a testable core over vi.mock / vi.resetModules when unit tests need to reach production logic entangled with config, env, or singletons.
control-plane-descriptors
Control plane descriptor and instance implementation patterns.
family-instance-domain-actions
Family instance domain action implementation patterns.