coulomb/the-custodian
4
0
Fork 0
Code Issues 1 Pull requests Projects Releases Packages Wiki Activity Actions

Normalize agent instructions and workplan frontmatter (STATE-WP-0067)

Browse source 
- Align agent files with on-disk workplan prefixes (infer from workplan ids)
- Set workplan domain to registered domain_slug; add topic_slug where applicable
- Repair frontmatter delimiter formatting; migrate legacy task status literals
- Regenerate AGENTS.md, CLAUDE.md, and .claude/rules from State Hub templates
This commit is contained in:
tegwick 2026-06-22 23:16:28 +02:00
parent d30e71fb43
commit 8bdefcd6ba
45 changed files with 59 additions and 56 deletions
Download patch file Download diff file Expand all files Collapse all files

20
AGENTS.md
View file

@ -4,10 +4,10 @@
**Purpose:** Transgenerational cognitive infrastructure and central coordination hub for all domains. Houses the state-hub (PostgreSQL + FastAPI + MCP + dashboard), governance canon, workplans, and agent session memory.
**Domain:** custodian
**Domain:** infotech
**Repo slug:** the-custodian
**Topic ID:** `cee7bedf-2b48-46ef-8601-006474f2ad7a`
**Workplan prefix:** `THE-WP-`
**Workplan prefix:** `CUST-WP-`
---
@ -63,8 +63,8 @@ Omit `workstream_id` / `task_id` when not applicable.
```bash
curl -s -X PATCH "http://127.0.0.1:8000/tasks/<task_id>" \
-H "Content-Type: application/json" \
-d '{"status": "in_progress"}'
# values: todo | in_progress | done | blocked
-d '{"status": "progress"}'
# values: wait | todo | progress | done | cancel
```
### Flag a task for human review
@ -83,7 +83,7 @@ curl -s -X PATCH "http://127.0.0.1:8000/tasks/<task_id>" \
1. `cat .custodian-brief.md` — domain goal and open workstreams (offline-safe)
2. Check inbox: `GET /messages/?to_agent=the-custodian&unread_only=true`; mark read
3. Scan workplans: `ls workplans/` — note `status: ready`, `active`, or `blocked` files and open tasks
4. Check blocked tasks: `GET /tasks/?needs_human=true`
4. Check human-needed tasks: `GET /tasks/?needs_human=true`
**During work:**
- Update task statuses in workplan files as tasks progress
@ -152,6 +152,10 @@ get wrong.
**Canon:** `~/ops-warden/wiki/CredentialRouting.md` · catalog `~/ops-warden/registry/routing/catalog.yaml`
<!-- REPO-AGENTS-EXTENSIONS -->
<!-- Append repo-specific agent instructions below this marker.
The state-hub template sync preserves content after this line. -->
---
## Workplan Convention (ADR-001)
@ -177,7 +181,7 @@ anything needing analysis, design, approval, dependencies, or multiple phases.
id: THE-WP-NNNN
type: workplan
title: "..."
domain: custodian
domain: infotech
repo: the-custodian
status: proposed | ready | active | blocked | backlog | finished | archived
owner: codex
@ -199,7 +203,7 @@ derived health labels, not frontmatter statuses.
` ` `task
id: THE-WP-NNNN-T01
status: todo | in_progress | done | blocked
status: wait | todo | progress | done | cancel
priority: high | medium | low
state_hub_task_id: "<uuid>" # written by fix-consistency — do not edit
` ` `
@ -207,7 +211,7 @@ state_hub_task_id: "<uuid>" # written by fix-consistency — do not edit
Task description text.
```
Status progression: `todo` → `in_progress` → `done` (or `blocked`)
Status progression: `todo` → `progress` → `done`; use `wait` for waiting/blocked work and `cancel` for stopped work.
To create a new workplan:
1. Write the file following the format above

5
workplans/CUST-WP-0000-state-hub-v0.1-build-deploy.md
View file

@ -2,7 +2,7 @@
id: CUST-WP-0000
type: workplan
title: "State Hub v0.1 — Build & Deploy"
domain: custodian
domain: infotech
repo: the-custodian
status: completed
owner: custodian
@ -15,8 +15,7 @@ note: >
Pre-ADR-001 record. This workstream was created DB-first during the first
Custodian session (2026-02-24) before the workplan-as-repository-artefact
convention was established. This file is a retroactive record written on
2026-03-11 to satisfy the ADR-001 consistency checker (C-08).
---
2026-03-11 to satisfy the ADR-001 consistency checker (C-08).---
# State Hub v0.1 — Build & Deploy

5
workplans/CUST-WP-0000b-state-hub-v0.2-decisions-dependencies.md
View file

@ -2,7 +2,7 @@
id: CUST-WP-0000b
type: workplan
title: "State Hub v0.2 — Decisions, Suggestions & Dependencies"
domain: custodian
domain: infotech
repo: the-custodian
status: completed
owner: custodian
@ -14,8 +14,7 @@ state_hub_workstream_id: "6585ee66-aa4e-436e-bbec-d83293c33e8f"
note: >
Pre-ADR-001 record. This workstream was created DB-first before the
workplan-as-repository-artefact convention was established. Retroactive
file written on 2026-03-11 to satisfy the ADR-001 consistency checker (C-08).
---
file written on 2026-03-11 to satisfy the ADR-001 consistency checker (C-08).---
# State Hub v0.2 — Decisions, Suggestions & Dependencies

2
workplans/CUST-WP-0001-custodian-agent-runtime.md
View file

@ -2,7 +2,7 @@
id: CUST-WP-0001
type: workplan
title: "Custodian Agent Runtime — Bootstrap"
domain: custodian
domain: infotech
status: done
owner: custodian
topic_slug: custodian

2
workplans/CUST-WP-0002-contribution-tracking-sbom.md
View file

@ -2,7 +2,7 @@
id: CUST-WP-0002
type: workplan
title: "State Hub v0.3 — Contribution Tracking & SBOM"
domain: custodian
domain: infotech
status: completed
owner: custodian
topic_slug: custodian

2
workplans/CUST-WP-0004-ep-td-tracking.md
View file

@ -2,7 +2,7 @@
id: CUST-WP-0004
type: workplan
title: "Extension Points & Technical Debt Tracking"
domain: custodian
domain: infotech
status: completed
owner: custodian
topic_slug: custodian

2
workplans/CUST-WP-0005-dynamic-domains.md
View file

@ -2,7 +2,7 @@
id: CUST-WP-0005
type: workplan
title: "State Hub v0.5 — Dynamic Domains & Multi-Repo"
domain: custodian
domain: infotech
status: completed
owner: custodian
topic_slug: custodian

2
workplans/CUST-WP-0006-gems-state-hub.md
View file

@ -2,7 +2,7 @@
id: CUST-WP-0006
type: workplan
title: GEMS Analysis & State-Hub Migration Planning
domain: custodian
domain: infotech
status: done
owner: custodian
topic_slug: the-custodian

2
workplans/CUST-WP-0007-gems-migration.md
View file

@ -2,7 +2,7 @@
id: CUST-WP-0007
type: workplan
title: GEMS Migration — Three-Pass State-Hub Alignment
domain: custodian
domain: infotech
status: completed
owner: custodian
topic_slug: the-custodian

2
workplans/CUST-WP-0008-consistency-engine.md
View file

@ -2,7 +2,7 @@
id: CUST-WP-0008
type: workplan
title: Consistency Checking Engine
domain: custodian
domain: infotech
status: done
owner: custodian
topic_slug: the-custodian

2
workplans/CUST-WP-0009-human-interventions.md
View file

@ -2,7 +2,7 @@
id: CUST-WP-0009
type: workplan
title: Human Interventions Flag
domain: custodian
domain: infotech
status: completed
owner: custodian
topic_slug: the-custodian

2
workplans/CUST-WP-0010-domain-and-repo-goals.md
View file

@ -2,7 +2,7 @@
id: CUST-WP-0010
type: workstream
title: Domain and Repository Goals
domain: custodian
domain: infotech
status: completed
owner: custodian
topic_slug: the-custodian

2
workplans/CUST-WP-0010-workstream-lifecycle-docs.md
View file

@ -2,7 +2,7 @@
id: CUST-WP-0010
type: workplan
title: Workstream Lifecycle Documentation
domain: custodian
domain: infotech
status: completed
owner: custodian
topic_slug: the-custodian

2
workplans/CUST-WP-0013-sbom-infra-expansion.md
View file

@ -2,7 +2,7 @@
id: CUST-WP-0013
type: workplan
title: "SBOM Infrastructure Expansion"
domain: custodian
domain: infotech
repo: the-custodian
status: completed
owner: custodian

2
workplans/CUST-WP-0014-repo-sync-automation.md
View file

@ -2,7 +2,7 @@
id: CUST-WP-0014
type: workplan
title: Repo Sync Automation & Gitea Inventory
domain: custodian
domain: infotech
repo: the-custodian
status: done
state_hub_workstream_id: 27ea80bd-76bf-44a7-b0ed-e09748d5390b

2
workplans/CUST-WP-0015-agent-inbox.md
View file

@ -2,7 +2,7 @@
id: CUST-WP-0015
type: workplan
title: Agent Inbox — Inter-Agent Coordination via State-Hub
domain: custodian
domain: infotech
repo: the-custodian
status: done
state_hub_workstream_id: 382c2e8a-28db-4db9-8c89-8bc2fea5159a

2
workplans/CUST-WP-0016-kaizen-agentic-integration.md
View file

@ -2,7 +2,7 @@
id: CUST-WP-0016
type: workplan
title: Kaizen-Agentic Integration — Agents for Custodian & Registered Repos
domain: custodian
domain: infotech
repo: the-custodian
status: done
state_hub_workstream_id: bd50b948-6013-4953-b622-6bf4b163e7c5

2
workplans/CUST-WP-0017-scope-md-agent-and-coverage.md
View file

@ -2,7 +2,7 @@
id: CUST-WP-0017
type: workplan
title: SCOPE.md — Repo Scope Analyst Agent + Ecosystem Coverage
domain: custodian
domain: infotech
status: done
owner: custodian
topic_slug: custodian

2
workplans/CUST-WP-0018-api-hardening-code-quality.md
View file

@ -2,7 +2,7 @@
id: CUST-WP-0018
type: workplan
title: "State Hub — API Hardening & Code Quality"
domain: custodian
domain: infotech
status: done
owner: custodian
topic_slug: custodian

2
workplans/CUST-WP-0019-dashboard-ux-polish.md
View file

@ -2,7 +2,7 @@
id: CUST-WP-0019
type: workplan
title: "State Hub Dashboard — UX Polish"
domain: custodian
domain: infotech
status: done
owner: custodian
topic_slug: custodian

2
workplans/CUST-WP-0020-test-suite.md
View file

@ -2,7 +2,7 @@
id: CUST-WP-0020
type: workplan
title: "State Hub — pytest Test Suite"
domain: custodian
domain: infotech
status: done
owner: custodian
topic_slug: custodian

2
workplans/CUST-WP-0021-multi-host-repo-paths.md
View file

@ -2,7 +2,7 @@
id: CUST-WP-0021
type: workplan
title: "State Hub — Multi-Host Repo Path Hardening"
domain: custodian
domain: infotech
status: done
owner: custodian
topic_slug: custodian

2
workplans/CUST-WP-0022-capability-requests.md
View file

@ -2,7 +2,7 @@
id: CUST-WP-0022
type: workplan
title: Capability Request System
domain: custodian
domain: infotech
status: done
owner: custodian
topic_slug: the-custodian

2
workplans/CUST-WP-0023-tpsc.md
View file

@ -2,7 +2,7 @@
id: CUST-WP-0023
type: feature
title: Third-Party Services Catalog (TPSC)
domain: custodian
domain: infotech
status: done
owner: custodian-agent
topic_slug: custodian

2
workplans/CUST-WP-0024-repo-doi-gate.md
View file

@ -2,7 +2,7 @@
id: CUST-WP-0024
type: feature
title: Repository DoI automated gate and dashboard integration
domain: custodian
domain: infotech
status: done
owner: custodian-agent
topic_slug: custodian

2
workplans/CUST-WP-0025-fos-hub-bootstrap.md
View file

@ -2,7 +2,7 @@
id: CUST-WP-0025
type: workplan
title: "FOS Hub Bootstrap — Identity, Hub Extraction, Ops Hub, Fin Hub"
domain: custodian
domain: infotech
repo: the-custodian
status: active
owner: custodian

2
workplans/CUST-WP-0026-distributed-consistency.md
View file

@ -2,7 +2,7 @@
id: CUST-WP-0026
type: workplan
title: "Distributed Consistency — Multi-Machine State Sync"
domain: custodian
domain: infotech
repo: the-custodian
status: done
owner: custodian

2
workplans/CUST-WP-0027-capability-request-dispute.md
View file

@ -2,7 +2,7 @@
id: CUST-WP-0027
type: workplan
title: "Capability Request Dispute & Negotiation"
domain: custodian
domain: infotech
repo: the-custodian
status: done
owner: custodian

2
workplans/CUST-WP-0029-token-consumption-tracking.md
View file

@ -2,7 +2,7 @@
id: CUST-WP-0029
type: workplan
title: "Token Consumption Tracking"
domain: custodian
domain: infotech
repo: the-custodian
status: done
owner: custodian

2
workplans/CUST-WP-0030-dashboard-entity-list-ux.md
View file

@ -2,7 +2,7 @@
id: CUST-WP-0030
type: workplan
title: "Dashboard Entity List UX"
domain: custodian
domain: infotech
repo: the-custodian
status: done
owner: custodian

2
workplans/CUST-WP-0031-capability-registry.md
View file

@ -2,7 +2,7 @@
id: CUST-WP-0031
type: workplan
title: "Domain Capability Registry"
domain: custodian
domain: infotech
repo: the-custodian
status: done
owner: custodian

2
workplans/CUST-WP-0032-haskell-build-machine.md
View file

@ -2,7 +2,7 @@
id: CUST-WP-0032
type: workplan
title: "Haskell Build Machine — VirtualBox Image & State-Hub Integration"
domain: railiance
domain: infotech
repo: the-custodian
status: done
owner: custodian

2
workplans/CUST-WP-0033-interface-change-registry.md
View file

@ -2,7 +2,7 @@
id: CUST-WP-0033
type: workplan
title: "Interface Change Registry — Coordinated API Evolution"
domain: custodian
domain: infotech
repo: the-custodian
status: done
owner: custodian

2
workplans/CUST-WP-0039-dashboard-poll-optimization.md
View file

@ -2,7 +2,7 @@
id: CUST-WP-0039
type: workplan
title: "Dashboard Poll Optimization"
domain: custodian
domain: infotech
status: done
owner: custodian
topic_slug: custodian

2
workplans/CUST-WP-0040-state-hub-nats-activity-core-integration.md
View file

@ -1,7 +1,7 @@
---
id: CUST-WP-0040
type: workplan
domain: custodian
domain: infotech
repo: the-custodian
status: completed
state_hub_workstream_id: d8ac100b-a844-46a5-9684-415df0d32539

2
workplans/CUST-WP-0041-api-performance.md
View file

@ -2,7 +2,7 @@
id: CUST-WP-0041
type: workplan
title: "API Performance Optimization"
domain: custodian
domain: infotech
status: done
owner: custodian
topic_slug: custodian

2
workplans/CUST-WP-0043-state-hub-repo-extraction.md
View file

@ -2,7 +2,7 @@
id: CUST-WP-0043
type: workplan
title: "State Hub Repo Extraction"
domain: custodian
domain: infotech
repo: the-custodian
status: completed
owner: custodian

2
workplans/CUST-WP-0044-daily-statehub-wsjf-triage.md
View file

@ -2,7 +2,7 @@
id: CUST-WP-0044
type: workplan
title: "Daily State Hub WSJF Triage"
domain: custodian
domain: infotech
repo: the-custodian
status: finished
owner: custodian

2
workplans/CUST-WP-0045-activity-core-daily-triage-runner.md
View file

@ -2,7 +2,7 @@
id: CUST-WP-0045
type: workplan
title: "Activity-Core Daily Triage Runner Cutover"
domain: custodian
domain: infotech
repo: the-custodian
status: finished
owner: custodian

1
workplans/CUST-WP-0045-cutover-runbook.md
View file

@ -5,6 +5,7 @@ title: "CUST-WP-0045 T06 cutover — exact command sequence"
parent_workplan: CUST-WP-0045
created: "2026-06-01"
state_hub_workstream_id: "4ebc847b-4a2c-4ce2-9fd2-62d3071eed96"
domain: infotech
---
# CUST-WP-0045 T06 cutover — exact command sequence

2
workplans/CUST-WP-0046-hourly-recently-on-scope-activity-core.md
View file

@ -2,7 +2,7 @@
id: CUST-WP-0046
type: workplan
title: "Activity-Core Hourly RecentlyOnScope Reports"
domain: custodian
domain: infotech
repo: the-custodian
status: finished
owner: codex

2
workplans/CUST-WP-0047-ops-hub-service-inventory-now-view.md
View file

@ -2,7 +2,7 @@
id: CUST-WP-0047
type: workplan
title: "Ops Hub Service Inventory Now View"
domain: custodian
domain: infotech
repo: the-custodian
status: active
owner: codex

2
workplans/CUST-WP-0048-hub-core-state-hub-import-refactor.md
View file

@ -2,7 +2,7 @@
id: CUST-WP-0048
type: workplan
title: "Hub-Core State Hub Import Refactor"
domain: custodian
domain: infotech
repo: the-custodian
status: finished
owner: custodian

4
workplans/CUST-WP-0049-interhub-bootstrap-access-lane.md
View file

@ -2,7 +2,7 @@
id: CUST-WP-0049
type: workplan
title: "Inter-Hub Bootstrap Access Lane"
domain: custodian
domain: infotech
repo: the-custodian
status: active
owner: codex
@ -162,7 +162,7 @@ workplan has State Hub ids.
```task
id: CUST-WP-0049-T06
status: blocked
status: wait
priority: high
state_hub_task_id: "782b3846-f9c9-4acb-917b-fc1fcc6f2aec"
```

2
workplans/CUST-WP-0050-repo-classification-registration-redesign.md
View file

@ -2,7 +2,7 @@
id: CUST-WP-0050
type: workplan
title: "Repo Classification & State Hub Registration Redesign"
domain: custodian
domain: infotech
repo: the-custodian
status: finished
owner: custodian