codex
3cb256ef5c
These workplans exist only in the retired local hub. Their random pre-ADR-007 identifiers are refused by C-06 as stale references, so they cannot be registered. Deriving from the canonical record id takes no identity from anything: central does not hold them and the old ids die with the cache. Records central already holds were deliberately left untouched. Refs CUST-WP-0068-T06 Assistant: claude-code Assistant-Model: opus Assistant-Process: 2583210@bnt-lap001 Assistant-Session: f2bff2d5-e9b2-4338-92ca-10282a927006
136 lines
3.5 KiB
Markdown
136 lines
3.5 KiB
Markdown
---
|
|
id: STATE-WP-0077
|
|
type: workplan
|
|
title: "DoX assessment recording and soft visibility"
|
|
domain: infotech
|
|
repo: state-hub
|
|
status: finished
|
|
owner: grok
|
|
topic_slug: infotech
|
|
created: "2026-07-22"
|
|
updated: "2026-07-22"
|
|
reviewed_at: "2026-07-22"
|
|
reviewed_by: "grok"
|
|
reviewed_against_commit: "3008d9e"
|
|
context_paths:
|
|
- "docs/work-record-quality-gates.md"
|
|
- "policies/intake-doc.md"
|
|
- "policies/work-item-dor.md"
|
|
- "policies/workstream-dod.md"
|
|
- "dashboard/src/docs/work-records.md"
|
|
- "scripts/"
|
|
- ".claude/rules/"
|
|
- "AGENTS.md"
|
|
quality_dor: DoR-Ok
|
|
quality_dor_at: "2026-07-22"
|
|
quality_dor_by: "grok"
|
|
quality_dod: DoD-Ok
|
|
quality_dod_at: "2026-07-22"
|
|
quality_dod_by: "grok"
|
|
state_hub_workstream_id: "94f8149a-ee7c-59a9-97ad-63e786f1d7a5"
|
|
---
|
|
|
|
# STATE-WP-0077 — DoX assessment recording and soft visibility
|
|
|
|
## Goal
|
|
|
|
Make the **DoX badge convention from STATE-WP-0076 operational** without a
|
|
badge engine or hard gates:
|
|
|
|
1. **Record** last Definition assessments on work records (convention + light
|
|
storage).
|
|
2. **See** quality debt: e.g. workplans `finished` without DoD-Ok, `ready`
|
|
without DoR-Ok, intakes promoted/routed without DoC-Ok.
|
|
3. **Guide agents** with soft protocol (and optional cheap warnings).
|
|
|
|
Parent: `STATE-WP-0076` (finished).
|
|
|
|
## Delivered (2026-07-22)
|
|
|
|
| Deliverable | Location |
|
|
|-------------|----------|
|
|
| Recording convention + examples | `docs/work-record-quality-gates.md` |
|
|
| Parse helpers | `scripts/quality_assessment.py` |
|
|
| Debt list CLI | `scripts/quality_debt.py`, `statehub quality-debt` |
|
|
| Soft promote warning | `scripts/promote_intake.py` |
|
|
| Soft consistency | C-34 (ready¬DoR); finished¬DoD via quality-debt only |
|
|
| Agent protocol | `AGENTS.md`, `.claude/rules/session-protocol.md` |
|
|
| DoD badge language | `policies/workstream-dod.md` |
|
|
| Tests | `tests/test_quality_assessment.py` |
|
|
|
|
---
|
|
|
|
## Task: Assessment recording convention
|
|
|
|
```task
|
|
id: STATE-WP-0077-T01
|
|
status: done
|
|
priority: high
|
|
state_hub_task_id: "a525082c-78ce-57d4-b001-791d63459713"
|
|
quality_dor: DoR-Ok
|
|
quality_dor_at: "2026-07-22"
|
|
```
|
|
|
|
Canonical fields `quality_doc` / `quality_dor` / `quality_dod` (+ `_at`/`_by`/`_note`),
|
|
progress `event_type=quality_assessment`, examples in quality-gates doc.
|
|
|
|
---
|
|
|
|
## Task: Soft visibility — quality-debt list or digest
|
|
|
|
```task
|
|
id: STATE-WP-0077-T02
|
|
status: done
|
|
priority: high
|
|
state_hub_task_id: "07176070-df27-5746-9679-6dd072d463fd"
|
|
quality_dor: DoR-Ok
|
|
quality_dor_at: "2026-07-22"
|
|
```
|
|
|
|
`statehub quality-debt` / `scripts/quality_debt.py` — file workplans + intakes +
|
|
optional hub intakes.
|
|
|
|
---
|
|
|
|
## Task: Agent protocol and soft warnings
|
|
|
|
```task
|
|
id: STATE-WP-0077-T03
|
|
status: done
|
|
priority: medium
|
|
state_hub_task_id: "12bf4277-db50-55fc-b674-d027fbb7dbcd"
|
|
quality_dor: DoR-Ok
|
|
quality_dor_at: "2026-07-22"
|
|
```
|
|
|
|
AGENTS + session protocol; promote-intake soft WARN; C-34/C-35 soft WARN.
|
|
|
|
---
|
|
|
|
## Task: Align DoD policy wording with badge family
|
|
|
|
```task
|
|
id: STATE-WP-0077-T04
|
|
status: done
|
|
priority: low
|
|
state_hub_task_id: "499fe884-a3d6-5707-9666-e23e72a89058"
|
|
quality_dor: DoR-Ok
|
|
quality_dor_at: "2026-07-22"
|
|
```
|
|
|
|
`policies/workstream-dod.md` — applies_to workplan, DoD-Ok/Failed, finished ≠ DoD-Ok.
|
|
|
|
---
|
|
|
|
## Acceptance criteria
|
|
|
|
- [x] Canonical recording form documented and exemplified
|
|
- [x] At least one quality-debt list/digest works against live data
|
|
- [x] Agent protocol documents when to assess and how to record
|
|
- [x] No hard gates; no freeform badge engine
|
|
- [x] DoD policy mentions DoD-Ok / Failed / unassessed
|
|
|
|
## References
|
|
|
|
- `docs/work-record-quality-gates.md`
|
|
- `STATE-WP-0076` (parent)
|