mirror of
https://github.com/azaion/annotations.git
synced 2026-04-22 21:46:30 +00:00
Oleksandr Bezdieniezhnykh
d530c45bf1
- Updated coding standards to emphasize readability, meaningful comments, and maintainability. - Adjusted test coverage thresholds to 75% for business logic and clarified requirements for test scenarios. - Enhanced guidelines for handling skipped tests, emphasizing the need for investigation and resolution. - Introduced a completeness audit for decomposition in research steps to ensure thoroughness in addressing problem dimensions. Made-with: Cursor
40 lines
1.7 KiB
Plaintext
40 lines
1.7 KiB
Plaintext
---
|
|
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
|
|
|
|
## Command Files (.cursor/commands/)
|
|
- Plain markdown, no frontmatter
|
|
- Kebab-case filenames
|
|
|
|
## Agent Files (.cursor/agents/)
|
|
- Must have `name` and `description` in frontmatter
|
|
|
|
## Security
|
|
- All `.cursor/` files must be scanned for hidden Unicode before committing (see cursor-security.mdc)
|
|
|
|
## Quality Thresholds (canonical reference)
|
|
|
|
All rules and skills must reference the single source of truth below. Do NOT restate different numeric thresholds in individual rule or skill files.
|
|
|
|
| Concern | Threshold | Enforcement |
|
|
|---------|-----------|-------------|
|
|
| Test coverage on business logic | 75% | Aim (warn below); 100% on critical paths |
|
|
| Test scenario coverage (vs AC + restrictions) | 75% | Blocking in test-spec Phase 1 and Phase 3 |
|
|
| CI coverage gate | 75% | Fail build below |
|
|
| Lint errors (Critical/High) | 0 | Blocking pre-commit |
|
|
| Code-review auto-fix | Low + Medium (Style/Maint/Perf) + High (Style/Scope) | Critical and Security always escalate |
|
|
|
|
When a skill or rule needs to cite a threshold, link to this table instead of hardcoding a different number.
|