Documentation Développeur — arka-deck
Audience : contributeur, développeur qui ajoute une route API, écrit un addon, branche un nouveau provider IA, lance les tests, prépare une release.
Parcours guidé recommandé
Section intitulée « Parcours guidé recommandé »- Comprendre l’architecture —
architecture/ - Repérer les contrats et les surfaces —
reference/ - Étendre arka-deck —
extension/ - Connaître les addons et providers déjà câblés —
addons-firstparty/,providers-firstparty/ - Adopter le workflow de contribution —
workflow/
Sommaire
Section intitulée « Sommaire »Architecture
Section intitulée « Architecture »architecture/ couvre les couches hexagonales, les ports inbound et outbound, la composition root, le bus d’événements, le pattern Materializer et le stockage.
Référence
Section intitulée « Référence »reference/ regroupe la liste des routes HTTP, la CLI, les variables d’environnement, les scripts CI et la mécanique projets/workspaces.
Extension
Section intitulée « Extension »extension/ réunit les tutoriels pas-à-pas pour écrire un addon, un provider, un worker ou un connecteur, ainsi que le contrat addon formel et le catalogue first-party.
Fiches first-party
Section intitulée « Fiches first-party »addons-firstparty/ documente chaque addon embarqué (cortex-lite, cortex-actions, memory-local, mission-guardian, squad-leader, squad-orchestration, notion-connect).
providers-firstparty/ documente chaque provider IA embarqué (claude_code, google-genai, codex_cli).
Workflow contributeur
Section intitulée « Workflow contributeur »workflow/ couvre clonage et premier lancement, tests, guide agent IA (working rules), GitNexus, gates CI, procédure de release et conventions (commits, PR, DCO).
Décisions d’architecture
Section intitulée « Décisions d’architecture »Les choix structurants sont documentés sous forme d’ADR.
Conventions transverses
Section intitulée « Conventions transverses »→ Convention de dépôt fédéré pour addons et workers
État de la documentation
Section intitulée « État de la documentation »Le squelette est en place. Les contenus stables existants sont migrés depuis l’ancienne arborescence (docs/dev/architecture.md, docs/dev/events-guide.md, etc.) au cours du lot P3. Les contenus manquants (référence API HTTP exhaustive, tutoriels d’extension complets) arrivent au lot P4.
Suivez main ou le CHANGELOG racine pour le détail.