synlynk โ€” Full System Architecture

Locked design decisions as of 2026-06-14 ยท Two-spec plan

CONTROL PLANE

synlynk TUI

๐Ÿ  Home โ€” Hybrid Workgroup status
๐Ÿ“‹ Board โ€” Arc / Phase / Epic / Story kanban
๐Ÿค– Agents โ€” capability scores, quota, active stories
๐Ÿ’ฐ Costs โ€” burn rate, budget runway
๐Ÿ”” Sentinel โ€” alerts, flatline, stall, blocker
$ synlynk โ† attach
Ctrl+D / d โ† detach (daemon runs)
$ synlynk status โ† one-shot check
DATA PLANE

Native Tool UX

โŒจ๏ธ Claude CLI / Claude Desktop
โŒจ๏ธ Gemini CLI / Agy IDE / Agy 2.0
โŒจ๏ธ Codex CLI / Codex Desktop
โŒจ๏ธ Cursor / Windsurf / Opencode / Emergent
synlynk launch claude --story 42
synlynk shell --story 42
synlynk open ide --story 42
synlynk open web --story 42
DAEMON (v0.7.0 โ€” persistent multiplexer)
Dispatch Loop
Routes stories to agents via capability score โ†’ quota headroom โ†’ cost
Async Outbox
Queues state.db writes โ†’ GitHub Projects V2 / Jira / Linear (non-blocking)
Sentinel Watch
Zombie, stall, quota-exhausted, flatline, loop detection
HTTP Context Server
localhost:27471 โ€” TUI attaches here; serves context-<tool>.md
STATE DB โ€” ~/.synlynk/workspaces/<name>/state.db (canonical, never branches)
Arc
Phase
Epic
Story
Event log
agent_profiles
external_refs
SPEC 1 โ€” Hybrid Workgroup Bootstrap
๐Ÿง™ TUI Init Wizard โ€” curses, progressive
๐Ÿ” Semantic Discovery โ€” static skeleton โ†’ LLM enrichment (opt-in)
๐Ÿค– Agent Discovery โ€” CLI scan โ†’ capability profiles
โœจ Magic Moment โ€” "You have Claude + Gemini + Codex" screen
๐Ÿ”— Cloud Directory โ€” always nudge to multi-AI / team connect
Target: v0.4.0 / v0.5.0
SPEC 2 โ€” PM Engine + Command Centre
๐Ÿ“‹ TUI Kanban โ€” Arc/Phase/Epic/Story board
โšก Detach/Attach โ€” Ctrl+D detach, daemon keeps running
๐Ÿš€ 4 Launch Primitives โ€” open ide / open web / shell / launch
๐Ÿ“ค Async Outbox โ€” GH Projects V2 / Jira / Linear sync
โ˜๏ธ Cross-team โ€” event-log sync โ†’ NATS at v1.0
Target: v0.5.0 โ†’ v0.9.0