state-hub/workplans/STATE-WP-0077-dox-assessment-recording-and-soft-visibility.md
codex 3cb256ef5c
All checks were successful
CI Smoke / host-smoke (push) Successful in 0s
CI Smoke / container-smoke (push) Successful in 1s
fix(workplans): adopt ADR-007 derived identifiers for unregistered records
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
2026-08-25 20:22:27 +02:00

3.5 KiB

id type title domain repo status owner topic_slug created updated reviewed_at reviewed_by reviewed_against_commit context_paths quality_dor quality_dor_at quality_dor_by quality_dod quality_dod_at quality_dod_by state_hub_workstream_id
STATE-WP-0077 workplan DoX assessment recording and soft visibility infotech state-hub finished grok infotech 2026-07-22 2026-07-22 2026-07-22 grok 3008d9e
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
DoR-Ok 2026-07-22 grok DoD-Ok 2026-07-22 grok 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

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

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

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

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

  • Canonical recording form documented and exemplified
  • At least one quality-debt list/digest works against live data
  • Agent protocol documents when to assess and how to record
  • No hard gates; no freeform badge engine
  • DoD policy mentions DoD-Ok / Failed / unassessed

References

  • docs/work-record-quality-gates.md
  • STATE-WP-0076 (parent)