Compound Engineering Openclaw Maintenance

README

# compound-engineering-openclaw-maintenance

Maintenance baseline for running the Every Compound Engineering plugin on OpenClaw.

This repo tracks the maintenance layer only, not the plugin source itself.

## What this repo contains

- install and update script for Compound Engineering on OpenClaw
- health check script
- skill audit script
- local integration smoke test
- maintenance docs and troubleshooting notes
- version and update baseline files

## Repo layout

```text
.maintenance/
docs/
scripts/
tests/
README.md
```

## Quick start

From the repo root:

```bash
bash scripts/update-compound-engineering-openclaw.sh
bash scripts/health-check.sh
bash scripts/audit-skills.sh
bash tests/skill-integration-test.sh
```

## What each script does

### `scripts/update-compound-engineering-openclaw.sh`
- installs or updates the OpenClaw extension via the official `compound-plugin` CLI
- ensures `compound-engineering` is in `plugins.allow`
- ensures `plugins.entries.compound-engineering.enabled = true`
- restarts the OpenClaw gateway

### `scripts/health-check.sh`
- checks `openclaw` and `bun`
- verifies extension files exist
- verifies allowlist and enabled state in `~/.openclaw/openclaw.json`
- runs a simple `openclaw status` smoke test
- writes a JSON report to `.maintenance/reports/latest-health-check.json`

### `scripts/audit-skills.sh`
- checks a core set of required skills exists
- compares manifest skill entries against actual folders on disk
- writes a JSON report to `.maintenance/reports/latest-skill-audit.json`

### `tests/skill-integration-test.sh`
- runs health check and skill audit first
- verifies key skill files exist
- runs another `openclaw status` smoke test
- writes a JSON report to `.maintenance/reports/latest-skill-integration-test.json`

## Docs

- setup and usage: `docs/compound-engineering-openclaw.md`
- troubleshooting: `docs/compound-engineering-openclaw-troubleshooting.md`

## Notes

- generated health and audit reports are ignored via `.gitignore`
- scripts now resolve the repo root dynamically, so the repo can live outside `~/.openclaw/workspace`
- GitHub Actions only does a lightweight shell smoke check, because the full runtime checks require a real local OpenClaw installation, Bun, and an installed `compound-engineering` extension

## CI

This repo includes a GitHub Actions workflow at `.github/workflows/shell-smoke.yml` that:

- verifies the expected repo files exist
- runs `bash -n` against shell scripts in `scripts/` and `tests/`
- checks executable bits on the main scripts