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

  1. Use Unicode: Greek letters, mathematical symbols
  2. Be Consistent: Similar concepts use similar symbols
  3. Visual Logic: Symbol should suggest meaning
  4. 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

  1. Identify the system (Greek letter)
  2. Note the index (subscript)
  3. Check operators (math symbols)
  4. Trace relationships (arrows)

Writing Symbolic Notation

  1. Choose appropriate symbol
  2. Add index if needed
  3. Define relationships
  4. 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

  1. Start Simple: Learn mode symbols (ฮฉโ‚-ฮฉโ‚…)
  2. Add Context: Understand permissions (โ„™)
  3. Memory Files: Learn file symbols (ฯƒโ‚-ฯƒโ‚†)
  4. Protection: Master protection levels (ฮจโ‚-ฮจโ‚†)
  5. 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:


โ† Memory System | Home | Phase Management โ†’