Spacesuit

What This Skill Does

Spacesuit serves as the foundational architecture for OpenClaw workspaces. It acts as an "operating system" layer for your AI agent, standardizing how the agent manages its own behavior, memory, and safety protocols across different projects. Rather than relying on scattered configurations, Spacesuit provides a structured, section-based framework that resides within your workspace root. By utilizing specialized markup tags, it manages core files like AGENTS.md and SOUL.md while ensuring that your manual, project-specific customizations are never overwritten during updates. It enforces a strict git-workflow, maintains a multi-tier task priority system (P0-P5), and establishes a robust security baseline, ensuring your agent remains disciplined and context-aware.

Installation

Installation is handled through the OpenClaw repository management system. To get started, run clawhub install openclaw/skills/skills/jontsai/spacesuit in your terminal. Once the package is installed, navigate to your project workspace and execute make init. This command creates the necessary baseline files and directory structures. If you are updating an existing environment, use make upgrade to refresh the framework components while keeping your personal configurations intact. Always verify the status using the included script ./scripts/diff.sh before applying changes.

Use Cases

Spacesuit is designed for power users and developers managing complex, long-running AI projects. Common use cases include:

1. Maintaining consistent personality and tool configurations across multiple independent agent sessions.
2. Implementing a rigorous, automated decision-making log that tracks architectural changes for future auditing.
3. Managing complex tasks with periodic heartbeat checks that track project status and resource health over weeks or months.
4. Ensuring high security for agentic operations through standardized, prompt-injection-resistant baseline policies.

Example Prompts

1. "Spacesuit, initialize the heartbeat check for this workspace and pull the latest P0 priority tasks from my memory logs."
2. "Update my SOUL.md personality profile to focus on a more concise, technical tone for this project while keeping the core safety framework intact."
3. "Perform a pre-commit check using the Spacesuit git-workflow protocol and document the current decision logic for the latest code refactor in MEMORY.md."

Tips & Limitations

To maximize the utility of Spacesuit, always maintain your edits within the provided block markers. If you modify content outside these markers, the framework will ignore them during the make upgrade process, ensuring your work is safe. Note that Spacesuit is heavily dependent on specific file naming conventions; renaming core files like SOUL.md or AGENTS.md will break the framework's ability to sync content. As a framework, it assumes a high degree of autonomy; ensure your SECURITY.md file is configured with the correct notification channels to prevent the agent from making unattended, high-impact decisions without your explicit oversight.