Chapitres
DOC-05 / Référence technique
Documentation technique
Le harness de Synedre, en profondeur. Une référence publique et assainie : comment la couche données, le cœur agentique, les chantiers, les automates, le hub, l’email, la mémoire, le déploiement et les façades s’articulent réellement.
11 chapitres
L’anatomie de Shyrka — voir le corps d’abordBoucle nocturne
Le système maintient sa propre documentation
Chaque nuit, le harness inspecte son propre état : dérive doc↔code, bilan de santé, régénération gatée. Ce terminal restitue le log réel de la dernière session.
Chapitres
Vue d'ensemble du harness agentique
Le harness transforme une demande (courriel, console, cron) en action déployée en enchaînant classification, spawn LLM via pseudo-TTY, validation qualité à deux niveaux et boucle d'apprentissage, le tout sans état métier hors base de données.
La couche données
Décrit l'architecture données de Synedre OS : une base PostgreSQL unique (un composant interne/un composant interne), les trois chemins d'accès (Nuxt/Nitro, Python agentique, Drizzle ORM DDL), les familles de tables par préfixe et les conventions de nommage associées.
Le cœur agentique : Atlas et les agents
Décrit l'architecture du moteur agentique : classification LLM des emails entrants, spawn headless de Claude Code via pseudo-TTY, injection des personas agents et orchestration post-spawn (deploy, QA, récap).
Chantiers, travaux & tâches — modèle de données et API
Décrit la hiérarchie chantier/travail/tâche de Synedre OS, le modèle de données DB, les statuts/scopes canoniques et l'API Python associée.
Automates, crons & runs
Décrit la couche d'exécution non-conversationnelle de Synedre OS : les 209 façades Python, leur enrobage cron, le registre un composant interne et la frontière entre doctrine run et unité agent.
Le Hub (/hub/*)
Présentation de l'interface d'administration privée Synedre OS (mothership-app), son architecture en couches Nuxt, la carte de ses modules et pages, ainsi que le système d'authentification et de session.
Inbox hub & Atlas Inbox — deux pipelines email
Décrit les deux pipelines IMAP→DB du harness (contact@ trié pour le hub, atlas@ déclencheur d'actions agentiques), la façade d'envoi sortant et les doctrines bloquantes associées (scan AV, zéro contact client direct).
Mémoire & apprentissage — architecture à trois niveaux
Ce chapitre décrit les trois niveaux de mémoire du harness Synedre OS (réflexe, Zettelkasten, vectoriel pgvector), les automates d'indexation associés et la boucle de capitalisation des erreurs en règles réutilisables.
Déploiement & infrastructure
Décrit le pipeline de mise en ligne Synedre OS : asymétrie entre ./deploy (IA, preprod) et ./ship (Alex, production), le dispatcher YAML, le pattern build-host sans build VPS, et les règles associées (secrets, commit-avant-deploy, drift, smoke).
Catalogue des façades & entrypoints Synedre OS
Recense et décrit l'ensemble des points d'entrée exécutables du harness agentique (synedre/*.py et bin/*) avec leur famille, rôle et mode d'invocation, pour permettre à un ingénieur de s'orienter rapidement dans le dépôt.
Skills, agents & hooks — harness agentique Synedre OS
Décrit le câblage complet du harness Claude Code de synedre-os : skills disponibles, sous-agents délégables et hooks d'événements qui imposent la doctrine commit-en-flux, garde-fous prod/email et injection mémoire.