Skip to content

Feature: Overview

github-actions[bot] edited this page Sep 19, 2026 · 1 revision

Feature Architecture

Per-feature architecture docs for thatch. Each doc covers what the feature does, how it works, how it interacts with other features, and the source files that implement it.

For the monolithic architecture overview, see ../README.md. For hook configuration and concrete artifact paths, see ../setup-and-hooks.md. For feature parity across hosts, see ../mcp-parity.md. For the skill system, see ../skills.md. For non-obvious invariants, see ../gotchas.md.

Docs

Doc Feature
memory-store.md Persistent memory store (CRUD, search, embeddings, stores, branches)
multi-host.md Three-host architecture (opencode, Claude Code, Cursor)
extraction.md Extraction pipeline (buffering, child sessions, nudge escalation, file-backed queue)
nudge-pipeline.md Per-message nudge pipeline (extraction, recall, prediction, behavior tiers)
prediction-engine.md Prediction engine (user decision model, Bayesian confidence, auto-fire)
behavior-engine.md Behavior engine (LLM self-discipline rules, ham/spam, auto-fire)
hygiene.md Hygiene system (duplicate, stale, orphaned branch signals)
deduplication.md Deduplication system (find pairs, verdict lifecycle)
commands.md Slash commands (on-demand actions from shared prompt cores, wrap-ups, host sync)
sideband.md Sideband IPC (Unix socket for MCP host hook processes)
compaction-recovery.md Compaction recovery (opencode compaction hooks)
session-lifecycle.md Session lifecycle management (opencode events, child tracking, wrap-up commands)
watchers.md Event-driven notifications (in-memory registry, background poller, PR watching)
cross-session-chat.md Cross-session chat (shared SQLite directory and inbox, per-process wake-up delivery)
notifications.md Out-of-band notification (banner + voice) and the user config file
setup.md Setup system (markers, checkSetup, auto-refresh, binary resolution)
cli.md CLI (subcommands, environment variables)
database.md Database (schema, migrations, WAL)
qa-system.md QA system (automatable vs live, mise tasks)
cicd.md CI/CD (CI pipeline, OIDC publishing, release helper)

Clone this wiki locally