openclaw-spacesuit
A framework scaffold for OpenClaw workspaces.
Metadata
| Field |
Value |
| Name |
spacesuit |
| Version |
0.3.0 |
| Author |
jontsai |
| License |
MIT |
| Category |
framework |
| Tags |
workspace, scaffold, conventions, memory, git-workflow |
Description
The Spacesuit is a batteries-included framework layer for OpenClaw workspaces. It provides:
- Session startup protocol — security-first file loading order
- Memory system — daily logs + curated long-term memory with commit discipline
- Git workflow — mandatory pre-commit checks, worktree conventions, parallel agent coordination
- Safety rules — pre-action checklist, destructive-action guards, stand-down protocol
- Priority system — P0–P5 triage for tasks and incidents
- Cross-platform handoffs — structured context transfer between Slack/Discord/Telegram
- Heartbeat framework — proactive periodic checks with state tracking
- Decision logging — mandatory audit trail for architectural decisions
- Meta-learning framework — expert-first research methodology (Dunning-Kruger aware)
- Security baseline — secret transmission policy, prompt injection defense, data classification
Installation
# First-time install (creates workspace files with markers)
make init
# Upgrade existing workspace (replaces only SPACESUIT sections)
make upgrade
How It Works
OpenClaw reads hardcoded filenames from the workspace root (AGENTS.md, SOUL.md, etc.). Since we can't change that loading behavior, Spacesuit uses section-based merging:
- Framework content is wrapped in
<!-- SPACESUIT:BEGIN --> / <!-- SPACESUIT:END --> markers
- On upgrade, only the content between markers is replaced
- Everything outside the markers (your customizations) is preserved
Files Managed
| File |
Base Content |
User Content |
AGENTS.md |
Session protocol, memory, git, safety, priorities |
Channel mappings, tool configs, personal rules |
SOUL.md |
Core personality scaffold |
Personal vibe, human-specific tone |
TOOLS.md |
Tool organization guidance |
Actual tool configs, credentials refs, API details |
HEARTBEAT.md |
Check framework & state tracking |
Specific checks to run |
IDENTITY.md |
— (template only) |
Name, avatar, personality |
USER.md |
— (template only) |
All about your human |
MEMORY.md |
Long-term memory structure |
Project notes, personal context |
SECURITY.md |
Full security baseline |
Contact-specific alert channels |
Makefile |
— (template only) |
Gateway management targets |
Upgrade Path
# See what would change
./scripts/diff.sh
# Apply upgrade
./scripts/upgrade.sh
# Check version
cat skills/spacesuit/VERSION
1---2name: openclaw-spacesuit3description: The Spacesuit is a batteries-included framework layer for OpenClaw workspaces. It provides:4---5
6# openclaw-spacesuit
7
8**A framework scaffold for OpenClaw workspaces.**
9
10## Metadata
11
12| Field | Value |
13|-------|-------|
14| **Name** | `spacesuit` |
15| **Version** | `0.3.0` |
16| **Author** | jontsai |
17| **License** | MIT |
18| **Category** | framework |
19| **Tags** | workspace, scaffold, conventions, memory, git-workflow |
20
21## Description
22
23The Spacesuit is a batteries-included framework layer for OpenClaw workspaces. It provides:
24
25- **Session startup protocol** — security-first file loading order
26- **Memory system** — daily logs + curated long-term memory with commit discipline
27- **Git workflow** — mandatory pre-commit checks, worktree conventions, parallel agent coordination
28- **Safety rules** — pre-action checklist, destructive-action guards, stand-down protocol
29- **Priority system** — P0–P5 triage for tasks and incidents
30- **Cross-platform handoffs** — structured context transfer between Slack/Discord/Telegram
31- **Heartbeat framework** — proactive periodic checks with state tracking
32- **Decision logging** — mandatory audit trail for architectural decisions
33- **Meta-learning framework** — expert-first research methodology (Dunning-Kruger aware)
34- **Security baseline** — secret transmission policy, prompt injection defense, data classification
35
36## Installation
37
38```bash
39# First-time install (creates workspace files with markers)
40make init
41
42# Upgrade existing workspace (replaces only SPACESUIT sections)
43make upgrade
44```
45
46## How It Works
47
48OpenClaw reads hardcoded filenames from the workspace root (`AGENTS.md`, `SOUL.md`, etc.). Since we can't change that loading behavior, Spacesuit uses **section-based merging**:
49
501. Framework content is wrapped in `<!-- SPACESUIT:BEGIN -->` / `<!-- SPACESUIT:END -->` markers
512. On upgrade, only the content between markers is replaced
523. Everything outside the markers (your customizations) is preserved
53
54## Files Managed
55
56| File | Base Content | User Content |
57|------|-------------|--------------|
58| `AGENTS.md` | Session protocol, memory, git, safety, priorities | Channel mappings, tool configs, personal rules |
59| `SOUL.md` | Core personality scaffold | Personal vibe, human-specific tone |
60| `TOOLS.md` | Tool organization guidance | Actual tool configs, credentials refs, API details |
61| `HEARTBEAT.md` | Check framework & state tracking | Specific checks to run |
62| `IDENTITY.md` | — (template only) | Name, avatar, personality |
63| `USER.md` | — (template only) | All about your human |
64| `MEMORY.md` | Long-term memory structure | Project notes, personal context |
65| `SECURITY.md` | Full security baseline | Contact-specific alert channels |
66| `Makefile` | — (template only) | Gateway management targets |
67
68## Upgrade Path
69
70```bash
71# See what would change
72./scripts/diff.sh
73
74# Apply upgrade
75./scripts/upgrade.sh
76
77# Check version
78cat skills/spacesuit/VERSION
79```
modbender