cursor-memory-bank: Structured AI Development Workflow with Cursor 2.0 Commands

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 /creative command'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 .cursor folder 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.

1. 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
2. Start with /van to initialize your project, for example:

   /van Initialize project for adding user authentication feature
       

3. 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:

• Commands Documentation
• Commands Migration Guide
• Memory Bank Optimizations
• Release Notes
• Memory Bank Upgrade Guide
• CREATIVE Mode and Claude's "Think" Tool
• Anthropic's Claude "Think" tool methodology blog