state-hub/workplans/STATE-WP-0077-dox-assessment-recording-and-soft-visibility.md
tegwick fe4cfe22c9
All checks were successful
CI Smoke / host-smoke (push) Successful in 1s
CI Smoke / container-smoke (push) Successful in 2s
feat: DoX assessment recording and soft visibility (STATE-WP-0077)
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.
2026-07-22 21:18:40 +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 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

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

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

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

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

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