Architecture — arka-deck
Audience : développeur qui veut comprendre comment arka-deck est structuré, où vit la logique métier, comment les composants communiquent et où ajouter du code.
Sommaire
Section intitulée « Sommaire »overview.md— vue d’ensemble : couches hexagonales, schéma, règles d’import ESLint, stack techniqueports-inbound.md— liste exhaustive des ports inbound (driving) ; rôle, méthodes principalesports-outbound.md— liste exhaustive des ports outbound (driven) ; rôle, implémentations typiquescomposition-root.md—createCoreContainer,createWebContainer, ordre d’instanciation, branchement des addonsevent-bus.md— publication et abonnement, conventions de nommage d’événements, patterns et anti-patternsmaterializers.md— pattern de matérialisation d’artefacts agentiques (agents, hooks, skills) en fichiers locauxstockage.md— SQLite local, filesystem allowlist, secrets AES-256-GCM, anti-symlink
Principes
Section intitulée « Principes »- Le
core/est isolé : il ne connaît ni l’I/O, ni la composition, ni les addons (cf. ADR 0001). - Les addons consomment des ports core ; ils ne dépendent jamais les uns des autres (cf. ADR 0002).
- Les artefacts agentiques produits par arka-deck passent par des Materializers, jamais par des écritures directes (cf. ADR 0003).
État de la documentation
Section intitulée « État de la documentation »Le squelette est en place. Le contenu de overview.md est migré depuis docs/dev/architecture.md au lot P3. Les autres fichiers sont rédigés au lot P4 à partir du code source et des résultats de l’audit technique.