generated from coulomb/repo-seed
tegwick
9514ad914e
Update SCOPE and README to reflect the shipped warden CLI, fill agent rules for stack/architecture/boundary, archive finished workplans 0001–0003, and register WP-0004 in State Hub.
93 lines
2.5 KiB
Markdown
93 lines
2.5 KiB
Markdown
---
|
||
id: WARDEN-WP-0004
|
||
type: workplan
|
||
title: "OpsWarden Repo Hygiene and Hub Sync"
|
||
domain: custodian
|
||
repo: ops-warden
|
||
status: finished
|
||
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 |