Chapitres
DOC-04 / Référence technique
Documentation technique
Le harness de Synedre, en profondeur. Une référence publique et assainie : comment la couche de 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 Synedre OS
Cette page introduit l'architecture du harness de Synedre OS en décrivant ses trois couches d'exécution (Nuxt mothership-app, Python synedre/, scripts bin/), leur articulation autour de la base PostgreSQL unique vaisseau_mere_ac, le cycle de vie d'une demande et les principes de gouvernance du système.
Couche données de Synedre OS
Ce chapitre décrit l'architecture data du harness Synedre OS : base PostgreSQL unique `ac_hub`, trois chemins d'accès (Nuxt, Python agentique, Drizzle ORM), familles de tables par préfixe et conventions de nommage reliant CodeMyShop et le cockpit agentique.
Le cœur agentique du harness
Comment le harness Synedre (qui orchestre CodeMyShop) transforme un email en action : classification, lancement isolé via pseudo-terminal, personas d'agents, routage IA et orchestration déploiement/QA.
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 et runs : couche d'exécution non-conversationnelle
Cette page décrit l'architecture d'exécution déterministe de Synedre OS : façades Python, enrobage cron, registre des automates et frontière entre runs et tâches agents.
Le Hub : cockpit d'administration du harness
Architecture du cockpit privé du harness Synedre : couches Nuxt, navigation, familles d'endpoints, authentification, consoles et gardes de livraison des secrets.
Inbox hub et Atlas Inbox : deux pipelines IMAP distincts
Ce chapitre décrit les deux pipelines de collecte IMAP de Synedre, l'un alimentant la boîte personnelle vers `ps_ac_inbox_emails` via classification heuristique, l'autre traitant la boîte agentique CodeMyShop pour déclencher des actions via classification LLM.
Mémoire et apprentissage du harness Synedre OS
Ce chapitre décrit l'architecture à trois niveaux de mémoire de Synedre (réflexe, Zettelkasten, vectoriel pgvector), les automates d'indexation associés et la boucle d'apprentissage par cicatrices et leçons.
Déploiement & infrastructure de Synedre OS
Ce chapitre décrit le pipeline de mise en ligne de Synedre OS et de ses tenants, en détaillant l'asymétrie entre `./deploy` (preprod, piloté par l'IA) et `./ship` (production, gaté par la flotte `auto_ship_allowed`), ainsi que les mécanismes associés comme le drift auto-apply, les smokes post-déploiement et les exceptions founder sans preprod.
Catalogue des façades du harness
Catalogue des points d'entrée du harness Synedre (scripts, hooks, files de travail), organisé par famille, avec le mode d'invocation de chacun.
Skills, agents et hooks du harness Synedre OS
Ce chapitre décrit l'architecture agentique de `synedre-os` : catalogue des skills, agents délégables et hooks d'événements qui orchestrent la doctrine du harness Claude Code.