workspace-archiver

OpenClaw internal skill for workspace documentation governance.

Purpose

This skill standardizes OpenClaw workspace documents using executable rules in four domains:

1. Directory naming
2. Archive layer placement
3. Index file requirements
4. Cross-directory reference normalization

Not included: tar/zip packaging, backup snapshots, restore pipelines.

OpenClaw docs alignment

Primary sources:

• https://docs.openclaw.ai/tools/skills.md
• https://docs.openclaw.ai/tools/creating-skills.md
• https://docs.openclaw.ai/tools/skills-config.md

Repository layout

workspace-archiver/
├── SKILL.md
├── README.md
├── SPEC.yaml
├── rules/
│   ├── openclaw-doc-governance.yaml
│   └── docs-rag-sync.json
├── scripts/
│   └── sync_rules_from_docs_rag.sh
├── references/
│   ├── openclaw-skill-architecture.md
│   ├── archive-manifest-template.md
│   └── repo-dedup-checklist.md
└── tests/
    └── test_skill_contract.py

Docs-RAG coupling model

• Rules are stored locally in rules/openclaw-doc-governance.yaml.
• Source pattern sync metadata is stored in rules/docs-rag-sync.json.
• Refresh command:

bash scripts/sync_rules_from_docs_rag.sh

Default refresh cadence: every 14 days.

TDD + SDD gates

python3 -m pytest -q

The contract tests verify:

• skill scope excludes backup/packaging behavior
• four governance domains are present
• rules + sync mechanism files exist
• docs links and cadence are documented

Release notes

v2.3.1

• Skill audit upgrade: normalized SKILL.md frontmatter to name + description
• Revalidated trigger wording and OpenClaw compatibility checks

v2.3.0

• Removed backup/package scope from skill definition
• Reframed skill as documentation governance engine
• Added executable ruleset (rules/openclaw-doc-governance.yaml)
• Added Docs-RAG sync metadata + sync script scaffold
• Updated TDD/SDD specs and contract tests

License

MIT