Archon Project Management - MyGGV GPS

Objectif

Gérer le projet MyGGV GPS dans Archon : documentation, tâches, recherche dans la knowledge base, et suivi de version.

Périmètre

Inclus

• Gestion de projet (création, mise à jour)
• Gestion des tâches (todo, doing, review, done)
• Documentation de projet (specs, notes, guides)
• Recherche RAG dans la knowledge base
• Exemples de code depuis la documentation

Exclus

• Opérations base de données → utiliser supabase-database
• Déploiement → utiliser netlify-deploy
• Code de navigation → utiliser maplibre-navigation

IMPORTANT : Recherche de Documentation

NE PAS utiliser mcp__supabase__search_docs

Toujours utiliser Archon pour la recherche de documentation :

// CORRECT - Utiliser Archon
mcp__archon__rag_search_knowledge_base({
  query: "vector search pgvector",
  match_count: 5,
});

// INCORRECT - Ne pas utiliser directement
// mcp__supabase__search_docs(...)  // NON !

Sources Disponibles

Pour voir les sources de documentation indexées :

mcp__archon__rag_get_available_sources();

Sources typiquement disponibles :

• Documentation Supabase
• Documentation MapLibre GL
• Documentation React
• Documentation Vite

Workflow de Gestion de Projet

1. Trouver le projet

mcp__archon__find_projects({
  query: "ggv gps",
});

2. Créer/Mettre à jour le projet

mcp__archon__manage_project({
  action: "create",
  title: "MyGGV GPS",
  description: "Application GPS web pour Garden Grove Village",
  github_repo: "https://github.com/user/new-ggv-gps",
});

3. Gérer les tâches

// Créer une tâche
mcp__archon__manage_task({
  action: "create",
  project_id: "<project-id>",
  title: "Implémenter la fonctionnalité",
  description: "Description de la tâche à implémenter",
  status: "todo",
  feature: "navigation",
});

// Mettre à jour le statut
mcp__archon__manage_task({
  action: "update",
  task_id: "<task-id>",
  status: "doing",
});

Recherche RAG

Requêtes courtes et focalisées

// BON - Court et précis
mcp__archon__rag_search_knowledge_base({
  query: "maplibre markers",
  match_count: 5,
});

// MAUVAIS - Trop long
// query: "comment ajouter des markers personnalisés sur une carte maplibre avec des icônes SVG..."

Recherche d'exemples de code

mcp__archon__rag_search_code_examples({
  query: "React geolocation hook",
  match_count: 3,
});

Filtrer par source

// 1. Obtenir les sources
const sources = mcp__archon__rag_get_available_sources();

// 2. Filtrer la recherche
mcp__archon__rag_search_knowledge_base({
  query: "maplibre markers",
  source_id: "src_maplibre_xxx", // ID de la source MapLibre
  match_count: 5,
});

Lire une page complète

mcp__archon__rag_read_full_page({
  url: "https://docs.maplibre.org/guides/navigation/",
});

Documentation de Projet

Créer un document

mcp__archon__manage_document({
  action: "create",
  project_id: "<project-id>",
  title: "Architecture GPS Navigation",
  document_type: "spec",
  content: {
    overview: "...",
    components: ["..."],
    data_flow: "...",
  },
  tags: ["architecture", "navigation"],
});

Types de documents

• spec - Spécifications techniques
• design - Documents de conception
• note - Notes générales
• prp - Product Requirements
• api - Documentation API
• guide - Guides d'utilisation

Statuts de Tâche

todo → doing → review → done

• todo : À faire
• doing : En cours (1 seule tâche à la fois)
• review : En attente de validation
• done : Terminé

Bonnes Pratiques

1. Queries RAG courtes : 2-5 mots-clés max
2. Une tâche "doing" à la fois : Focus sur une seule chose
3. Documenter les décisions : Créer des documents pour les choix architecturaux
4. Versionner : Utiliser manage_version pour les changements importants