Cursor Memory Bank 🧠

Cursor Memory Bank est un système de gestion de projet autonome et structuré pour Cursor. Il remplace les systèmes de tâches complexes par une approche centrée sur le README.md, utilisé comme unique source de vérité pour la roadmap, l'installation et la documentation technique. L'agent Cursor utilise une règle dédiée pour maintenir ce fichier en permanence à jour, assurant une synchronisation parfaite entre le code et sa documentation.

Installation

Par défaut, l'installation est uniquement globale (elle déploie les compétences (skills) globales dans votre profil utilisateur).

Linux / macOS :

curl -fsSL https://raw.githubusercontent.com/hjamet/cursor-memory-bank/master/install.sh | bash

Windows (PowerShell) :

# Nécessite Git Bash (inclus avec Git for Windows)
& 'C:\Program Files\Git\bin\bash.exe' -c "curl -fsSL https://raw.githubusercontent.com/hjamet/cursor-memory-bank/master/install.sh | bash"

[!NOTE] Installation locale facultative : Pour installer également les règles et configurations locales (les dossiers .cursor/rules/, .agent/ et le .gitignore local) dans votre dépôt courant, ajoutez l'option --local (ou -l) :

• Linux / macOS : curl -fsSL https://raw.githubusercontent.com/hjamet/cursor-memory-bank/master/install.sh | bash -s -- --local
• Windows : & 'C:\Program Files\Git\bin\bash.exe' -c "curl -fsSL https://raw.githubusercontent.com/hjamet/cursor-memory-bank/master/install.sh | bash -s -- --local"

Description détaillée

Cœur du Système : La Memory Bank

Ce dépôt implémente le pattern "Memory Bank", une approche où la mémoire du projet n'est plus dispersée dans des contextes éphémères mais cristallisée dans des fichiers markdown structurés. Le README.md agit comme le "Master Record", la source de vérité absolue.

Flux de Travail Agentique

L'agent (Cursor/Antigravity) ne se contente pas de répondre aux questions ; il gère le projet.

1. Lecture : À chaque début de session, l'agent lit les règles (src/rules/*.md) pour comprendre son rôle.
2. Action : Il exécute les tâches définies dans la Roadmap du README.
3. Mise à jour : Il met à jour le README en temps réel pour refléter les progrès, garantissant qu'aucun contexte n'est perdu entre les sessions.

Le Rôle de l'Architecte

Une commande spécifique (/architect) active un mode de réflexion stratégique. L'Architecte ne code pas immédiatement ; il planifie, remet en question les besoins, et conçoit des solutions robustes avant de passer à l'exécution. C'est un partenaire de "Pair Programming" de haut niveau.

Direction Actuelle

Le projet se concentre actuellement sur :

• Refonte de la documentation : Migration vers des formats plus simples (.md) pour faciliter la maintenance.
• Rigueur linguistique : Imposition stricte du Français pour toutes les interactions et artefacts.
• Standardisation : Amélioration des scripts d'installation pour supporter ces nouveaux standards.

Principaux résultats

Documentation Index

Plan du repo

root/
├─ .cursor/              # Configuration Cursor (Règles MDC installées)
├─ src/                  # Code source
│  ├─ rules/            # Définitions des règles (Sources .md)
│  └─ skills/           # Compétences et agents standardisés (SKILL.md)
├─ install.sh           # Script d'installation
└─ README.md            # Source unique de vérité

Rôles des dossiers

• src/rules/ : Contient les règles sources en format Markdown standard (.md).
• src/skills/ : Contient les compétences et agents standardisés (architect, scout, build, audit, paper-writing, etc.).
• .cursor/rules/ : Destination des règles installées (converties en .mdc pour Cursor).

Scripts d'entrée principaux

Commandes Agent (Virtuelles)

Ces commandes sont définies par les règles installées :

Scripts exécutables secondaires & Utilitaires

Roadmap