System Architecture

reference template — architecture diagram pattern

Input Sources
💬 Slack
🐙 GitHub
📧 Email
incoming events
Gateway Layer
Router
Routes messages to agents via resolveRoute()
HTTP Server
Plugin routes + handlers for webhooks and API
pipeline entry
Processing Pipeline
no LLM
LLM call
embedding
DB write
STEP 0
Pre-filter
Allowlist, bots,
dedup check
→
STEP 1
Relevance
Cheap LLM
boolean check
→
STEP 2
Classify
JSON schema
validated output
→
STEP 3
Embed
Vector embedding
STEP 5
Enrich
User resolution
→
STEP 4
Cluster
Cosine similarity
+ INSERT
stored and queryable
Database
feedback_items
Classification, embedding, cluster assignment, source dedup
clusters
Centroid vectors, trends, ticket links, severity rollup
consumed by
Agent Tools
  • search semantic vector search
  • clusters browse and filter
  • stats aggregate metrics
Actions
  • Create tickets from clusters
  • Notify customers on ship
  • Generate release notes
Dashboard
  • Metrics overview
  • Feedback stream
  • NL chat interface
Multi-tenant — Each agent gets an isolated database at {agentDir}/intelligence/feedback.db with per-agent config overlay and credential isolation.