Markdown rules live here (.cursor/rules/), plus languages/ and stacks/. Layout: rules-skills-agents.md. After pack/ is at repo root: ../../PACK.md and ../../ADOPTION_PROFILES.md. Use with root AGENTS.md; do not use .cursorrules.
| Task focus | Start with |
|---|---|
| CI/CD, Dockerfiles, Terraform / Pulumi | cicd-infra.md |
| UI, SVG, icons, responsive layout | frontend-ui.md |
| HTTP APIs, errors, pagination, idempotency | api-design.md |
| Logging, metrics, traces, health | observability.md |
| Tests, coverage, determinism | testing.md |
| Secrets, authz, logging safety | security.md |
| PRs, CI, review scope | pr-review.md |
| General agent chat & collaboration (scope, questions, honesty) | assistant-conduct.md |
| Stack defaults (only if the team agrees) | default-stack.md |
| TypeScript / Python / Go style | languages/README.md → pick languages/<lang>.md |
| Product shape (B2B, B2C, mobile, AI, …) | stacks/README.md → pick one overlay |
| Onboarding / “what bundle fits us?” | stack-bundles.md |
How rules + skills + AGENTS.md relate |
rules-skills-agents.md |
| Auth / infra / DevOps / logging & tracing (what to open, which skills apply) | cross-cutting.md |
| How the agent should chat and collaborate (scope, clarity, safety defaults) | assistant-conduct.md |
| File | Topic |
|---|---|
cicd-infra.md |
Router: CI workflows, container images, IaC — links security, review, testing, observability + skills |
frontend-ui.md |
SVG/icons, responsive UI assets, keyboard/focus, UI XSS hygiene |
languages/README.md |
Language rules (TypeScript, Python, Go); add more languages/<name>.md as needed |
cross-cutting.md |
Authn/authz, infra, DevOps, logging/tracing/events — maps to rules + skills |
assistant-conduct.md |
Default chat/collaboration behavior for agents (scope, questions, honesty, hygiene) |
testing.md |
Coverage expectations, determinism, diagnostics |
security.md |
Secrets, input trust, logging, least privilege |
pr-review.md |
PR scope, description, CI, self-review |
default-stack.md |
Suggested full-stack defaults — confirm with the team before treating as binding |
api-design.md |
HTTP APIs: contracts, errors, pagination, idempotency |
observability.md |
Logs, metrics, traces, health, deploy hygiene |
rules-skills-agents.md |
How .cursor/rules/ (markdown), skills, and AGENTS.md fit together |
stack-bundles.md |
Which rules + skills fit common profiles (onboarding) |
stacks/README.md |
Index of product-shape overlays under stacks/ |
stacks/b2b-saas.md |
B2B SaaS: tenancy, RBAC, integrations, audit |
stacks/b2c-consumer.md |
B2C consumer: identity, growth, abuse at scale |
stacks/c2c-marketplace.md |
C2C marketplace: payments, trust & safety, fraud |
stacks/mobile-apps.md |
Mobile-led: clients, tokens, releases, telemetry |
stacks/ai-apps.md |
AI-native: prompts, tools, evals, cost, vendor risk |
Subfolder stacks/ — optional overlays; see stacks/README.md.
Delete or rewrite files that do not match your stack.