residuum-system

name	residuum-system
description	Reference documentation for all Residuum workspace systems — memory, projects, heartbeats, inbox, actions, skills, notifications, and background tasks.

Residuum System Reference

This skill provides reference documentation for every major workspace system. Activate it when you need to understand how a system works, what tools are available, or what file formats to use.

Quick Reference

System	Tools	Config File	Reference
Memory	memory_search, memory_get	memory/OBSERVER.md, memory/REFLECTOR.md	memory-system
Projects	project_create, project_activate, project_deactivate, project_archive, project_list	per-project PROJECT.md	projects
Heartbeats	(none — runs automatically)	HEARTBEAT.yml	heartbeats
Inbox	inbox_list, inbox_read, inbox_archive	(none)	inbox
Scheduled Actions	schedule_action, list_actions, cancel_action	scheduled_actions.json	scheduled-actions
Skills	skill_activate, skill_deactivate	per-skill SKILL.md	skills
Tool PATH	exec (uses it)	[tools] in config.toml, ~/.residuum/bin	tools
Notifications	list_endpoints, switch_endpoint, send_message	ALERTS.md, config/channels.toml	notifications
Background Tasks	subagent_spawn, list_agents, stop_agent	[background] in config.toml	background-tasks

Workspace Directory Layout

workspace/
├── SOUL.md                  # Core identity and personality
├── AGENTS.md                # Agent behavior rules
├── USER.md                  # User preferences
├── MEMORY.md                # Persistent scratchpad (agent-maintained)
├── ENVIRONMENT.md           # Local environment notes
├── BOOTSTRAP.md             # First-run guidance (deleted after first conversation)
├── PRESENCE.toml            # Discord presence configuration
├── HEARTBEAT.yml            # Pulse scheduling
├── scheduled_actions.json   # Persisted one-off actions
├── memory/
│   ├── observations.json    # Flat observation log
│   ├── recent_messages.json # Unobserved messages buffer
│   ├── recent_context.json  # Narrative context from latest observation
│   ├── OBSERVER.md          # Observer extraction guidance (agent-maintained)
│   ├── REFLECTOR.md         # Reflector compression guidance (agent-maintained)
│   ├── vectors.db           # sqlite-vec vector database (optional)
│   ├── .index/              # Tantivy BM25 search index
│   ├── .index_manifest.json # Index file tracking
│   ├── episodes/            # Episode transcripts (YYYY-MM/DD/)
│   └── background/          # Background task transcripts (YYYY-MM/DD/)
├── skills/                  # Workspace-level skills
├── subagents/               # Subagent presets
├── projects/                # Active project contexts
├── archive/                 # Archived projects + inbox
│   └── inbox/               # Archived inbox items
└── inbox/                   # Active inbox items