openclaw-spacesuit

# 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

```bash
# 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**:

1. Framework content is wrapped in `<!-- SPACESUIT:BEGIN -->` / `<!-- SPACESUIT:END -->` markers
2. On upgrade, only the content between markers is replaced
3. 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

```bash
# See what would change
./scripts/diff.sh

# Apply upgrade
./scripts/upgrade.sh

# Check version
cat skills/spacesuit/VERSION
```