Files
the-custodian/workplans/CUST-WP-0010-workstream-lifecycle-docs.md
tegwick 25b4dd07f5 feat(tasks): add needs_human intervention flag (CUST-WP-0009)
- Migration b4c5d6e7f8a9: adds needs_human (bool) + intervention_note (text) to tasks
- API: needs_human filter on GET /tasks/; 422 if flagged without note
- 3 MCP tools: flag_for_human, clear_human_flag, list_human_interventions
- Dashboard: interventions.md with amber cards and "Mark done" button
- Policy router + workstream DoD policy (workstream-dod.md)
- Workstream lifecycle docs page + workplan CUST-WP-0010
- CLAUDE.md: add step 4 (run fix-consistency after workplan writes)
- consistency_check.py: promote C-11 unlinked tasks from INFO to WARN

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-04 19:44:14 +01:00

2.2 KiB

id, type, title, domain, status, owner, topic_slug, state_hub_workstream_id, created, updated
id type title domain status owner topic_slug state_hub_workstream_id created updated
CUST-WP-0010 workplan Workstream Lifecycle Documentation custodian completed custodian the-custodian e73c41f1-45b7-4c92-8b45-3105a1936fff 2026-03-03 2026-03-03

CUST-WP-0010 — Workstream Lifecycle Documentation

Purpose

The dashboard "Workstreams by Domain" chart exposes seven computed states (active, accepted, finished, blocked, stalled, oldies + time-based modes). These need to be documented so that Bernd and the custodian share a common vocabulary, and so the "accepted" quality-gate pattern is clearly understood as the anchor for custodian review.

Scope

  • New dashboard reference page: docs/workstream-lifecycle.md
  • Update docs/workstreams.md status table to reflect new state names
  • Nav entry in observablehq.config.js

Files Changed

File Change
state-hub/dashboard/src/docs/workstream-lifecycle.md New reference page
state-hub/dashboard/src/docs/workstreams.md Update status table
state-hub/dashboard/observablehq.config.js Add nav entry

Tasks

Step 1: Write lifecycle docs page

id: CUST-WP-0010-T1
title: Create docs/workstream-lifecycle.md
status: done
priority: high
state_hub_task_id: "95e5810d-947a-4039-b017-9bee85cf4f48"

Step 2: Update workstreams reference

id: CUST-WP-0010-T2
title: Update docs/workstreams.md status table
status: done
priority: medium
state_hub_task_id: "30d61368-8ede-4d84-9f98-44fe6ff57dda"

Step 3: Add nav entry

id: CUST-WP-0010-T3
title: Add nav entry to observablehq.config.js
status: done
priority: medium
state_hub_task_id: "4cef0841-5324-4fbc-a44b-ad8520f77c9f"

Design Notes

  • "accepted" maps to DB status = "completed" — the name change reflects intent
  • The lifecycle is linear: active → finished (task-derived) → accepted (human+custodian gate)
  • Attention signals (blocked, stalled, oldies) are orthogonal — a workstream can be active AND stalled at the same time
  • The custodian uses the "finished but not accepted" gap as the trigger to run quality checks and create follow-up tasks before signing off