CodeAlmanac - un wiki de codebase pour les agents de codage IA

• Un wiki vivant qui enregistre les décisions, flux, invariants et pièges (gotchas) que le code seul ne peut pas contenir, afin de fournir du contexte aux agents IA
  • Il documente pourquoi le système a sa forme actuelle, ce qui s'est cassé par le passé et comment les workflows traversent les fichiers et services
• Le wiki est stocké sous forme de fichiers Markdown dans le dépôt, puis, après indexation locale, peut être relu dans Git comme du code
• Les agents et les humains utilisent les mêmes commandes de lecture locales : search, show, topics, health, validate
  • Prise en charge de la recherche par chemin de fichier avec search --mentions src/checkout/, et consultation d'un autre wiki avec --wiki <name>
• Les tâches du cycle de vie qui mettent le wiki à jour en continu s'exécutent via trois agents explicites : build / ingest / garden
  • Utilise le Yoke SDK, publié séparément
  • ingest : intègre au wiki des fichiers, répertoires, diff Git, plages de commits, PR/issues GitHub, URL et transcriptions d'agents locaux
  • garden : nettoie les pages obsolètes, liens faibles, topics, pages en doublon, etc.
• Trois tâches d'arrière-plan locales macOS launchd sont fournies pour éviter d'avoir à mémoriser les commandes de maintenance
  • Sync (toutes les 5 heures) : analyse les conversations récentes Codex/Claude et les met en file pour une tâche d'ingestion dans le wiki concerné
  • Garden (toutes les 24 heures) : examine les connaissances vieillissantes, dupliquées ou mal reliées dans tous les wikis enregistrés
  • Update (toutes les 24 heures) : met automatiquement à jour le CLI uniquement à des moments sûrs, et saute l'opération si des tâches de cycle de vie sont en cours
• Exécution entièrement locale, sans service hébergé ni synchronisation cloud ; les logs sont stockés dans ~/.codealmanac/logs/
• L'historique d'exécution est conservé sous forme d'enregistrements de jobs locaux, consultables même après fermeture du terminal
  • jobs, jobs show, jobs logs, jobs attach, jobs cancel
  • Intégration possible avec des scripts via --json
• Le provider utilise almanac-yoke comme point d'entrée unique ; Codex utilise app-server, Claude le Python Agent SDK
  • Réutilise les sessions OAuth existantes de Codex/Claude Code
• Le visualiseur local lancé avec serve est en lecture seule et rend la navigation entre pages, recherche, topics, backlinks et références de fichiers
• Les agents du cycle de vie fonctionnent avec de larges permissions non interactives sur le système de fichiers
  • Le dossier almanac/ n'est pas une sandbox OS mais une politique d'instructions/commits ; exécution recommandée uniquement dans des dépôts de confiance
• La télémétrie est optionnelle. Aucun code, chemin, prompt, transcription ni identifiant n'est transmis ; GeoIP est désactivé, et DO_NOT_TRACK=1 permet aussi de la bloquer
• Licence Apache-2.0