---
id: WARDEN-WP-0004
type: workplan
title: "OpsWarden Repo Hygiene and Hub Sync"
domain: custodian
repo: ops-warden
status: archived
owner: codex
topic_slug: custodian
created: "2026-06-17"
updated: "2026-06-17"
state_hub_workstream_id: "3c4b6e68-550a-4fc6-a804-95f1f68936c3"
---

# WARDEN-WP-0004 — Repo Hygiene and Hub Sync

**Scope:** Bring repo orientation docs and agent rules in line with the shipped
`warden` CLI (WARDEN-WP-0001 through 0003 complete). Archive finished workplans
and sync State Hub.

**Out of scope:** OpenBao doc alignment (WARDEN-WP-0005), capability registry
publish, task-status canon migration in AGENTS.md.

---

## Goal

After this workplan, a new agent session can orient from accurate local files
without reading stale "planned / scaffolding only" language, and State Hub
reflects archived workplan status.

---

## Tasks

### T1 — Update orientation docs

```task
id: WARDEN-WP-0004-T01
status: done
priority: high
state_hub_task_id: "f9d3926c-8637-411c-a477-2960b754704c"
```

- [x] `SCOPE.md` Current State reflects shipped CLI (v0.1.0, workplans 0001–0003 done)
- [x] `README.md` replaces repo-seed template with install, config, and dev commands

### T2 — Fill agent rules

```task
id: WARDEN-WP-0004-T02
status: done
priority: medium
state_hub_task_id: "86c764a5-62fc-45fe-a8d2-332d6554a976"
```

- [x] `.claude/rules/stack-and-commands.md` — stack and `uv` dev commands
- [x] `.claude/rules/architecture.md` — module layout and data flow
- [x] `.claude/rules/repo-boundary.md` — adjacent repo ownership

### T3 — Archive finished workplans

```task
id: WARDEN-WP-0004-T03
status: done
priority: medium
state_hub_task_id: "d3e54e63-ce98-4632-bc08-0e2667f19f12"
```

- [x] Move WARDEN-WP-0001/0002/0003 to `workplans/archived/` with date prefix
- [x] Set frontmatter `status: archived` on moved files

### T4 — Sync State Hub

```task
id: WARDEN-WP-0004-T04
status: done
priority: medium
state_hub_task_id: "51729695-262f-4fe4-9c38-f99ee046d32a"
```

- [x] Run `make fix-consistency REPO=ops-warden` from state-hub
- [x] Verify `.custodian-brief.md` reflects archived workstreams

---

## Acceptance Criteria

- [x] `SCOPE.md` no longer says "planned" or "scaffolding only"
- [x] `README.md` documents `uv sync`, `uv run pytest`, and `warden --help`
- [x] Agent rules have no empty TODO blocks for stack, architecture, or boundary
- [x] Only WARDEN-WP-0004 remains in `workplans/` root (archived plans moved)
- [x] `make fix-consistency REPO=ops-warden` completes without error