Skip to content

A symbolic, ultra-efficient AI prompt framework for software development assistance Based off CursorRIPER

Notifications You must be signed in to change notification settings

awesome-archive/CursorRIPER.sigma

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

74 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CursorRIPER♦Σ

CursorRIPER♦Σ (Sigma)

License: MIT Version

A symbolic, ultra-efficient AI prompt framework for software development assistance with code protection, context reference, and permission management capabilities.

Current version: RIPERsigma1.0.4.mdc

Try out CursorRIPER.sigma-lite, a Lite version without context references, permissions, or code protection.

📚 Overview

CursorRIPER♦Σ is a highly optimized, symbolic implementation of the CursorRIPER framework designed to enhance AI-assisted software development. It uses a symbolic notation system with mathematical operators, emojis, and Greek letters to compress complex development workflows into a minimal, yet comprehensive, token footprint.

The framework reduces ~15,000 words of instructions to under 1,000 while preserving full functionality, making it dramatically more efficient for AI token usage. The idea came from Tof

🌟 Key Features

  • Symbolic Notation: Uses Greek letters (Ω, Π, Σ, Δ, Γ, ℙ), subscripts, and emoji for extreme conciseness
  • RIPER Workflow Modes: Research, Innovate, Plan, Execute, Review (🔍R, 💡I, 📝P, ⚙️E, 🔎RV)
  • Structured Memory System: Standardized file templates with cross-referencing
  • Phase-based Project Management: Tracks project progress from initialization to maintenance
  • Automatic Memory: Creates and maintains a structured memory bank for project context
  • Code Protection System: Protects critical code sections with intelligent comment annotations
  • Context Reference System: Manages and tracks file, code, and document references
  • Permission System: Enforces mode-specific CRUD operations and handles violations

🧠 Framework Structure

Modes (Ω)

Ω₁ = 🔍R ⟶ ℙ(Ω₁) ⟶ Research: Gather information and document findings
Ω₂ = 💡I ⟶ ℙ(Ω₂) ⟶ Innovate: Explore options and suggest ideas
Ω₃ = 📝P ⟶ ℙ(Ω₃) ⟶ Plan: Create specifications and sequence steps
Ω₄ = ⚙️E ⟶ ℙ(Ω₄) ⟶ Execute: Implement code according to plan
Ω₅ = 🔎RV ⟶ ℙ(Ω₅) ⟶ Review: Validate output against requirements

Phases (Π)

Π₁ = 🌱UNINITIATED ⟶ Framework installed but not started
Π₂ = 🚧INITIALIZING ⟶ Setup in progress
Π₃ = 🏗️DEVELOPMENT ⟶ Main development work
Π₄ = 🔧MAINTENANCE ⟶ Long-term support

Memory Files (σ)

σ₁ = 📋projectbrief.md ⟶ Requirements, scope, criteria
σ₂ = 🏛️systemPatterns.md ⟶ Architecture, components, decisions
σ₃ = 💻techContext.md ⟶ Stack, environment, dependencies
σ₄ = 🔮activeContext.md ⟶ Focus, changes, next steps, context references
σ₅ = 📊progress.md ⟶ Status, milestones, issues
σ₆ = 🛡️protection.md ⟶ Protected regions, history, approvals, violations

Protection Levels (Ψ)

Ψ₁ = PROTECTED ⟶ Highest protection, do not modify
Ψ₂ = GUARDED ⟶ Ask before modifying
Ψ₃ = INFO ⟶ Context note
Ψ₄ = DEBUG ⟶ Debugging code
Ψ₅ = TEST ⟶ Testing code
Ψ₆ = CRITICAL ⟶ Business logic, highest protection

Context References (Γ)

Γ₁ = 📄 @Files ⟶ File references
Γ₂ = 📁 @Folders ⟶ Folder references
Γ₃ = 💻 @Code ⟶ Code references
Γ₄ = 📚 @Docs ⟶ Documentation references
Γ₅ = 📏 @Rules ⟶ Cursor rules references
Γ₆ = 🔄 @Git ⟶ Git history references
Γ₇ = 📝 @Notepads ⟶ Notepad references
Γ₈ = 📌 #Files ⟶ Pinned file references

Permission Matrix (ℙ)

ℙ = {C: create, R: read, U: update, D: delete}

ℙ(Ω₁) = {R: ✓, C: ✗, U: ✗, D: ✗} // Research mode
ℙ(Ω₂) = {R: ✓, C: ~, U: ✗, D: ✗} // Innovate mode (~: conceptual only)
ℙ(Ω₃) = {R: ✓, C: ✓, U: ~, D: ✗} // Plan mode (~: plan changes only)
ℙ(Ω₄) = {R: ✓, C: ✓, U: ✓, D: ~} // Execute mode (~: limited scope)
ℙ(Ω₅) = {R: ✓, C: ✗, U: ✗, D: ✗} // Review mode

🚀 Getting Started

Installation

  1. Create a memory bank directory in your project:
mkdir -p /memory-bank/backups
  1. Copy the CursorRIPER♦Σ framework .mdc files to your project rules folder: .cursor/rules/

  2. Initialize the framework with the AI assistant:

/start

Usage

Change modes by using the following commands with your AI assistant:

/research (or /r) - Research mode
/innovate (or /i) - Innovate mode
/plan (or /p) - Plan mode
/execute (or /e) - Execute mode
/review (or /rev) - Review mode

📑 Memory System

The framework automatically maintains six key memory files:

  1. Project Brief (σ₁): Defines requirements, success criteria, and scope
  2. System Patterns (σ₂): Captures architecture, components, and design decisions
  3. Technical Context (σ₃): Records technology stack, environment, and dependencies
  4. Active Context (σ₄): Tracks current focus, recent changes, next steps, and context references
  5. Progress Tracker (σ₅): Monitors project status, features, issues, and milestones
  6. Protection Registry (σ₆): Tracks protected code regions, history, approvals, and permission violations

🛡️ Code Protection System

The framework includes a robust code protection system that helps preserve critical code sections from unintended modifications:

Protection Levels

  • PROTECTED: Code that must not be modified under any circumstances
  • GUARDED: Code that requires explicit permission before modification
  • INFO: Context information relevant to understanding code
  • DEBUG: Temporary code used for debugging purposes
  • TEST: Code related to testing functionality
  • CRITICAL: Business logic that must be treated with extreme care

Protection Commands

Add code protection with shorthand commands:

!cp - Add PROTECTED comment
!cg - Add GUARDED comment
!ci - Add INFO comment
!cd - Add DEBUG comment
!ct - Add TEST comment
!cc - Add CRITICAL comment

See Protection Commands for full documentation.

📎 Context Reference System

The context reference system allows tracking and managing important files, code, and documents:

Context Types

  • @Files: Important files in the project
  • @Folders: Relevant directories or folder structures
  • @Code: Code sections, functions, or classes
  • @Docs: Documentation or specification references
  • @Rules: Cursor project rules references
  • @Git: Git history or commit references
  • @Notepads: Notepad content references
  • #Files: Pinned file references

Context Commands

Manage context references with shorthand commands:

!af - Add file reference
!ad - Add directory reference
!ac - Add code reference
!adoc - Add documentation reference
!ar - Add rules reference
!ag - Add git reference
!an - Add notepad reference
!pf - Pin file to context

See Context Usage Guide for more details.

🔐 Permission System

The permission system enforces appropriate operations for each mode and handles violations:

Permission Matrix

Each mode has a specific set of allowed CRUD operations:

  • Research Mode: Read only
  • Innovate Mode: Read and conceptual creation
  • Plan Mode: Read, create, and plan updates
  • Execute Mode: Read, create, update, and limited deletion
  • Review Mode: Read only

Permission Commands

Check and verify permissions with shorthand commands:

!ckp - Check permissions for current mode
!pm - Check if operation is permitted
!sp - Show permissions for specified mode
!vm - Verify mode appropriate for operation

See Permission Reference for quick reference.

⚠️ Safety Features

  • Automatic backups before destructive operations
  • Confirmation prompts for critical actions
  • Phase transition verification
  • Error recovery suggestions
  • Code protection system with mode-aware behavior
  • Permission violation detection and recovery
  • Context tracking with status indicators

🔣 Symbol Reference

See the Symbol Reference Guide for a complete list of symbols and notation used in the framework.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.


CursorRIPER♦Σ: Symbolic efficiency for AI-assisted development with intelligent code protection, context awareness, and permission enforcement.

About

A symbolic, ultra-efficient AI prompt framework for software development assistance Based off CursorRIPER

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published