cursor-memory-bank: Structured AI Development Workflow with Cursor 2.0 Commands
Summary
cursor-memory-bank is a modular, documentation-driven framework designed to enhance AI-assisted development within the Cursor editor. It leverages Cursor 2.0 commands to provide persistent memory and guide AI through a structured development workflow. This system uses visual process maps and token optimization to streamline tasks from initialization to archiving.
Repository Info
Tags
Click on any tag to explore related repositories
Introduction
cursor-memory-bank is a sophisticated, documentation-driven framework that transforms AI-assisted software development into a structured, phase-based process within the Cursor editor. It utilizes Cursor 2.0 commands to establish persistent memory and guide the AI through a comprehensive development workflow, from initial project setup to final archiving. The system is designed for token optimization, employing hierarchical rule loading and progressive documentation to ensure efficiency.
At its core, cursor-memory-bank operates through six specialized commands:
/van: Initializes projects, detects platform, and determines task complexity./plan: Creates detailed implementation plans./creative: Explores design options for components requiring decisions./build: Systematically implements planned changes./reflect: Reviews completed work and documents lessons learned./archive: Creates comprehensive documentation and updates the Memory Bank.
Each command interacts with a shared memory-bank/ directory, maintaining context across the entire workflow and adapting its behavior based on task complexity levels.
Installation
To get started with cursor-memory-bank, ensure you meet the prerequisites and follow these simple steps.
Prerequisites
- Cursor Editor: Version 2.0 or higher is required for the commands feature.
- AI Model: Claude 4 Sonnet or Claude 4 Opus is recommended for optimal results, especially for the
/creativecommand's "Think" tool methodology.
Step 1: Get the Files
Clone the repository into your project directory:
git clone https://github.com/vanzan01/cursor-memory-bank.git
Alternatively, if downloading a ZIP file:
- Copy the
.cursorfolder to your project directory. This folder contains both the rules and commands necessary for operation. - Other explanatory documents are not strictly required for Memory Bank operation, but can be copied to a separate folder if desired.
Step 2: Using Commands
Commands are ready to use immediately after installation, requiring no additional setup.
- Type
/in the Cursor chat to view the available commands:/van- Initialization & entry point/plan- Task planning/creative- Design decisions/build- Code implementation/reflect- Task reflection/archive- Task archiving
- Start with
/vanto initialize your project, for example:/van Initialize project for adding user authentication feature - Follow the workflow: Each command will guide you to the next logical step in the development process.
Examples
cursor-memory-bank adapts its workflow based on the complexity of your task, ensuring an efficient and guided process.
Quick Start Workflow Examples
- Level 1 (Quick Bug Fix):
/van ? /build ? /reflect ? /archive - Level 2 (Simple Enhancement):
/van ? /plan ? /build ? /reflect ? /archive - Level 3-4 (Feature/System):
/van ? /plan ? /creative ? /build ? /reflect ? /archive
Complete Example Workflow (Level 3 Feature)
Here is a complete example for implementing a Level 3 feature:
# Step 1: Initialize the project and task
/van Add user authentication with OAuth2 support
# Step 2: Plan the implementation (VAN routes to PLAN for Level 3)
/plan
# Step 3: Explore design options for OAuth integration
/creative
# Step 4: Implement the feature based on the plan and design decisions
/build
# Step 5: Reflect on the implementation and document lessons learned
/reflect
# Step 6: Archive the completed task and documentation
/archive
Why Use cursor-memory-bank?
cursor-memory-bank offers several compelling advantages for developers working with AI assistants:
- Structured Development Workflow: It transforms ad-hoc coding into a coordinated, phase-based system, ensuring a logical progression from idea to completion.
- Token Optimization: Through hierarchical rule loading and progressive documentation, it significantly reduces token usage, leading to more efficient and cost-effective AI interactions.
- Persistent Context and Memory: The shared
memory-bank/directory ensures that critical context is preserved across commands, allowing the AI to maintain a consistent understanding of the project state. - Adaptive Guidance: Workflows adjust automatically based on task complexity (Levels 1-4), providing tailored guidance and documentation requirements.
- Native Cursor 2.0 Integration: Seamlessly integrates with Cursor's command feature, requiring no complex setup.
- Visual Process Maps: Clear visual representations for each development phase help in understanding and navigating the workflow.
- Documentation-Driven: Emphasizes comprehensive documentation throughout the process, from planning to archiving, improving project clarity and maintainability.
Links
For more detailed information, refer to the official documentation within the repository: