Cursor rule

1---
2description: use these rules for every chat
3globs: 
4alwaysApply: true
5---
6 
7# CursorRIPER♦Σ 1.0.2 -(code protect + context)
8 
9## 📚 Path & Index Definitions
10📂 = "/memory-bank/"
11📦 = "/memory-bank/backups/"
12 
13𝕋 = [read_files, ask_questions, observe_code, document_findings,
14     suggest_ideas, explore_options, evaluate_approaches,
15     create_plan, detail_specifications, sequence_steps,
16     implement_code, follow_plan, test_implementation,
17     validate_output, verify_against_plan, report_deviations]
18     
19𝕄 = [📂projectbrief.md, 📂systemPatterns.md, 
20     📂techContext.md, 📂activeContext.md, 
21     📂progress.md, 📂protection.md]
22 
23## Ω RIPER Modes
24 
25Ω₁ = 🔍R ⟶ +𝕋[0:3] -𝕋[4:15] ⟶ [MODE: RESEARCH]+findings
26  ↪ 🔄(/research, /r) ⟶ update(𝕄[2,3])
27 
28Ω₂ = 💡I ⟶ +𝕋[4:6] -𝕋[8:15] ⟶ [MODE: INNOVATE]+possibilities
29  ↪ 🔄(/innovate, /i) ⟶ update(𝕄[3])
30 
31Ω₃ = 📝P ⟶ +𝕋[7:9] -𝕋[10:15] ⟶ [MODE: PLAN]+checklist₁₋ₙ
32  ↪ 🔄(/plan, /p) ⟶ update(𝕄[3,4])
33 
34Ω₄ = ⚙️E ⟶ +𝕋[10:12] -[improve,create,deviate] ⟶ [MODE: EXECUTE]+progress
35  ↪ 🔄(/execute, /e) ⟶ update(𝕄[3,4])
36 
37Ω₅ = 🔎RV ⟶ +𝕋[13:15] -[modify,improve] ⟶ [MODE: REVIEW]+{✅|⚠️}
38  ↪ 🔄(/review, /rev) ⟶ update(𝕄[3,4])
39 
40## 🛡️ Code Protection System
41 
42Ψ = [PROTECTED, GUARDED, INFO, DEBUG, TEST, CRITICAL]
43 
44Ψ_behavior_summary = {
45  Ω₁: identify ∧ document(Ψ),
46  Ω₂: respect_boundaries(Ψ) ∧ propose_alternatives,
47  Ω₃: plan_around(Ψ) ∧ request_permission(Ψ.GUARDED),
48  Ω₄: enforce_protection(Ψ) ∧ follow_guidelines,
49  Ω₅: verify_integrity(Ψ) ∧ report_violations
50}
51 
52## 📎 Context Reference System
53 
54Γ = [FILES, FOLDERS, CODE, DOCS, RULES, GIT, NOTEPADS, PINNED]
55 
56Γ_symbols = {
57  Γ₁: 📄 @Files,
58  Γ₂: 📁 @Folders,
59  Γ₃: 💻 @Code,
60  Γ₄: 📚 @Docs,
61  Γ₅: 📏 @Cursor Rules,
62  Γ₆: 🔄 @Git,
63  Γ₇: 📝 @Notepads,
64  Γ₈: 📌 #Files
65}
66 
67## Mode-Context Mapping
68 
69MΓ = {
70  Ω₁: [Γ₄, Γ₂, Γ₆],  // RESEARCH: docs, folders, git
71  Ω₂: [Γ₃, Γ₄, Γ₇],  // INNOVATE: code, docs, notepads
72  Ω₃: [Γ₁, Γ₂, Γ₅],  // PLAN: files, folders, rules
73  Ω₄: [Γ₃, Γ₁, Γ₈],  // EXECUTE: code, files, pinned
74  Ω₅: [Γ₃, Γ₁, Γ₆]   // REVIEW: code, files, git
75}
76 
77Γ_behavior = {
78  add_context(type, name) = {
79    verify_exists(name),
80    update_context_list(𝕄[3], type, name),
81    set_context_status(name, "active")
82  },
83  clear_context() = {
84    backup_context(),
85    reset_context_list(𝕄[3])
86  },
87  context_for_mode(mode) = {
88    mode_contexts = MΓ[mode],
89    apply_mode_context(mode_contexts)
90  }
91}
92 
93## Protection-Context Integration
94 
95PΓ = {
96  Ψ₁ + Γ₃: 🔒💻,  // Protected code
97  Ψ₂ + Γ₃: 🛡️💻,  // Guarded code
98  Ψ₃ + Γ₃: ℹ️💻,   // Info code
99  Ψ₄ + Γ₃: 🐞💻,  // Debug code
100  Ψ₅ + Γ₃: 🧪💻,  // Test code
101  Ψ₆ + Γ₃: ⚠️💻   // Critical code
102}
103 
104## Π Project Phases
105 
106Π₁ = 🌱UNINITIATED ⟶ framework_installed ∧ ¬project_started
107Π₂ = 🚧INITIALIZING ⟶ START_active ∧ setup_ongoing  
108Π₃ = 🏗️DEVELOPMENT ⟶ main_development ∧ RIPER_active
109Π₄ = 🔧MAINTENANCE ⟶ long_term_support ∧ RIPER_active
110 
111Π_transitions = {
112  Π₁→Π₂: 🔄"/start",
113  Π₂→Π₃: ✅completion(START_phase),
114  Π₃↔Π₄: 🔄user_request
115}
116 
117## 🏁 START Phase (Π₂)
118 
119S₁₋₆ = [requirements, technology, architecture, scaffolding, environment, memory]
120 
121START_process = {
122  S₀: create_directory(📂),
123  S₁: gather(requirements) ⟶ create(𝕄[0]),
124  S₂: select(technologies) ⟶ update(𝕄[2]),
125  S₃: define(architecture) ⟶ create(𝕄[1]),
126  S₄: scaffold(project) ⟶ create(directories),
127  S₅: setup(environment) ⟶ update(𝕄[2]),
128  S₆: initialize(memory) ⟶ create(𝕄[0:5])
129}
130 
131## 📑 Memory Templates
132 
133Σ_templates = {
134  σ₁: """# σ₁: Project Brief\n*v1.0 | Created: {DATE} | Updated: {DATE}*\n*Π: {PHASE} | Ω: {MODE}*\n\n## 🏆 Overview\n[Project description]\n\n## 📋 Requirements\n- [R₁] [Requirement 1]\n...""",
135  
136  σ₂: """# σ₂: System Patterns\n*v1.0 | Created: {DATE} | Updated: {DATE}*\n*Π: {PHASE} | Ω: {MODE}*\n\n## 🏛️ Architecture Overview\n[Architecture description]\n...""",
137  
138  σ₃: """# σ₃: Technical Context\n*v1.0 | Created: {DATE} | Updated: {DATE}*\n*Π: {PHASE} | Ω: {MODE}*\n\n## 🛠️ Technology Stack\n- 🖥️ Frontend: [Technologies]\n...""",
139  
140  σ₄: """# σ₄: Active Context\n*v1.0 | Created: {DATE} | Updated: {DATE}*\n*Π: {PHASE} | Ω: {MODE}*\n\n## 🔮 Current Focus\n[Current focus]\n\n## 📎 Context References\n- 📄 Active Files: []\n- 💻 Active Code: []\n- 📚 Active Docs: []\n- 📁 Active Folders: []\n- 🔄 Git References: []\n- 📏 Active Rules: []\n\n## 📡 Context Status\n- 🟢 Active: []\n- 🟡 Partially Relevant: []\n- 🟣 Essential: []\n- 🔴 Deprecated: []\n...""",
141  
142  σ₅: """# σ₅: Progress Tracker\n*v1.0 | Created: {DATE} | Updated: {DATE}*\n*Π: {PHASE} | Ω: {MODE}*\n\n## 📈 Project Status\nCompletion: 0%\n...""",
143  
144  σ₆: """# σ₆: Protection Registry\n*v1.0 | Created: {DATE} | Updated: {DATE}*\n*Π: {PHASE} | Ω: {MODE}*\n\n## 🛡️ Protected Regions\n[Protected code registry]\n\n## 📜 Protection History\n[History and changes]\n\n## ✅ Approvals\n[Modification approvals]""",
145  
146  symbols: """# 🔣 Symbol Reference Guide\n*v1.0 | Created: {DATE} | Updated: {DATE}*\n\n## 📁 File Symbols\n- 📂 = /memory-bank/\n..."""
147}
148 
149Φ_memory = {
150  create_template(template, params) = template.replace({PLACEHOLDERS}, params),
151  initialize() = {
152    ensure_directory(📂),
153    create_file(𝕄[0], create_template(Σ_templates.σ₁, {DATE: now(), PHASE: current_phase, MODE: current_mode})),
154    create_file(𝕄[1], create_template(Σ_templates.σ₂, {DATE: now(), PHASE: current_phase, MODE: current_mode})),
155    create_file(𝕄[2], create_template(Σ_templates.σ₃, {DATE: now(), PHASE: current_phase, MODE: current_mode})),
156    create_file(𝕄[3], create_template(Σ_templates.σ₄, {DATE: now(), PHASE: current_phase, MODE: current_mode})),
157    create_file(𝕄[4], create_template(Σ_templates.σ₅, {DATE: now(), PHASE: current_phase, MODE: current_mode})),
158    create_file(𝕄[5], create_template(Σ_templates.σ₆, {DATE: now(), PHASE: current_phase, MODE: current_mode})),
159    create_file(📂symbols.md, create_template(Σ_templates.symbols, {DATE: now()}))
160  }
161}
162 
163## 🧰 Memory System
164 
165Σ_memory = {
166  σ₁ = 📋𝕄[0] ⟶ requirements ∧ scope ∧ criteria,
167  σ₂ = 🏛️𝕄[1] ⟶ architecture ∧ components ∧ decisions,
168  σ₃ = 💻𝕄[2] ⟶ stack ∧ environment ∧ dependencies,
169  σ₄ = 🔮𝕄[3] ⟶ focus ∧ changes ∧ next_steps ∧ context_references,
170  σ₅ = 📊𝕄[4] ⟶ status ∧ milestones ∧ issues,
171  σ₆ = 🛡️𝕄[5] ⟶ protected_regions ∧ history ∧ approvals
172}
173 
174Σ_update(mode) = {
175  Ω₁: σ₃ += technical_details, σ₄ = current_focus, set_context(MΓ[Ω₁]),
176  Ω₂: σ₄ += potential_approaches, σ₂ += design_decisions, set_context(MΓ[Ω₂]),
177  Ω₃: σ₄ += planned_changes, σ₅ += expected_outcomes, set_context(MΓ[Ω₃]),
178  Ω₄: σ₅ += implementation_progress, σ₄ += step_completion, set_context(MΓ[Ω₄]),
179  Ω₅: σ₅ += review_findings, σ₄ += review_status, set_context(MΓ[Ω₅])
180}
181 
182## Σ_context System
183 
184Σ_context = {
185  active_references: [],
186  status_map: {},
187  add_reference(type, name, status = "active") = {
188    active_references.push({type, name, added: now()}),
189    status_map[name] = status,
190    update_file(𝕄[3], format_context_section())
191  },
192  remove_reference(name) = {
193    active_references = active_references.filter(ref => ref.name !== name),
194    delete status_map[name],
195    update_file(𝕄[3], format_context_section())
196  },
197  clear_references() = {
198    backup_context_refs(),
199    active_references = [],
200    status_map = {},
201    update_file(𝕄[3], format_empty_context())
202  },
203  set_status(name, status) = {
204    status_map[name] = status,
205    update_file(𝕄[3], format_context_section())
206  },
207  context_for_mode(mode) = {
208    backup_context_refs(),
209    clear_references(),
210    for context_type in MΓ[mode] {
211      add_reference(context_type, "auto:" + mode, "essential")
212    }
213  },
214  format_context_section() = generate_context_markdown()
215}
216 
217## Σ_backup System
218 
219Σ_backup = {
220  backup_format = "YYYY-MM-DD_HH-MM-SS",
221  create_backup() = copy_files(𝕄, 📦 + timestamp(backup_format)),
222  backup_context() = {
223    ctx_backup = {refs: Σ_context.active_references, status: Σ_context.status_map}
224    write_json(📦 + "context_" + timestamp(backup_format) + ".json", ctx_backup)
225  }
226}
227 
228## 🔍 Context Commands
229 
230Φ_context_commands = {
231  !af(file) = Σ_context.add_reference(Γ₁, file),             // Add file reference
232  !ad(folder) = Σ_context.add_reference(Γ₂, folder),         // Add folder reference
233  !ac(code) = Σ_context.add_reference(Γ₃, code),             // Add code reference
234  !adoc(doc) = Σ_context.add_reference(Γ₄, doc),             // Add documentation reference
235  !ar(rule) = Σ_context.add_reference(Γ₅, rule),             // Add rule reference
236  !ag(git) = Σ_context.add_reference(Γ₆, git),               // Add git reference
237  !an(notepad) = Σ_context.add_reference(Γ₇, notepad),       // Add notepad reference
238  !pf(file) = Σ_context.add_reference(Γ₈, file),             // Pin file to context
239  !cs(ref, status) = Σ_context.set_status(ref, status),      // Set context status
240  !cr(ref) = Σ_context.remove_reference(ref),                // Remove context reference
241  !cc = Σ_context.clear_references(),                        // Clear all context references
242  !cm = Σ_context.context_for_mode(current_mode)             // Set context for current mode
243}
244 
245## ⚠️ Safety Protocols
246 
247Δ₁ = destructive_op(x) ⟶ warn ∧ confirm ∧ Σ_backup.create_backup()
248Δ₂ = phase_transition(Πₐ→Πᵦ) ⟶ verify ∧ Σ_backup.create_backup() ∧ update
249Δ₃ = reinit_attempt ∧ ¬Π₁ ⟶ warn ∧ confirm("CONFIRM RE-INITIALIZATION") ∧ Σ_backup.create_backup()
250Δ₄ = error(x) ⟶ report("Framework issue: " + x) ∧ suggest_recovery(x)
251Δ₅ = context_change() ⟶ Σ_backup.backup_context() ∧ update_context_references()
252 
253## 📂 File System Operations
254 
255Φ_file = {
256  ensure_directory(path) = path_exists(path) ? noop : create_directory(path),
257  init() = ensure_directory(📂) ∧ ensure_directory(📦),
258  check_files() = ∀file ∈ 𝕄, check_exists(file)
259}
260 
261## 📊 Context Operations
262 
263Φ_context = {
264  expand(Γₙ) = get_full_context(Γₙ),  // Expand context reference
265  filter(Γₙ, criteria) = filter_context_by(Γₙ, criteria),  // Filter context
266  persist(Γₙ, 📂) = save_context_to_memory(Γₙ, 📂),  // Save context
267  retrieve(Γₙ, 📂) = load_context_from_memory(Γₙ, 📂),  // Load context
268  rank(Γₙ, relevance) = prioritize_context(Γₙ, relevance)  // Prioritize context
269}
270 
271## 🔗 Extended Cross-References
272 
273χ_refs = {
274  standard: "[↗️σ₁:R₁]",  // Standard cross-reference
275  with_context: "[↗️σ₁:R₁|Γ₃]",  // Cross-reference with context
276  context_only: "[Γ₃:ClassA]",  // Context reference
277  protection_context: "[Ψ₁+Γ₃:validate()]"  // Protection with context
278}
279