tegwick 3008d9e2f0

CI Smoke / host-smoke (push) Successful in 0s

Details

CI Smoke / container-smoke (push) Successful in 2s

Details

feat: ship DoC and DoR quality policies (STATE-WP-0076)

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.

2026-07-22 19:59:37 +02:00

5.5 KiB

Raw Blame History

id type title domain repo status owner topic_slug created updated reviewed_at reviewed_by reviewed_against_commit context_paths state_hub_workstream_id

STATE-WP-0076

workplan

Definition of Ready (DoR) and Definition of Comprehension (DoC) quality gates

infotech

state-hub

finished

grok

infotech

2026-07-22

grok

d8a2bb5c6b

policies/

dashboard/src/docs/work-records.md

dashboard/src/docs/intakes.md

dashboard/src/docs/workstream-lifecycle.md

dashboard/src/policy/

docs/work-record-quality-gates.md

workplans/STATE-WP-0076-definition-of-ready-and-comprehension.md

72d64a42-bb87-4842-839d-3d4ed783ff2d

STATE-WP-0076 — DoR and DoC quality gates

Goal

Ship the next slice of the work-record quality model that pays off soon:

Policies in the existing DoI / DoM / DoD family: DoC (intake) and DoR (task + workplan sections).
Dashboard edit/view surfaces like the other policies.
Docs that fix terminology: work-record as generic coordination artefact (units and structure), lifecycle ≠ definition assessment, badge spelling DoX-Ok / DoX-Failed / unassessed.

No badge engine, no hard API blocks, no new kinds, no value-chain typing.

Delivered (2026-07-22)

Deliverable	Path
Quality model note	`docs/work-record-quality-gates.md`
DoC policy	`policies/intake-doc.md` → `GET /policy/intake-doc`
DoR policy	`policies/work-item-dor.md` → `GET /policy/work-item-dor`
Dashboard pages	`dashboard/src/policy/intake-doc.md`, `work-item-dor.md`
Nav	Policies: Intake DoC, Work-item DoR
Reference links	work-records, intakes, workplan lifecycle, tasks

Design constraints (shipped)

Lifecycle state ≠ definition badge (DoX-Ok / DoX-Failed / unassessed).
Badge family closed and named after policies.
Policies declare applies_to; DoR has task and workplan sections.
DoC = intake only; DoR = task + workplan.
Outside-originated = policy sections, not a new kind.
Enforcement = convention + docs only.

Task: Quality model + work-record roles in docs

id: STATE-WP-0076-T01
status: done
priority: high
state_hub_task_id: "53aac055-97a7-405b-bb9b-48427de4296a"

Short design/reference write-up only (no product build):

Update dashboard/src/docs/work-records.md: work-record as generic mode for units and structure (plans/collections); unit vs structure table; quality badges vs lifecycle; link to policies when they exist.
Add docs/work-record-quality-gates.md: Definition family (DoI/DoM/DoC/DoR/DoD), badge spelling, applies_to matrix, outside profile pointer, explicit non-goals.
One cross-link from intakes + workplan lifecycle docs.

Done when: an agent can explain unit vs structure and DoR-Ok vs status=ready from the docs alone.

Task: Author DoC policy

id: STATE-WP-0076-T02
status: done
priority: high
state_hub_task_id: "2498bd9f-e773-4dad-a2e3-9c32b5585d73"

Create policies/intake-doc.md (Definition of Comprehension).

applies_to: intake
Core checklist (signal, why it matters, unknowns, provisional ownership or “unknown”, next action)
Outside-originated section
Explicit: DoC ≠ DoR; assessment outcomes DoC-Ok / DoC-Failed / unassessed
Loadable as GET /policy/intake-doc

Done when: policy file exists and is readable via the policy API.

Task: Author DoR policy

id: STATE-WP-0076-T03
status: done
priority: high
state_hub_task_id: "a1e7ab93-c0b9-423c-84d8-1e9dcff9ebc7"

Create policies/work-item-dor.md (Definition of Ready) — filename keeps “work-item” as the delivery-side gate name; body uses task and workplan sections (not “workplan is a work-item”).

Per-kind sections: task, workplan
Outside-originated section
Link to workstream-dod.md as exit companion (DoD-Ok separate from finished)
Assessment outcomes DoR-Ok / DoR-Failed / unassessed
Loadable as GET /policy/work-item-dor

Done when: policy file exists and is readable via the policy API.

Task: Dashboard policy pages + nav

id: STATE-WP-0076-T04
status: done
priority: high
state_hub_task_id: "d4aa3c53-3aa0-492f-b721-1c4e7e75bcb6"

Mirror DoI/DoM/DoD:

dashboard/src/policy/intake-doc.md, dashboard/src/policy/work-item-dor.md
Policies entries in observablehq.config.js
Links from work-records reference (+ quality-gates doc)

Done when: Policies menu shows DoC and DoR; edit/view works against the API.

Cancelled / deferred tasks

id: STATE-WP-0076-T05
status: cancel
priority: medium
state_hub_task_id: "80f612f4-4a8a-4e2c-9cbb-08dfb27264af"

Soft enforcement hooks — deferred until DoC/DoR text is in use.

id: STATE-WP-0076-T06
status: cancel
priority: low
state_hub_task_id: "fb6b81a0-208e-4a33-af33-776867411b7d"

Standalone DoD naming / family index task — folded into T01 quality-gates doc.

Acceptance criteria

Docs: generic work-record (unit + structure), lifecycle ≠ DoX badge
policies/intake-doc.md and policies/work-item-dor.md live and API-served
Outside-originated sections present in both
Dashboard Policies nav includes both
No new kinds, no badge engine, no hard enforcement

References

the-custodian/canon/standards/work-record-types_v0.1.md
policies/repo-doi.md, policies/service-dom.md, policies/workstream-dod.md
dashboard/src/docs/work-records.md, intakes.md, workstream-lifecycle.md
api/routers/policy.py

5.5 KiB Raw Blame History