Serena Memory - Mémoire Projet

Objectif

Maintenir une mémoire persistante du projet MyGGV GPS entre les sessions : décisions architecturales, patterns utilisés, problèmes résolus, et contexte important.

Périmètre

Inclus

•Stocker des décisions architecturales
•Mémoriser les patterns et conventions du projet
•Garder trace des bugs résolus et solutions
•Conserver le contexte entre sessions

Exclus

•Exploration de code → utiliser serena-explore
•Édition de code → utiliser serena-edit
•Documentation formelle → utiliser archon-project

Outils Disponibles

1. store_memory

Stocker une information :

javascript

mcp__serena__store_memory({
  key: "routing_service",
  value: "OSRM via router.project-osrm.org",
  category: "architecture",
  tags: ["navigation", "api", "routing"],
});

2. recall_memory

Récupérer une information :

javascript

mcp__serena__recall_memory({
  key: "routing_service",
});
// ou par catégorie
mcp__serena__recall_memory({
  category: "architecture",
});

3. list_memories

Lister toutes les mémoires :

javascript

mcp__serena__list_memories({
  category: "bugs", // optionnel, filtre par catégorie
});

4. delete_memory

Supprimer une mémoire obsolète :

javascript

mcp__serena__delete_memory({
  key: "old_pattern",
});

Catégories Recommandées

architecture

Décisions structurelles du projet :

javascript

mcp__serena__store_memory({
  key: "state_management",
  value: "React hooks + useContext, pas de Redux. TanStack Query pour les données serveur.",
  category: "architecture",
});

patterns

Patterns et conventions de code :

javascript

mcp__serena__store_memory({
  key: "hook_naming",
  value: "Tous les hooks custom commencent par 'use' et sont dans src/hooks/",
  category: "patterns",
});

bugs

Bugs résolus et solutions :

javascript

mcp__serena__store_memory({
  key: "ios_orientation_permission",
  value: "iOS 13+ requiert DeviceOrientationEvent.requestPermission() appelé sur user gesture",
  category: "bugs",
  tags: ["ios", "compass", "permission"],
});

decisions

Choix techniques et leur justification :

javascript

mcp__serena__store_memory({
  key: "why_turf_not_openlayers",
  value:
    "Turf.js choisi pour les calculs géo car plus léger (~50KB vs ~500KB pour OpenLayers). MapLibre gère déjà le rendu.",
  category: "decisions",
});

context

Contexte projet général :

javascript

mcp__serena__store_memory({
  key: "target_users",
  value:
    "Résidents et visiteurs de Garden Grove Village, Philippines. Accès via QR code à l'entrée.",
  category: "context",
});

Mémoires Essentielles pour MyGGV GPS

Architecture

javascript

// Stack technique
{ key: "tech_stack", value: "React 19 + Vite + MapLibre GL + Supabase", category: "architecture" }

// Structure navigation
{ key: "navigation_states", value: "gps-permission → welcome → orientation-permission → navigating → arrived → exit-complete", category: "architecture" }

// Sources de données
{ key: "data_sources", value: "Supabase pour locations/POIs, OSRM pour routing, OSM/Esri pour tuiles", category: "architecture" }

Patterns

javascript

// Hooks
{ key: "map_hooks", value: "useMapConfig (config), useRouteManager (routes), useNavigationState (états), useMapTransitions (animations)", category: "patterns" }

// Composants
{ key: "modal_pattern", value: "Tous les modals utilisent Radix Dialog via src/components/ui/dialog.jsx", category: "patterns" }

Bugs Connus

javascript

// iOS
{ key: "ios_geolocation", value: "Requiert HTTPS. Utiliser GeolocateControl de MapLibre, pas navigator.geolocation directement.", category: "bugs" }

// Race condition
{ key: "style_loading", value: "Attendre isStyleLoaded() avant d'ajouter des sources/layers custom", category: "bugs" }

Workflow

Début de session

code

1. check_onboarding_performed → Vérifier si Serena est initialisé
2. list_memories → Voir le contexte existant
3. recall_memory(category: "context") → Charger le contexte projet

Après une décision importante

code

1. Documenter la décision
2. store_memory avec catégorie appropriée
3. Ajouter des tags pour faciliter la recherche

Après résolution d'un bug

code

1. store_memory avec category: "bugs"
2. Inclure : symptôme, cause, solution
3. Tagger avec les technologies concernées

Bonnes Pratiques

•Clés descriptives : ios_orientation_permission plutôt que bug1
•Valeurs complètes : Inclure le contexte et la solution, pas juste le problème
•Tags pertinents : Faciliter la recherche future
•Catégorisation cohérente : Utiliser les catégories standard

Exemple Complet

javascript

// Après avoir résolu un bug de routing
mcp__serena__store_memory({
  key: "route_recalculation_threshold",
  value: `
    Problème: Route recalculée trop fréquemment sur petits écarts GPS.
    Cause: Seuil de déviation trop sensible (10m).
    Solution: Augmenté à 30m et ajouté debounce de 2s.
    Fichier: src/lib/navigation.js, fonction checkRouteDeviation
  `,
  category: "bugs",
  tags: ["routing", "gps", "performance", "navigation"],
});