| 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
