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

This repository profile is provided by osrepos.com, an open source repository discovery platform.

Source: osrepos.com
Repository profile: https://osrepos.com/repo/vanzan01-cursor-memory-bank
Generated for open source discovery and AI-assisted research.

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.

GitHub: https://github.com/vanzan01/cursor-memory-bank
OSRepos URL: https://osrepos.com/repo/vanzan01-cursor-memory-bank

## 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.

## Topics

- AI Development
- Cursor Editor
- Workflow Automation
- LLM Tools
- Software Engineering
- Productivity
- Markdown
- Mermaid

## Repository Information

Last analyzed by OSRepos: Tue Dec 09 2025 08:01:08 GMT+0000 (Western European Standard Time)
Detail views: 4
GitHub clicks: 10

## Safety Notice

OSRepos shares public repositories for knowledge and discovery only. Review source code, dependencies, licenses, and security implications before running or installing anything.

## Content

## 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:

bash
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:

bash
# 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](https://github.com/vanzan01/cursor-memory-bank/blob/main/.cursor/commands/README.md){:target="_blank"}
*   [Commands Migration Guide](https://github.com/vanzan01/cursor-memory-bank/blob/main/COMMANDS_MIGRATION.md){:target="_blank"}
*   [Memory Bank Optimizations](https://github.com/vanzan01/cursor-memory-bank/blob/main/MEMORY_BANK_OPTIMIZATIONS.md){:target="_blank"}
*   [Release Notes](https://github.com/vanzan01/cursor-memory-bank/blob/main/RELEASE_NOTES.md){:target="_blank"}
*   [Memory Bank Upgrade Guide](https://github.com/vanzan01/cursor-memory-bank/blob/main/memory_bank_upgrade_guide.md){:target="_blank"}
*   [CREATIVE Mode and Claude's "Think" Tool](https://github.com/vanzan01/cursor-memory-bank/blob/main/creative_mode_think_tool.md){:target="_blank"}
*   [Anthropic's Claude "Think" tool methodology blog](https://www.anthropic.com/engineering/claude-think-tool){:target="_blank"}