🇬🇧 English version

Architecture Decision Records

Archives datées et immuables des décisions structurantes d'Orkeon. Un ADR remplacé conserve son texte d'origine ; celui qui le remplace pointe en retour.

Pourquoi la numérotation commence-t-elle à 002 ? Il n'existe pas d'ADR-001 — la première décision enregistrée en ADR a reçu le numéro 002 et le trou a été conservé plutôt que de renuméroter, pour garder stables les références croisées existantes.

ADR	Décision	Statut
ADR-002	Orkeon.Tools.Abstractions en shared kernel (l'exception Infrastructure → Tools.Abstractions)	Accepté
ADR-003	Shared kernels secondaires : Application → Analysis.Abstractions, Infrastructure → Analysis	Accepté
ADR-004	Les jumeaux de nommage scripting, documentés sans renommage	Remplacé par l'ADR-007
ADR-005	La famille Tools.* hétérogène (Tools.Web/Tools.EventHub → Application)	Accepté
ADR-006	Le sous-système src/rag/ : shared kernel Orkeon.Rag.Abstractions, anciens namespaces RAG retirés sans shims	Accepté
ADR-007	Décision D3 : Orkeon.Cli.Scripting renommé en Orkeon.Cli.Commands.Scripting avant toute publication NuGet	Accepté
ADR-008	Un chemin physique n'est jamais un chemin virtuel : les runners montent sous un nom, les montages d'infrastructure sont invisibles aux agents	Accepté — son RunnerMounts est devenu RunnerVirtualRoots (ADR-009) ; la décision tient, le type a bougé
ADR-009	Une constante sur laquelle deux projets doivent s'accorder vit dans un satellite sans dependance, pas dans une copie manuelle gardee par un test de drift	Accepte
ADR-010	L'interop Microsoft Agent Framework est un paquet séparé (Orkeon.Interop.AgentFramework), dans les deux sens : un crew comme AIAgent, un AIAgent comme cerveau ou outil d'un agent Orkeon ; le contexte initial atteint enfin les prompts	Accepté
ADR-011	Les runners exportent OpenTelemetry selon le contrat standard (OTEL_EXPORTER_OTLP_ENDPOINT) ; Orkeon.Hosting.Aspire les ajoute à un AppHost ; le dashboard Aspire est la surface d'observabilité cross-platform et aucun Studio web ne sera construit	Accepté
ADR — RaggableTree	Graphe sémantique stratifié à 5 niveaux plus arêtes via Tree-sitter (non numéroté — vit avec son guide d'architecture ; amendé le 2026-08-18)	Accepté