tegwick
fe4cfe22c9
Add quality_doc/dor/dod recording convention, quality-debt CLI, promote-intake and C-34 soft warnings, agent protocol notes, and DoD policy badge language. Mark STATE-WP-0077 finished.
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: "a772c7cf-7172-486c-9c80-c70f6101db8f"
|
|
---
|
|
|
|
# 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: "483af4cf-3aa9-49de-910d-034a0895a9bb"
|
|
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: "ff318c88-86e6-4231-bc25-3bd936e63035"
|
|
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: "dd3e70b2-0335-438e-8e59-d905c046cee3"
|
|
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: "d620891f-562c-4c1d-8f72-fd13415e4a0a"
|
|
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)
|