RafeOS — architecture & behaviour (v9 draft)

Two diagrams: what it's made of (architecture, layered) and how it acts (behaviour, a flow).

1 · Architecture — what it's made of

1 How I reach it
channels
App
CockpitCLI
glance · quick command
Agentic chat
ClaudeChatGPTGrokOllama (local)
quick query
Agentic harnesses
Claude CodeClaude CoworkOpenClaw
where I work
Messaging
SignalTelegramWhatsApp
two-way · on the go
requests in · pushes out ⇅
2 The platform
services
RAFEOS — acted on by me, by agents, or both · every write attributed
Built by me
rafeos-apirafeos-mcpCLIskills
Connectors · third-party tools & skills
Anthropic-hostedHome Assistantother MCPsother skills
Modules · ~100+ tools
briefingtasksmessagingreading healthhomeinfo calendaremailnotify screen-time+ more
draws on ↓
3 Data & context
data
Owned & persistent
Substrate · memory
Markdownchat / harness memory
knowledge · project state & decisions · session logs · memory · context (CLAUDE.md)
acted on by Obsidian (human view) & Git (sync)
Stores I own
tasksreadinghealthmessaging
local + cloud filescachesother
Pulled live · borrowed
Productivity
EmailCalendarGoogle DriveDex
Home & environment
Home AssistantActivityWatchOctopusMeteo
Health
OuraWithingsApple Health
Other
RSSReadwiseTfLtrain times
stands on ↓
4 Foundations
hosting
AI models
Anthropic · OpenAI · xAI · Ollama (local)
Self-hosted services
Matrix / Conduit + bridges · Miniflux · Home Assistant · ActivityWatch · Grafana · InfluxDB · Dex
Infrastructure & hosts
Tailscale · Docker · Caddy · Cloudflare · SQLite · Mac · Anchor · Crucible · Mimic · NAS
Key: the platform I built (hero) built by me borrowed / third-party

2 · Behaviour — how it acts

A flow, not layers: a trigger fires, the request is handled somewhere on the autonomy spectrum, and it has effects (with a boundary on anything outbound). The same platform is driven three ways — human-only, hybrid (me and an agent together), or autonomous. This is the platform from diagram 1 in motion.

Triggers
Human-initiated
askglancerespond
Agent-initiated
delegationhand-offcross-check
Loops & events
schedulewebhook
↓
Handling
The autonomy spectrum · colour = AI / cost / unpredictability
Passthrough
show data, no model
Automation
deterministic rules, no model
Workflows
a set of known steps
Agents
handed a goal, finds the steps
AI: none · cheapest · most predictableAI: most · dearest · least predictable
↓
Effects
read (data & context) respond (chat / message) use a tool create (task / draft / note / other) notify me (push) actuate (smart home / services)
Gated: outbound to others · actuate · purchases / secrets.

v9 draft (in the v6 file). Visual pass per the review: per-tier colour bands, teal reserved for ownership, foundations demoted to quiet text, live sources clustered, tiers numbered, key updated.