Files
khadhroony-bot3/docs/decisions/DOCUMENT_ARCHIVE_SELECTION_POLICY.md
2026-07-30 17:50:29 +02:00

3.3 KiB
Raw Blame History

Politique de sélection des archives documentaires

1. Objet

Cette politique définit les fichiers historiques qui peuvent être copiés depuis larchive complète de khadhroony-bot2 vers olddocs/archivekbot2/.

La sélection repose sur la fonction documentaire du fichier, et non sur son extension ni uniquement sur son emplacement.

2. Principe général

olddocs/archivekbot2/ est une archive documentaire historique et non une copie partielle du workspace exécutable.

Larchive complète de bot2 reste la référence pour le code source, les fixtures, les configurations dexécution et les artefacts nécessaires à la compilation ou aux tests.

3. Fichiers à conserver

Les catégories suivantes peuvent être conservées lorsquelles présentent une valeur historique, normative, architecturale ou décisionnelle :

  • documents Markdown racine, sous docs/, sous prompts/ et dans les anciennes crates ;
  • changelogs, roadmaps, règles, audits, plans, rapports, guides et décisions ;
  • matrices JSON décrivant une couverture, un contrat, une validation ou un inventaire ;
  • IDL archivées servant de références pour la conception manuelle des futurs décodeurs, exécuteurs, matérialisateurs, matrices et tests ;
  • schémas publics décrivant formellement un contrat de configuration ;
  • exemples de configuration destinés aux utilisateurs ou aux opérateurs ;
  • autres fichiers non exécutables dont la valeur documentaire est explicitement démontrée.

4. Fichiers à exclure

Les catégories suivantes ne doivent pas être copiées dans larchive documentaire :

  • code source et fichiers internes placés sous src/, même lorsquils utilisent une extension documentaire, sauf décision explicite motivée ;
  • fixtures de tests, snapshots et réponses RPC enregistrées ;
  • manifests et configurations nécessaires au build ou au lancement de lancienne application ;
  • fichiers Tauri, npm, TypeScript et capabilities servant à lexécution ;
  • bases de données, clés, preuves, données privées et fichiers temporaires ;
  • artefacts générés ou reconstructibles sans valeur documentaire autonome.

5. Cas explicitement conservés

Les fichiers suivants sont conservés car leur fonction est documentaire :

config/example.config.json
config/schema.config.json
docs/*_MATRIX.json
idls/*.json

example.config.json illustre la configuration utilisateur historique complète. schema.config.json formalise le contrat de cette configuration. Les matrices documentent les périmètres techniques et les validations. Les IDL sont des références archivées et ne sont pas chargées dynamiquement par le code de production.

6. Cas explicitement exclus

Les fichiers suivants sont exclus car ils relèvent de lexécution ou des tests :

kb_app_demo/capabilities/default.json
kb_app_demo/package.json
kb_app_demo/tauri.conf.json
kb_app_demo/tsconfig.json
kb_rpc/tests/fixtures/*.json
kb_store_core/src/**
kb_store_pg/src/**

7. Évolution de larchive

Tout ajout futur à olddocs/archivekbot2/ doit être évalué avec cette politique. En cas dambiguïté, le fichier nest pas copié tant que sa valeur documentaire autonome nest pas démontrée.