How cakmakg/agentic-brain works
agentic-brain verbindet berechtigungsbewusste Wissensaufnahme und -suche mit agentischer Automatisierung, die vor jeder Außenwirkung auf menschliche Freigabe wartet. Der zentrale Nutzerpfad führt von einer Besprechungsnotiz über ACL-gefilterte Extraktion und geprüften Entwurf bis zur Freigabe und Ticketaktion. HTTP und CLI sind Kanäle zum selben Kern; daneben stehen Beispiel-Domäne, persistente Kontextadapter und domänenübergreifende Messungen. Die README und ausgewählte Quellen belegen die gezeigten Übergänge; für nicht eingesehene Module sind unsichere interne Aufrufe ausgelassen.
Main entry points: runner.js Workflow-Runner · server.js HTTP-Kanal · policy.js Policy-Evals · synchronisation.js Synchronisierung
Components 28
Kanäle & Governance
- HTTP-Kanal
src/adapters/http/server.js - Fragen-Kanal
src/bin/fragen.js - Authentifizierung
src/kernel/governance/auth.js - Event-Bus
src/kernel/governance/eventBus.js - Identitätsauflösung
src/kernel/governance/identitaet/index.js - Fixture-Verzeichnis
src/kernel/governance/identitaet/fixtures.js
Kontext & Quellen
- Notizlaufwerk
src/domains/besprechung/connectors/notizlaufwerk.js - Synchronisierung
src/kernel/connectors/synchronisation.js - Dokument-Ingest
src/kernel/context/ingest/pipeline.js - ACL-Envelope
src/kernel/context/envelope.js - Chunk-Speicher-Port
src/kernel/context/store/index.js - Berechtigungsfilter
src/kernel/retrieval/filter.js
Besprechungsworkflow
- Besprechungsdomäne
src/domains/besprechung/domain.js - Aktionspunkte extrahieren
src/domains/besprechung/agents/extrahierer.js - Entwurfsvertrag
src/domains/besprechung/vertrag.js - Entwurf prüfen
src/domains/besprechung/agents/pruefer.js - Ticketentwurf
src/domains/besprechung/agents/entwurf.js - Ticketdienst
src/domains/besprechung/agents/ticketdienst.js - Aktions-Whitelist
src/domains/besprechung/actions.js
Agentenkern
- Workflow-Runner
src/kernel/agent/runner.js - Deterministisches Routing
src/kernel/agent/routing.js - Genehmigungs-Checkpoint
src/kernel/agent/build.js - Wartende Aktionen
src/kernel/action/queue.js
Messung
- Policy-Evals
evals/runners/policy.js - Domänen-Eval-Adapter
evals/domains/index.js - Metriken
evals/metrics/index.js
Other components
- Mensch
- LLM-Anbieter
Connections 32
- Mensch → HTTP-Kanal: startet / genehmigt
- Mensch → Fragen-Kanal: fragt / entscheidet
- HTTP-Kanal → Authentifizierung: authentifiziert
- HTTP-Kanal → Workflow-Runner: startet Workflow
- HTTP-Kanal → Genehmigungs-Checkpoint: leitet Freigabe
- Workflow-Runner → Event-Bus: sendet Fortschritt
- HTTP-Kanal → Event-Bus: streamt Ereignisse
- Fragen-Kanal → Identitätsauflösung: löst Nachweis auf
- Identitätsauflösung → Fixture-Verzeichnis: fragt Verzeichnis
- Fragen-Kanal → Synchronisierung: synchronisiert
- Synchronisierung → Notizlaufwerk: holt Snapshot
- Synchronisierung → Dokument-Ingest: übergibt Dokumente
- Dokument-Ingest → ACL-Envelope: vererbt ACL
- Dokument-Ingest → Chunk-Speicher-Port: schreibt Chunks
- Workflow-Runner → Besprechungsdomäne: führt Domänenworkflow
- Besprechungsdomäne → Deterministisches Routing: konfiguriert Routing
- Deterministisches Routing → LLM-Anbieter: fragt Routing
- Workflow-Runner → Aktionspunkte extrahieren: steuert Extraktion
- Aktionspunkte extrahieren → Chunk-Speicher-Port: sucht mit Principal
- Chunk-Speicher-Port → Berechtigungsfilter: kompiliert ACL-Filter
- Aktionspunkte extrahieren → Entwurf prüfen: übergibt Aktionspunkte
- Entwurf prüfen → Entwurfsvertrag: prüft Vertrag
- Workflow-Runner → Ticketentwurf: steuert Entwurf
- Workflow-Runner → Genehmigungs-Checkpoint: wartet auf Mensch
- Genehmigungs-Checkpoint → Wartende Aktionen: reiht nach Freigabe ein
- Workflow-Runner → Ticketdienst: steuert Zustellung
- Ticketdienst → Aktions-Whitelist: nutzt erlaubte Aktionen
- Workflow-Runner → LLM-Anbieter: ruft Modell über Agenten
- Policy-Evals → Domänen-Eval-Adapter: lädt Adapter
- Policy-Evals → Workflow-Runner: misst Workflowläufe
- Policy-Evals → Synchronisierung: misst Synchronisierung
- Policy-Evals → Metriken: berechnet Kennzahlen