coulomb/state-hub
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

feat: ship DoC and DoR quality policies (STATE-WP-0076)
All checks were successful
CI Smoke / host-smoke (push) Successful in 0s
Details
CI Smoke / container-smoke (push) Successful in 2s
Details

Browse source 
Add Intake Definition of Comprehension and work-item Definition of Ready as
hub policies with dashboard edit surfaces, document the Definition family and
DoX-Ok/Failed badge convention, and mark STATE-WP-0076 finished.
This commit is contained in:
tegwick 2026-07-22 19:59:37 +02:00
parent 5a392385bc
commit 3008d9e2f0
13 changed files with 573 additions and 80 deletions
Download patch file Download diff file Expand all files Collapse all files

6
dashboard/src/docs/intakes.md
View file

@ -16,6 +16,12 @@ Umbrella: [Work Records](/docs/work-records).
Intakes **replace** the retired hub **suggestion** backlog for new work. See
[Suggestions (legacy)](/docs/suggestions).
**Quality:** discovery comprehension is governed by
[Definition of Comprehension (DoC)](/policy/intake-doc) (`DoC-Ok` /
`DoC-Failed` / unassessed). DoC is independent of lifecycle `status` and is
**not** implementation readiness ([DoR](/policy/work-item-dor)). Model:
`docs/work-record-quality-gates.md`.
---
## Lifecycle

5
dashboard/src/docs/tasks.md
View file

@ -8,8 +8,9 @@ The Tasks page shows all tasks across every workplan and domain, with live
filtering, a workstation distribution chart, and a waiting-tasks highlight
section.
A **task** is a work-record kind: the smallest executable unit. Tasks always
belong to a workplan. Umbrella: [Work Records](/docs/work-records).
A **task** is a work-record kind: the smallest executable unit (work-item).
Tasks always belong to a workplan. Umbrella: [Work Records](/docs/work-records).
Implementation-readiness: [DoR](/policy/work-item-dor).
---

12
dashboard/src/docs/work-records.md
View file

@ -76,8 +76,16 @@ Assessments do **not** invent extra lifecycle states. Outcomes are:
A workplan may be `status=finished` without **DoD-Ok**, or `status=ready`
without **DoR-Ok**. That is allowed: process can advance while quality debt
stays visible. Policies live under `policies/` (same pattern as Repository DoI
and Service DoM). **DoC** (intake) and **DoR** (task/workplan) are introduced
by workplan `STATE-WP-0076`.
and Service DoM):
| Policy | Dashboard | Rates |
|--------|-----------|-------|
| **DoC** | [Intake DoC](/policy/intake-doc) | Discovery quality (`intake`) |
| **DoR** | [Work-item DoR](/policy/work-item-dor) | Implementation-readiness (`task`, `workplan`) |
| **DoD** | [Workplan DoD](/policy/workstream-dod) | Completion quality (workplan) |
Full matrix and badge spelling: repo doc `docs/work-record-quality-gates.md`
(STATE-WP-0076).
Discovery quality (intake) is **not** the same as implementation-readiness
(task/workplan). Outside or sparse-context signals should be comprehended

7
dashboard/src/docs/workstream-lifecycle.md
View file

@ -16,6 +16,13 @@ The product term is **workplan**. **Workstream** remains a legacy compatibility
name in some fields (notably frontmatter `state_hub_workstream_id`) and
historical URLs; it refers to the same entity.
**Quality vs lifecycle:** `status=ready` or `status=finished` is process state.
Implementation-readiness and completion quality are separate assessments —
[DoR](/policy/work-item-dor) (`DoR-Ok` / `DoR-Failed`) and
[DoD](/policy/workstream-dod) (`DoD-Ok` / `DoD-Failed`). A finished workplan
without DoD-Ok is allowed quality debt. See
`docs/work-record-quality-gates.md`.
---
## Stored lifecycle states