Étendre arka-deck
Audience : développeur qui veut ajouter une capacité à arka-deck — un addon, un provider IA, un worker headless, un connecteur externe.
Sommaire
Section intitulée « Sommaire »Tutoriels (parcours pas-à-pas)
Section intitulée « Tutoriels (parcours pas-à-pas) »ecrire-un-addon.md— créer un addon first-party de zéro : manifest, register, abonnement EventBus, augmenter le contexte avant-tour, tests, branchement en compositionecrire-un-provider.md— brancher un nouveau provider IA : SDK, chat runtime, gestion des clés, registryecrire-un-worker.md— concevoir un worker headless 1-shot : manifest, prompt source, runtime, intégration depuis un addon parentecrire-un-connecteur.md— ajouter un connecteur externe (Notion, Zapier, etc.) : OAuth, actions, audit trail
Référence
Section intitulée « Référence »contrat-addon.md— schéma manifest formel, dépendances disponibles, API EventBus, catalogue d’événements, conventions de stockagecatalogue-addons-firstparty.md— synthèse des addons embarqués et lien vers leur fiche
Avant de commencer
Section intitulée « Avant de commencer »- Lire d’abord
../architecture/overview.mdpour comprendre les couches. - Consulter les ADR pertinents : 0002 Contrat addon pour les addons, 0003 Materializer pour les artefacts agentiques, 0006 Anti-SSRF pour les providers.
- Lancer les tests existants pour confirmer un environnement sain (
npm test).
État de la documentation
Section intitulée « État de la documentation »Le squelette est en place. ecrire-un-addon.md et contrat-addon.md sont migrés depuis docs/dev/addons/guide-creation-addon.md et docs/dev/addons/contrat-addon.md au lot P3. Les autres tutoriels sont rédigés au lot P4.