---
description: "Enforces naming, frontmatter, and organization standards for all .cursor/ configuration files"
globs: [".cursor/**"]
---
# .cursor/ Configuration Standards

## Rule Files (.cursor/rules/)
- Kebab-case filenames, `.mdc` extension
- Must have YAML frontmatter with `description` + either `alwaysApply` or `globs`
- Keep under 500 lines; split large rules into multiple focused files

## Skill Files (.cursor/skills/*/SKILL.md)
- Must have `name` and `description` in frontmatter
- Body under 500 lines; use `references/` directory for overflow content
- Templates live under their skill's `templates/` directory

## Agent Files (.cursor/agents/)
- Must have `name` and `description` in frontmatter

## _docs/ Directory Numbering Convention
| Prefix | Content |
|--------|---------|
| `00_` | Problem definition, research artifacts |
| `01_` | Solution drafts |
| `02_` | Documentation, tasks |
| `03_` | Implementation reports |
| `04_` | Deploy, refactoring |
| `05_` | Security audit |
| `06_` | Metrics / retrospective |

## Quality Thresholds (project-wide)
| Metric | Target | Used by |
|--------|--------|---------|
| Test coverage (black-box) | >= 70% of acceptance criteria | test-spec |
| Test coverage (refactor safety net) | >= 75% line, 90% critical paths | refactor |
| CI pipeline coverage gate | >= 75% | deploy |

## Work Item Tracker
Skills reference Jira MCP by default. Azure DevOps MCP is an equal alternative. The autopilot protocols handle authentication for whichever is configured.

## Security
- All `.cursor/` files must be scanned for hidden Unicode before committing (see cursor-security.mdc)