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 présente l'architecture globale du harness — ses trois couches d'exécution (Nuxt, Python, scripts), leur articulation autour de la base PostgreSQL unique, et le cycle de vie complet d'une demande jusqu'au déploiement.
Couche données de Synedre OS
Ce chapitre décrit l'architecture de persistance du harness Synedre OS : une base PostgreSQL unique, trois chemins d'accès distincts (Nuxt, Python agentique, Drizzle ORM), et les conventions de nommage qui organisent les familles de tables CodeMyShop et Synedre.
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 et runs
Comment le harness Synedre orchestre CodeMyShop : agents contre automates, planification, navigateur distribué et boucle nocturne d'auto-maintenance de la documentation.
Hub — Interface d'administration Synedre OS
Description de l'app Nuxt mothership-app, son architecture en layers modulaires et la carte complète des pages /hub/* qu'elle expose.
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 de Synedre OS et ses tenants, notamment l'asymétrie entre ./deploy (preprod/IA) et ./ship (production, gaté par flotte), le dispatcher YAML, le pattern build-host sans build VPS, et les doctrines associées aux secrets et commits.
Catalogue des automatismes du harness Synedre
Comment Synedre orchestre CodeMyShop via des agents, des files de tâches et des garde-fous automatiques, du courrier entrant jusqu'au déploiement.
Skills, agents & hooks — harness agentique Synedre OS
Ce chapitre décrit l'architecture du harness Claude Code de synedre-os : les skills invocables, les sous-agents délégables et les hooks d'événements qui orchestrent la doctrine (garde-fous, injection mémoire, commit-en-flux).