spacebot-dev

Guide Rust source changes and architecture across Spacebot's five-process model.

Updated Apr 14, 2026
One-click install
npx skills add https://github.com/jrmatherly/spacebot --skill spacebot-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spacebot-dev
Source: https://github.com/jrmatherly/spacebot/tree/main/.claude/skills/spacebot-dev
Command: npx skills add https://github.com/jrmatherly/spacebot --skill spacebot-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Spacebot is a complex multi-process agent system; this skill removes the need to read every file by providing targeted architectural knowledge, correct decision guidance, and development patterns so engineers can implement features, fixes, and refactors safely and consistently.

Core Features & Use Cases

  • Process model guidance: Clear rules and responsibilities for Channel, Branch, Worker, Compactor, and Cortex processes to avoid blocking, leakage, and incorrect tool usage.
  • Memory and database expertise: Explanations of the triple-storage memory stack (SQLite, LanceDB, redb), memory types, maintenance policies, and hybrid search semantics.
  • Tooling, prompts, and hot-reload: How to add tools via the Rig framework, author prompt templates, and safely use hot-reloadable RuntimeConfig fields.
  • Operational patterns: Worker lifecycle, task system behavior, compaction thresholds, security/sandboxing, migration rules, and metrics instrumentation for production readiness.
  • Use case: Use when changing src/ Rust code, editing prompts/, adding tools, creating migrations, or answering architecture questions about concurrency and safety.

Quick Start

Use the spacebot-dev skill to review a proposed Rust change in src/, summarize affected modules, list necessary config or migration updates, and suggest tests and safety checks.

Frequently Asked Questions about spacebot-dev

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How does the Spacebot agent memory stack architecture work across SQLite, LanceDB, and redb?

The Spacebot memory stack uses SQLite, LanceDB, and redb for triple-database coordination. This architecture separates concerns: SQLite for relational task data, LanceDB for hybrid vector search, and redb for embedded key-value storage to optimize agent memory retrieval and compaction.

How do I add new tools to a Rust agent using the Rig framework?

To add tools to a Rust agent using the Rig framework, you implement tool patterns within the Spacebot src/ codebase. This involves defining tool schemas, integrating them with the Worker process, and ensuring they adhere to cross-process coordination rules to avoid blocking or resource leakage.

Do I need to understand all five Spacebot processes before modifying Rust source code?

Yes, modifying Rust source code requires familiarity with the five-process model: Channel, Branch, Worker, Compactor, and Cortex. Understanding these processes is essential to ensure safe concurrency, correct tool usage, and avoid memory leaks when implementing features or refactoring.

How do I safely use hot-reload configuration when editing prompt templates?

To safely use hot-reload configuration, edit prompt templates in the prompts/ directory and utilize hot-reloadable RuntimeConfig fields. This allows you to update agent behavior dynamically without restarting, provided you follow the correct template authoring and configuration update patterns.

What are the limitations or safety checks when creating database migrations for an agent codebase?

Creating database migrations for an agent codebase requires strict safety checks to prevent data loss across the triple-storage stack. You must adhere to migration rules, verify compaction thresholds, and ensure cross-process coordination between the Worker and Compactor to maintain data integrity.