disaster-control/.claude/rules/stack-and-commands.md

39 lines
1.1 KiB
Markdown
Raw Normal View History

2026-07-04 10:22:20 +00:00
## Stack
- **Language:** Markdown-first governance repo (YAML registers, policies, runbooks)
- **Key deps:** State Hub ADR-001 workplans, YAML registers, cross-repo backup tooling
2026-07-04 10:22:20 +00:00
## Dev Commands
```bash
# Orient (offline-safe)
cat .custodian-brief.md
cat INTENT.md
cat PanicSheet.md
2026-07-04 10:22:20 +00:00
ls workplans/
# Validate register YAML
python3 -c "import yaml; yaml.safe_load(open('AssetRegister.yaml')); yaml.safe_load(open('DataRegister.yaml'))"
2026-07-04 10:22:20 +00:00
# Sanity-check markdown / YAML edits
git diff --check
2026-07-04 10:22:20 +00:00
# Push to primary + off-Gitea mirror
git push origin main
./tools/sync-mirror.sh
2026-07-04 10:22:20 +00:00
# After workplan edits — from ~/state-hub
make fix-consistency REPO=disaster-control
# State Hub API (if hub offline: cd ~/state-hub && make api)
curl -s "http://127.0.0.1:8000/messages/?to_agent=disaster-control&unread_only=true" | python3 -m json.tool
2026-07-04 10:22:20 +00:00
```
## Key paths
| Path | Purpose |
| --- | --- |
| `AssetRegister.yaml` / `DataRegister.yaml` | Stack inventory |
| `BackupPickupQueue.md` | Cross-repo backup closure tracker |
| `TestEvidence/` | Restore drill reports |
| `docs/mirror-sync.md` | Off-Gitea mirror procedure |