Cursor rule

1---
2description: Single Source of Truth (SSOT) Rules
3globs: 
4  - "**/*.md"
5  - "**/*.mdc"
6alwaysApply: false
7---
8 
9 
10# Single Source of Truth (SSOT) Rules
11 
12## Overview
13 
14This project follows SSOT principles. When editing documentation, always identify and update the SSOT location first.
15 
16## SSOT Locations
17 
18### AI Agent Configuration
19 
20| Category        | SSOT Location               | Auto-Generated        |
21| --------------- | --------------------------- | --------------------- |
22| File-type Rules | `.claude/rules/*.md`        | `.cursor/rules/*.mdc` |
23| Skills          | `.claude/skills/*/SKILL.md` | -                     |
24| Commands        | `.claude/commands/`         | -                     |
25 
26### Project Documentation
27 
28| Category         | SSOT Location                        | References                                     |
29| ---------------- | ------------------------------------ | ---------------------------------------------- |
30| Coding Standards | `.claude/rules/*.md` (per file type) | `docs/guidelines/coding-conventions.md`        |
31| Security         | `docs/guidelines/security.md`        | `.claude/rules/security.md`                    |
32| Testing          | `docs/guidelines/testing.md`         | -                                              |
33| Workflow         | `docs/guidelines/workflow.md`        | -                                              |
34| Database         | `docs/database/db-management.md`     | `.claude/rules/sql.md`, `.claude/rules/hcl.md` |
35| Architecture     | `ARCHITECTURE.md`                    | -                                              |
36| Agent Behavior   | `AGENTS.md`                          | -                                              |
37 
38## Key Principles
39 
40### 1. Define Once, Reference Everywhere
41 
42```
43SSOT Location (edit here)
44    ↓
45Referenced by other docs (add links, not duplicate content)
46```
47 
48### 2. Identification Rules
49 
50Before editing, ask:
51 
521. **Is this the SSOT?** → Edit directly
532. **Is this a reference?** → Find and edit the SSOT instead
543. **Creating new content?** → Determine appropriate SSOT location
55 
56### 3. Reference Patterns
57 
58**Good (reference):**
59 
60```markdown
61For verification commands, see `.claude/rules/go.md`.
62```
63 
64**Bad (duplication):**
65 
66```markdown
67## Verification Commands
68 
69make go-lint
70make check-build
71... (duplicating content from rules/go.md)
72```
73 
74## File-Type Rules SSOT
75 
76| File Type       | SSOT Rule File                      |
77| --------------- | ----------------------------------- |
78| `*.go`          | `.claude/rules/go.md`               |
79| `*.ts`, `*.js`  | `.claude/rules/typescript.md`       |
80| `*.sh`          | `.claude/rules/shell-script.md`     |
81| `*.sql`         | `.claude/rules/sql.md`              |
82| `*.hcl`         | `.claude/rules/hcl.md`              |
83| `*.proto`       | `.claude/rules/proto.md`            |
84| `*.yaml`        | `.claude/rules/yaml.md`             |
85| `*.md`, `*.mdc` | `.claude/rules/ssot.md` (this file) |
86 
87## Sync Requirements
88 
89After editing `.claude/rules/*.md`:
90 
91```bash
92make sync-cursor-rules
93```
94 
95This generates `.cursor/rules/*.mdc` automatically.
96 
97## Editing Guidelines
98 
99### When Editing SSOT Files
100 
1011. Make changes in the SSOT location
1022. Run sync script if editing `.claude/rules/`
1033. Verify references are still accurate
104 
105### When Editing Reference Files
106 
1071. Check if content should be in SSOT instead
1082. If duplicating SSOT content, convert to reference link
1093. Keep references concise
110 
111## Quick Checklist
112 
113- [ ] Identified the SSOT location for this information
114- [ ] Editing the SSOT (not a duplicate)
115- [ ] References link to SSOT (not duplicating content)
116- [ ] Sync script run after editing `.claude/rules/`
117 
118## Related Documentation
119 
120- @AGENTS.md - SSOT structure overview
121- @docs/guidelines/ - Project standards
122- @.claude/rules/ - File-type specific rules (SSOT)
123