---
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)
