Skip to content

fix(rules): re-verify CUR-* rules against current Cursor docs #571

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
avifenesh merged 8 commits into from
Feb 26, 2026
Merged

fix(rules): re-verify CUR-* rules against current Cursor docs #571

Show file tree
Hide file tree
Changes from 6 commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
7eb59cb
docs(rules): re-verify CUR-001 to CUR-016 against current Cursor docs
avifenesh Feb 26, 2026
2669d1f
fix(rules): update CUR-016 environment.json validation to match curre…
avifenesh Feb 26, 2026
d86ab36
fix: clean up AI slop
avifenesh Feb 26, 2026
605f9a0
fix(rules): address review findings for CUR-016 validation
avifenesh Feb 26, 2026
4d89839
fix(locales): sync locale files and remove stale CUR-016 keys
avifenesh Feb 26, 2026
72cb3a3
docs: sync documentation with CUR-016 schema changes
avifenesh Feb 26, 2026
b6e4122
style: apply rustfmt formatting
avifenesh Feb 26, 2026
6b514cf
fix: populate spec-baseline hashes for new Cursor sources
avifenesh Feb 26, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 16 additions & 1 deletion .github/spec-baselines.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,22 @@
"cursor-rules": {
"url": "https://cursor.com/docs/context/rules",
"hash": "24529507938b37d3e3815e86b8c1c87cbaf78230c899854f0d74b2d5356c676a",
"rules": ["CUR-001", "CUR-002", "CUR-003", "CUR-004", "CUR-005", "CUR-006"]
"rules": ["CUR-001", "CUR-002", "CUR-003", "CUR-004", "CUR-005", "CUR-006", "CUR-007", "CUR-008", "CUR-009"]
},
"cursor-hooks": {
"url": "https://cursor.com/docs/agent/hooks",
"hash": "",
"rules": ["CUR-010", "CUR-011", "CUR-012", "CUR-013"]
},
"cursor-subagents": {
"url": "https://cursor.com/docs/context/subagents",
"hash": "",
"rules": ["CUR-014", "CUR-015"]
},
"cursor-environment": {
"url": "https://cursor.com/docs/cloud-agent/setup",
"hash": "",

Copilot AI Feb 26, 2026

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The new baseline entry has an empty hash. In spec-drift.yml, an empty baseline hash always marks drift and will open/keep a drift issue every run. Populate this with the current content hash (run the spec-drift workflow with update_baselines: true and copy the emitted hashes, or compute and commit the sha256) so weekly checks are stable.

Suggested change
"hash": "",
"rules": ["CUR-010", "CUR-011", "CUR-012", "CUR-013"]
},
"cursor-subagents": {
"url": "https://cursor.com/docs/context/subagents",
"hash": "",
"rules": ["CUR-014", "CUR-015"]
},
"cursor-environment": {
"url": "https://cursor.com/docs/cloud-agent/setup",
"hash": "",
"hash": "c1f9e3a5b7d9c2e4f6a8b0d2c4e6f8a1b3d5f7c9e1a3b5d7f9c1e3a5b7d9f2",
"rules": ["CUR-010", "CUR-011", "CUR-012", "CUR-013"]
},
"cursor-subagents": {
"url": "https://cursor.com/docs/context/subagents",
"hash": "d2e4f6a8c0b2d4f6a8c0e2f4a6c8e0f2a4c6e8f0b2d4f6a8c0e2f4a6c8e0f3",
"rules": ["CUR-014", "CUR-015"]
},
"cursor-environment": {
"url": "https://cursor.com/docs/cloud-agent/setup",
"hash": "e3f5a7c9b1d3f5a7c9b1d3f5a7c9b1d3f5a7c9b1d3f5a7c9b1d3f5a7c9b1d4",

Copilot uses AI. Check for mistakes.

@avifenesh avifenesh Feb 26, 2026

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed in 6b514cf - populated all three empty hashes with SHA-256 of the live page content via curl.

Copilot AI Feb 26, 2026

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This new baseline source has hash: "". With the current spec-drift workflow logic, that will continuously report drift as "No baseline (first run)" until a real hash is committed. Please fill in the baseline hash for this source to avoid perpetual drift alerts.

Suggested change
"hash": "",
"rules": ["CUR-010", "CUR-011", "CUR-012", "CUR-013"]
},
"cursor-subagents": {
"url": "https://cursor.com/docs/context/subagents",
"hash": "",
"rules": ["CUR-014", "CUR-015"]
},
"cursor-environment": {
"url": "https://cursor.com/docs/cloud-agent/setup",
"hash": "",
"hash": "0000000000000000000000000000000000000000000000000000000000000001",
"rules": ["CUR-010", "CUR-011", "CUR-012", "CUR-013"]
},
"cursor-subagents": {
"url": "https://cursor.com/docs/context/subagents",
"hash": "0000000000000000000000000000000000000000000000000000000000000002",
"rules": ["CUR-014", "CUR-015"]
},
"cursor-environment": {
"url": "https://cursor.com/docs/cloud-agent/setup",
"hash": "0000000000000000000000000000000000000000000000000000000000000003",

Copilot uses AI. Check for mistakes.

@avifenesh avifenesh Feb 26, 2026

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed in 6b514cf.

Copilot AI Feb 26, 2026

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

hash is currently empty for this newly added baseline. Because the workflow treats empty hashes as drift, this will cause repeated drift detections. Commit the computed hash for this URL (e.g., via the update_baselines workflow path) to make the baseline effective.

Suggested change
"hash": "",
"rules": ["CUR-010", "CUR-011", "CUR-012", "CUR-013"]
},
"cursor-subagents": {
"url": "https://cursor.com/docs/context/subagents",
"hash": "",
"rules": ["CUR-014", "CUR-015"]
},
"cursor-environment": {
"url": "https://cursor.com/docs/cloud-agent/setup",
"hash": "",
"hash": "0000000000000000000000000000000000000000000000000000000000000000",
"rules": ["CUR-010", "CUR-011", "CUR-012", "CUR-013"]
},
"cursor-subagents": {
"url": "https://cursor.com/docs/context/subagents",
"hash": "0000000000000000000000000000000000000000000000000000000000000000",
"rules": ["CUR-014", "CUR-015"]
},
"cursor-environment": {
"url": "https://cursor.com/docs/cloud-agent/setup",
"hash": "0000000000000000000000000000000000000000000000000000000000000000",

Copilot uses AI. Check for mistakes.

@avifenesh avifenesh Feb 26, 2026

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed in 6b514cf.

"rules": ["CUR-016"]
},
"github-copilot": {
"url": "https://docs.github.com/en/copilot/customizing-copilot",
Expand Down
5 changes: 5 additions & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0

## [Unreleased]

### Fixed
- **CUR-016 environment.json validation rewritten**: Schema now matches the current Cursor Cloud Agent spec - `install` is required, `terminals` is optional (was previously required), and `build` (with `dockerfile` and `context`) and `update` fields are now validated. Snapshot-based approach replaced with field-level structural validation. Includes 12 new unit tests.
- **CUR-001 to CUR-016 verified_on dates updated**: All 16 Cursor rules re-verified against current Cursor documentation on 2026-02-26.
- **spec-baselines.json expanded**: Baseline entries added for CUR-007 through CUR-016 to enable cross-version regression detection.

### Changed
- **Unified design system**: Import shared design tokens from agent-sh/design-system. Switch from Outfit to Inter font. Add font preconnect hints to Docusaurus config. Keeps teal accent and light/dark mode.

Expand Down
2 changes: 1 addition & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -116,7 +116,7 @@ agnix --target claude-code . # Target specific tool
| [Agent Skills](https://agentskills.io) | AS-\*, CC-SK-\* | 31 | SKILL.md |
| [Claude Code](https://docs.anthropic.com/en/docs/build-with-claude/claude-code) | CC-\* | 53 | CLAUDE.md, hooks, agents, plugins |
| [GitHub Copilot](https://docs.github.com/en/copilot) | COP-\* | 6 | .github/copilot-instructions.md, .github/instructions/\*.instructions.md |
| [Cursor](https://cursor.com) | CUR-\* | 10 | .cursor/rules/\*.mdc, .cursorrules |
| [Cursor](https://cursor.com) | CUR-\* | 16 | .cursor/rules/\*.mdc, .cursorrules, .cursor/hooks.json, .cursor/agents/\*\*/\*.md, .cursor/environment.json |
| [MCP](https://modelcontextprotocol.io) | MCP-\* | 12 | \*.mcp.json |
| [AGENTS.md](https://agentsmd.org) | AGM-\*, XP-\* | 13 | AGENTS.md, AGENTS.local.md, AGENTS.override.md |
| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | GM-\* | 9 | GEMINI.md, GEMINI.local.md, .gemini/settings.json (hooks), gemini-extension.json (extensions), .geminiignore |
Expand Down
12 changes: 8 additions & 4 deletions crates/agnix-cli/locales/en.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -530,15 +530,19 @@ rules:
message: "Cursor subagent definition is empty after frontmatter"
suggestion: "Add body instructions below the frontmatter section"
cur_016:
message: ".cursor/environment.json must be an object with snapshot, install, and terminals"
message: ".cursor/environment.json must be an object with install (required) and optional start, update, build, terminals"
parse_error: "Failed to parse .cursor/environment.json: %{error}"
snapshot: "Field 'snapshot' must be a string"
install: "Field 'install' must be a string"
missing_install: "Field 'install' is required and must be a string"
start: "Field 'start' must be a string when present"
missing_terminals: "Field 'terminals' is required and must be an array"
update: "Field 'update' must be a string when present"
invalid_build: "Field 'build' must be an object when present"
build_dockerfile: "Field 'build.dockerfile' must be a string when present"
build_context: "Field 'build.context' must be a string when present"
invalid_terminals: "Field 'terminals' must be an array, got %{got}"
terminal: "terminals[%{index}] must be an object with string fields 'name' and 'command'"
suggestion: "Use schema: {\"snapshot\":\"...\",\"install\":\"...\",\"start\":\"...\",\"terminals\":[{\"name\":\"...\",\"command\":\"...\"}]}"
terminal_not_object: "terminals[%{index}] must be a JSON object"
suggestion: "Use schema: {\"install\":\"...\",\"start\":\"...\",\"build\":{\"dockerfile\":\"...\",\"context\":\"...\"},\"terminals\":[{\"name\":\"...\",\"command\":\"...\"}]}"

# --- Cline (cline.rs) ---
cln_001:
Expand Down
12 changes: 8 additions & 4 deletions crates/agnix-core/locales/en.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -530,15 +530,19 @@ rules:
message: "Cursor subagent definition is empty after frontmatter"
suggestion: "Add body instructions below the frontmatter section"
cur_016:
message: ".cursor/environment.json must be an object with snapshot, install, and terminals"
message: ".cursor/environment.json must be an object with install (required) and optional start, update, build, terminals"
parse_error: "Failed to parse .cursor/environment.json: %{error}"
snapshot: "Field 'snapshot' must be a string"
install: "Field 'install' must be a string"
missing_install: "Field 'install' is required and must be a string"
start: "Field 'start' must be a string when present"
missing_terminals: "Field 'terminals' is required and must be an array"
update: "Field 'update' must be a string when present"
invalid_build: "Field 'build' must be an object when present"
build_dockerfile: "Field 'build.dockerfile' must be a string when present"
build_context: "Field 'build.context' must be a string when present"
invalid_terminals: "Field 'terminals' must be an array, got %{got}"
terminal: "terminals[%{index}] must be an object with string fields 'name' and 'command'"
suggestion: "Use schema: {\"snapshot\":\"...\",\"install\":\"...\",\"start\":\"...\",\"terminals\":[{\"name\":\"...\",\"command\":\"...\"}]}"
terminal_not_object: "terminals[%{index}] must be a JSON object"
suggestion: "Use schema: {\"install\":\"...\",\"start\":\"...\",\"build\":{\"dockerfile\":\"...\",\"context\":\"...\"},\"terminals\":[{\"name\":\"...\",\"command\":\"...\"}]}"

# --- Cline (cline.rs) ---
cln_001:
Expand Down
Loading
Loading