# openclaw-ops

Operational repo for Ben's OpenClaw workspace.

This repo is the versioned source of truth for:
- custom skills
- scripts and helpers
- cron/automation definitions
- docs and runbooks
- core workspace guidance files

It intentionally does **not** track volatile runtime state, private memory, auth artifacts, or mailbox data.

## What is tracked

- `skills/` — custom AgentSkills and helper scripts
- `scripts/` — reusable operational scripts
- `docs/` — runbooks, architecture notes, integration docs
- `cron/` — documented recurring jobs and schedules
- selected workspace guidance files:
  - `AGENTS.md`
  - `SOUL.md`
  - `USER.md`
  - `TOOLS.md`
  - `PROJECTS.md`
  - `HEARTBEAT.md`
  - `IDENTITY.md`

## What is not tracked

- `MEMORY.md`
- `memory/`
- `state/`
- `mail/`
- runtime/local directories like `.openclaw/`, `.opencode/`, `tmp/`
- generated caches and auth material

## Working pattern

Recommended workflow:
1. Make changes in the workspace.
2. Commit small, coherent units of work.
3. Push when the task is complete or the checkpoint is useful.

Default philosophy:
- commit often
- push deliberately
- never commit secrets
- keep operational state out of git unless intentionally templated

## Repo conventions

See `docs/repo-conventions.md` for commit/push guidance and repo hygiene.

## Git hygiene

This repo includes a lightweight local pre-commit secret scan.
See `docs/git-hooks.md` for details.

## Cron / automation

See `cron/README.md` for the current recurring-job layout and documentation pattern.