Symbolic Notation - johnpeterman72/CursorRIPER.sigma GitHub Wiki
๐ฃ Symbolic Notation System
CursorRIPERโฆฮฃ achieves its remarkable efficiency through a sophisticated symbolic notation system that compresses complex instructions into minimal tokens.
๐ฏ Why Symbolic Notation?
Traditional Approach (Verbose)
"You are currently in research mode. In this mode, you are allowed to read
files, analyze code structures, ask questions, and document your findings.
However, you cannot write code, create files, modify existing files, or
make any changes to the codebase."
Token count: ~50
CursorRIPERโฆฮฃ Approach (Symbolic)
ฮฉโ = ๐R โถ โ(ฮฉโ) โถ +๐[0:3] -๐[4:15]
Token count: ~5
93% token reduction! Same meaning, fraction of the space.
๐งฎ Core Symbol Categories
1. Greek Letters (System Identifiers)
Symbol | System | Usage |
---|---|---|
ฮฉ (Omega) | Modes | ฮฉโ=Research, ฮฉโ=Innovate... |
ฮ (Pi) | Phases | ฮ โ=Uninitiated, ฮ โ=Initializing... |
ฮฃ (Sigma) | Memory | ฮฃ_memory, ฮฃ_update, ฮฃ_backup |
ฮจ (Psi) | Protection | ฮจโ=PROTECTED, ฮจโ=GUARDED... |
ฮ (Gamma) | Context | ฮโ=Files, ฮโ=Folders... |
โ (Double-struck P) | Permissions | โ(ฮฉโ)={R:โ, C:โ...} |
2. Subscripts (Indexing)
Subscripts identify specific instances:
ฮฉโ = First mode (Research)
ฯโ = Third memory file (techContext.md)
ฮโ
= Fifth context type (Rules)
3. Emoji (Visual Recognition)
Quick visual identification:
๐ = Research
๐ก = Innovate
๐ = Plan
โ๏ธ = Execute
๐ = Review
4. Mathematical Operators
Define relationships and operations:
โถ = Leads to/Results in
โง = AND operation
โจ = OR operation
ยฌ = NOT operation
โ = Element of
โฉ = Intersection
โช = Union
๐ Symbol Grammar
Mode Definition Pattern
ฮฉโ = [emoji][letter] โถ โ(ฮฉโ) โถ +๐[range] -๐[range]
Example breakdown:
ฮฉโ = ๐R โถ โ(ฮฉโ) โถ +๐[0:3] -๐[4:15]
โ โ โ โ โ
โ โ โ โ โโ Disable functions 4-15
โ โ โ โโโโโโโโโโโ Enable functions 0-3
โ โ โโโโโโโโโโโโโโโโโโโโโ Apply permissions
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโ Research mode emoji+letter
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ Mode 1 identifier
Permission Matrix Pattern
โ(ฮฉโ) = {C: status, R: status, U: status, D: status}
Status symbols:
- โ = Allowed
- โ = Forbidden
- ~ = Conditional/Limited
Cross-Reference Pattern
[โ๏ธฯโ:Xแตข|ฮโ]
Components:
- โ๏ธ = Cross-reference indicator
- ฯโ = Memory file n
- Xแตข = Item i (Rโ, Fโ, etc.)
- ฮโ = Context type m
๐ค Symbol Definitions
Mode Symbols (ฮฉ)
ฮฉโ = ๐R = Research mode
ฮฉโ = ๐กI = Innovate mode
ฮฉโ = ๐P = Plan mode
ฮฉโ = โ๏ธE = Execute mode
ฮฉโ
= ๐RV = Review mode
Phase Symbols (ฮ )
ฮ โ = ๐ฑUNINITIATED = Framework installed, not started
ฮ โ = ๐งINITIALIZING = Setup in progress
ฮ โ = ๐๏ธDEVELOPMENT = Active development
ฮ โ = ๐งMAINTENANCE = Long-term maintenance
Memory File Symbols (ฯ)
ฯโ = ๐projectbrief.md
ฯโ = ๐๏ธsystemPatterns.md
ฯโ = ๐ปtechContext.md
ฯโ = ๐ฎactiveContext.md
ฯโ
= ๐progress.md
ฯโ = ๐ก๏ธprotection.md
Protection Symbols (ฮจ)
ฮจโ = PROTECTED (๐)
ฮจโ = GUARDED (๐ก๏ธ)
ฮจโ = INFO (โน๏ธ)
ฮจโ = DEBUG (๐)
ฮจโ
= TEST (๐งช)
ฮจโ = CRITICAL (โ ๏ธ)
Context Symbols (ฮ)
ฮโ = ๐ @Files
ฮโ = ๐ @Folders
ฮโ = ๐ป @Code
ฮโ = ๐ @Docs
ฮโ
= ๐ @Rules
ฮโ = ๐ @Git
ฮโ = ๐ @Notepads
ฮโ = ๐ #Files
๐งฉ Complex Expressions
Operation Sets (๐)
๐แตฃโโโ = {modify_files, write_code, delete_content}
๐แตฅแตขแตฃโแตคโโ = {suggest_ideas, explore_concepts}
๐โแตฆโโแตฃแตฅโ = {read_files, analyze_content}
Mode Permissions (๐)
๐(ฮฉโ) = {๐โแตฆโโแตฃแตฅโ: โ, ๐แตฅแตขแตฃโแตคโโ: ~, ๐แตฃโโโ: โ}
Function Arrays (๐)
๐ = [read_files, ask_questions, observe_code,
document_findings, suggest_ideas, ...]
+๐[0:3] = Enable functions 0,1,2,3
-๐[4:15] = Disable functions 4 through 15
๐ Symbol Combinations
Protection + Context
ฮจโ + ฮโ = ๐๐ป (Protected code)
ฮจโ + ฮโ = ๐ก๏ธ๐ป (Guarded code)
Mode + Context
โ(ฮฉโ) + ฮโ = ๐๐ (Research file context)
โ(ฮฉโ) + ฮโ = ๐ปโ๏ธ (Execute code context)
Violation Notation
ฮ(op, ฮฉ) = op โ ๐(ฮฉ) ? allow(op) : ๐(op, ฮฉ)
Translation: "If operation is in mode's allowed set, allow it; otherwise, trigger violation handler."
๐ Practical Examples
Example 1: Mode Definition
ฮฉโ = ๐P โถ โ(ฮฉโ) โถ +๐[7:9] -๐[10:15]
Means: Plan mode with create/read permissions, enabling planning functions only.
Example 2: Memory Update
ฮฃ_update(ฮฉโ) = ฯโ += technical_details, ฯโ = current_focus
Means: In Research mode, add findings to techContext and update activeContext.
Example 3: Context Operation
Mฮ[ฮฉโ] = [ฮโ, ฮโ, ฮโ]
Means: Execute mode uses Code, Files, and Pinned contexts.
Example 4: Protection Check
ฮจ_behavior[ฮฉโ] = enforce_protection(ฮจ, ฮจโ)
Means: Execute mode enforces both start and end protection markers.
๐จ Creating New Symbols
Guidelines for Extension
- Use Unicode: Greek letters, mathematical symbols
- Be Consistent: Similar concepts use similar symbols
- Visual Logic: Symbol should suggest meaning
- Avoid Conflicts: Check existing symbols first
Example: Adding Docker Support
ฮ = Docker operations
ฮโ = create_container
ฮโ = deploy_compose
Sฮ = Docker shortcuts (!dc, !dd)
๐ก Symbol Benefits
1. Token Efficiency
- 10x-20x compression ratio
- More context fits in prompts
- Faster AI processing
2. Precision
- No ambiguity
- Exact meaning
- Mathematical clarity
3. Universality
- Language-agnostic
- Globally understood
- Consistent interpretation
4. Extensibility
- Easy to add new symbols
- Modular system
- Clean namespacing
๐ ๏ธ Working with Symbols
Reading Symbolic Notation
- Identify the system (Greek letter)
- Note the index (subscript)
- Check operators (math symbols)
- Trace relationships (arrows)
Writing Symbolic Notation
- Choose appropriate symbol
- Add index if needed
- Define relationships
- Document meaning
Common Patterns
Assignment:
X = value
Mapping:
X[key] = value
Conditional:
condition ? true_action : false_action
Set Operations:
A โฉ B (intersection)
A โช B (union)
x โ A (membership)
๐จ Symbol Reference Quick Lookup
System Symbols
- ฮฉ = Modes
- ฮ = Phases
- ฮฃ = Memory
- ฮจ = Protection
- ฮ = Context
- โ = Permissions
Status Symbols
- โ = Complete
- โณ = In Progress
- ๐ = Planned
- โ ๏ธ = Warning
- โ = Error/Blocked
Context Status
- ๐ข = Active
- ๐ก = Partial
- ๐ฃ = Essential
- ๐ด = Deprecated
Permission Status
- โ = Allowed
- โ = Forbidden
- ~ = Limited
๐ Learning Progression
- Start Simple: Learn mode symbols (ฮฉโ-ฮฉโ )
- Add Context: Understand permissions (โ)
- Memory Files: Learn file symbols (ฯโ-ฯโ)
- Protection: Master protection levels (ฮจโ-ฮจโ)
- Advanced: Complex expressions and combinations
๐ Practice Exercises
Exercise 1: Decode This
ฮฉโ = ๐กI โถ โ(ฮฉโ) โถ +๐[4:6] -๐[8:15]
Answer: Innovate mode with read/conceptual permissions, enabling innovation functions.
Exercise 2: Write Symbolic
"Execute mode can read, create, and update, but has limited delete permissions."
Answer:
โ(ฮฉโ) = {R: โ, C: โ, U: โ, D: ~}
Exercise 3: Interpret Relationship
[โ๏ธฯโ:Rโ|ฮโ:validateUser()]
Answer: Cross-reference to requirement 3 in projectbrief.md, specifically the validateUser() code element.
๐ Symbol Dictionary
For the complete symbol reference, see: