{"id":28646702,"url":"https://github.com/firedev/cursor-riper-framework","last_synced_at":"2025-06-13T02:06:36.829Z","repository":{"id":296010272,"uuid":"992028671","full_name":"firedev/cursor-riper-framework","owner":"firedev","description":"Cursor AI Persistent context tracking.","archived":false,"fork":false,"pushed_at":"2025-05-28T14:46:13.000Z","size":23,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-05-28T15:33:30.309Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/firedev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-28T14:04:59.000Z","updated_at":"2025-05-28T14:46:17.000Z","dependencies_parsed_at":"2025-05-28T15:36:57.943Z","dependency_job_id":null,"html_url":"https://github.com/firedev/cursor-riper-framework","commit_stats":null,"previous_names":["firedev/cursor-riper-framework"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/firedev/cursor-riper-framework","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firedev%2Fcursor-riper-framework","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firedev%2Fcursor-riper-framework/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firedev%2Fcursor-riper-framework/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firedev%2Fcursor-riper-framework/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/firedev","download_url":"https://codeload.github.com/firedev/cursor-riper-framework/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firedev%2Fcursor-riper-framework/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259565563,"owners_count":22877347,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-06-13T02:06:36.191Z","updated_at":"2025-06-13T02:06:36.810Z","avatar_url":"https://github.com/firedev.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Cursor RIPER Framework\n\n```\n    ██▀███   ██▓ ██▓███  ▓█████  ██▀███\n   ▓██ ▒ ██▒▓██▒▓██░  ██▒▓█   ▀ ▓██ ▒ ██▒\n   ▓██ ░▄█ ▒▒██▒▓██░ ██▓▒▒███   ▓██ ░▄█ ▒\n   ▒██▀▀█▄  ░██░▒██▄█▓▒ ▒▒▓█  ▄ ▒██▀▀█▄\n   ░██▓ ▒██▒░██░▒██▒ ░  ░░▒████▒░██▓ ▒██▒\n   ░ ▒▓ ░▒▓░░▓  ▒▓▒░ ░  ░░░ ▒░ ░░ ▒▓ ░▒▓░\n     ░▒ ░ ▒░ ▒ ░░▒ ░      ░ ░  ░  ░▒ ░ ▒░\n     ░░   ░  ▒ ░░░          ░     ░░   ░\n      ░      ░              ░  ░   ░\n\nRESEARCH • INNOVATE • PLAN • EXECUTE • REVIEW\n```\n\nA comprehensive AI workflow framework for Cursor IDE that provides structured development processes, persistent memory management, and intelligent context tracking.\n\n## Overview\n\nCursor RIPER is a framework designed to enhance AI-assisted development in Cursor IDE by providing:\n\n- **Structured Workflow**: RIPER methodology (Research, Innovate, Plan, Execute, Review)\n- **Persistent Memory**: Context preservation across sessions\n- **Learning System**: Capture and apply project-specific learnings\n- **State Management**: Track project phases and development progress\n- **Safety Protocols**: Prevent unintended modifications and ensure quality\n\n## Quick Installation\n\n1. **Copy framework files to your project:**\n   ```bash\n   cp -r cursor-riper-framework/.cursor /path/to/your/project/\n   cp -r cursor-riper-framework/memory-bank /path/to/your/project/\n   ```\n\n2. **Initialize the framework:**\n   - Open your project in Cursor IDE\n   - The framework will auto-detect and initialize on first use\n   - Use `/start` command if starting a new project\n   - Use `/help` to see available commands\n\n## Framework Structure\n\n### Core Files (Always Active)\n```\n.cursor/\n├── rules/\n│   ├── core.mdc           # Core framework logic and memory management\n│   ├── state.mdc          # Project state and phase tracking\n│   └── riper-workflow.mdc # RIPER mode specifications\n├── archive/\n│   └── start-phase.mdc    # Project initialization (archived after setup)\n└── cursorignore           # Cursor-specific ignore patterns\n```\n\n### Memory Bank (Auto-loaded)\n```\nmemory-bank/\n├── projectbrief.md        # Core requirements and goals\n├── systemPatterns.md      # Architecture and technical decisions\n├── techContext.md         # Technologies and development setup\n├── activeContext.md       # Current work focus and next steps\n├── progress.md            # What works, what's left, known issues\n└── learnings.md           # Project-specific learnings and corrections\n```\n\n## RIPER Workflow\n\n### Modes\n- **RESEARCH**: Information gathering and analysis only\n- **INNOVATE**: Brainstorming and creative problem-solving\n- **PLAN**: Create detailed specifications and strategies\n- **EXECUTE**: Implement planned changes\n- **REVIEW**: Validate and assess implementation\n\n### Commands\n- `/research`, `/innovate`, `/plan`, `/execute`, `/review` - Switch modes\n- `/learn \"wrong\" \"correct\" \"why\"` - Record learnings\n- `/focus X` - Set focus area\n- `/checkpoint` - Create save point\n- `/decision X` - Record architectural decision\n- `/help` - Show help guide\n\n## Key Features\n\n### 1. Memory Management\n- **Persistent Context**: Maintains project understanding across sessions\n- **Automatic Updates**: Memory hooks trigger updates based on activities\n- **Learning System**: Captures and applies project-specific knowledge\n\n### 2. Safety Protocols\n- **Mode Enforcement**: Prevents implementation without planning\n- **Change Validation**: Requires explicit confirmation for destructive operations\n- **State Consistency**: Validates transitions and maintains integrity\n\n### 3. Workflow Structure\n- **Phase Management**: Tracks project lifecycle (Initialization → Development → Maintenance)\n- **Mode Transitions**: Enforces logical workflow progression\n- **Context Awareness**: Leverages Cursor IDE features for enhanced productivity\n\n## Installation for New Projects\n\n### Option 1: Fresh Installation\n```bash\n# Copy framework to new project\ncp -r cursor-riper-framework/.cursor /path/to/new/project/\nmkdir -p /path/to/new/project/memory-bank\n\n# Open in Cursor IDE and run:\n# /start\n```\n\n### Option 2: Existing Project\n```bash\n# Copy framework to existing project\ncp -r cursor-riper-framework/.cursor /path/to/existing/project/\ncp -r cursor-riper-framework/memory-bank /path/to/existing/project/\n\n# Framework will auto-detect existing project state\n```\n\n## Usage Examples\n\n### Starting a New Feature\n```\n/research\n# Investigate requirements and existing code\n\n/innovate\n# Brainstorm implementation approaches\n\n/plan\n# Create detailed implementation plan\n\n/execute\n# Implement the planned solution\n\n/review\n# Validate implementation and document results\n```\n\n### Recording Learnings\n```\n/learn \"used wrong Rails command\" \"use rails r not rails console\" \"rails r is for scripts, console is for interactive sessions\"\n```\n\n### Managing Focus\n```\n/focus \"API authentication system\"\n/checkpoint \"Authentication middleware implemented\"\n/decision \"Using JWT tokens for stateless auth\"\n```\n\n## Framework Philosophy\n\n1. **Explicit over Implicit**: Clear workflows prevent assumptions\n2. **Memory over Repetition**: Context preservation reduces redundant work\n3. **Safety over Speed**: Validation prevents costly mistakes\n4. **Learning over Forgetting**: Capture knowledge for future application\n\n## Troubleshooting\n\n### Framework Not Loading\n- Ensure `.cursor/rules/` directory exists with all `.mdc` files\n- Check that `state.mdc` has valid PROJECT_PHASE value\n- Verify Cursor IDE is recognizing the `.cursor` directory\n\n### Memory Bank Issues\n- Create `memory-bank/` directory if missing\n- Use `/checkpoint` to force memory updates\n- Check `activeContext.md` for current status\n\n### Command Not Working\n- Use `/help` to see available commands\n- Ensure you're in the correct mode for the operation\n- Check `state.mdc` for current PROJECT_PHASE\n\n## Contributing\n\nThe CursorRIPER Framework is designed to be:\n- **Modular**: Components can be enhanced independently\n- **Extensible**: New modes and commands can be added\n- **Customizable**: Adapt workflows to project needs\n\n## Version History\n\n- **1.0.3**: Optimized 3-file structure, integrated learning system\n- **1.0.2**: Enhanced memory hooks and state management\n- **1.0.1**: Initial RIPER workflow implementation\n- **1.0.0**: Core framework and memory bank system\n\n---\n\nCursor RIPER Framework - Enhancing AI-assisted development through structured workflows and persistent intelligence.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffiredev%2Fcursor-riper-framework","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffiredev%2Fcursor-riper-framework","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffiredev%2Fcursor-riper-framework/lists"}