feat(terminology): prose sweep tool and custodian workplan cleanup (CUST-WP-0055 T04)
Add sweep_workstream_prose.py for agent-guidance files, sweep active workplan prose in-repo, tighten scan allowlist exclusions, and update ADR-001 closure protocol to workplan-first terminology.
This commit is contained in:
parent
3bdefb3c4a
commit
2e0deee2ef
42 changed files with 312 additions and 186 deletions
|
|
@ -51,12 +51,12 @@ available fallback and say so in the report.
|
|||
3. `GET http://127.0.0.1:8000/messages/?to_agent=hub&unread_only=true`
|
||||
4. `GET http://127.0.0.1:8000/state/next_steps`
|
||||
5. `GET http://127.0.0.1:8000/workstreams/workplan-index`
|
||||
6. Local workplan files for candidate workstreams that need closer inspection
|
||||
6. Local workplan files for candidate workplans that need closer inspection
|
||||
7. Read-only `git status --short` for repos named in top recommendations
|
||||
|
||||
Optional enrichment:
|
||||
|
||||
- `GET /tasks/?workstream_id=<id>` for a top-ranked workstream
|
||||
- `GET /tasks/?workstream_id=<id>` for a top-ranked workplan
|
||||
- `GET /progress/?workstream_id=<id>&limit=5` for staleness confidence
|
||||
- State Hub domain summaries through MCP when available
|
||||
|
||||
|
|
@ -64,11 +64,11 @@ Optional enrichment:
|
|||
|
||||
Build the candidate list from:
|
||||
|
||||
- all open workstreams in `state_summary.open_workstreams`
|
||||
- all open workplans in `state_summary.open_workstreams`
|
||||
- all derived `state_summary.next_steps`
|
||||
- blocked tasks and blocking decisions from the summary
|
||||
- high-priority file-backed workplans surfaced by `workplan-index`
|
||||
- workstreams with suspicious structure, such as zero parsed tasks or stale
|
||||
- workplans with suspicious structure, such as zero parsed tasks or stale
|
||||
active plans
|
||||
|
||||
Keep the scored table compact. Score at most 15 candidates internally and
|
||||
|
|
@ -83,9 +83,9 @@ Flag a candidate when one or more signals apply:
|
|||
| Active with no recent progress | no progress in 14 days, or 7 days for high-priority items | `revisit` |
|
||||
| Large unstarted plan | `tasks_total >= 6`, `tasks_done == 0`, `tasks_in_progress == 0` | `split` or `revisit` |
|
||||
| Near complete | `tasks_done / tasks_total >= 0.75` and `tasks_todo <= 3` | `close-out` or `work-next` |
|
||||
| Zero parsed tasks | active or blocked workstream with `tasks_total == 0` | `needs-consistency-sync` |
|
||||
| Blocked but dependency appears closed | blocked workstream with cleared dependency or empty blocked reason | `revisit` |
|
||||
| Open decision blocks execution | blocking decision connected to workstream/task | `needs-human` |
|
||||
| Zero parsed tasks | active or blocked workplan with `tasks_total == 0` | `needs-consistency-sync` |
|
||||
| Blocked but dependency appears closed | blocked workplan with cleared dependency or empty blocked reason | `revisit` |
|
||||
| Open decision blocks execution | blocking decision connected to workplan/task | `needs-human` |
|
||||
| File-backed mismatch | missing index entry, stale `updated`, `needs_review`, or status disagreement | `needs-consistency-sync` |
|
||||
| Too broad for one session | many unrelated task clusters in one workplan | `split` |
|
||||
| Safety-sensitive | security, identity, secrets, legal, external reputation, money | `needs-human` |
|
||||
|
|
@ -110,7 +110,7 @@ Score higher when the work aligns with:
|
|||
- dependency-chain foundations: Railiance, identity, secrets, backup, HA
|
||||
- explicit `planning_priority: high` or low `planning_order`
|
||||
- active repo/domain goals
|
||||
- closing a workstream that is already consuming coordination attention
|
||||
- closing a workplan that is already consuming coordination attention
|
||||
|
||||
### Time Criticality
|
||||
|
||||
|
|
@ -134,7 +134,7 @@ Score higher when the work reduces:
|
|||
|
||||
Score higher when the work unlocks:
|
||||
|
||||
- multiple downstream workstreams
|
||||
- multiple downstream workplans
|
||||
- agent autonomy or fewer repeated setup steps
|
||||
- reliable cross-repo operation
|
||||
- future daily triage quality
|
||||
|
|
@ -191,7 +191,7 @@ source: daily-state-hub-wsjf-triage
|
|||
## Snapshot
|
||||
|
||||
- Generated at: <timestamp>
|
||||
- Workstreams: <active> active, <blocked> blocked, <finished> finished
|
||||
- Workplans: <active> active, <blocked> blocked, <finished> finished
|
||||
- Tasks: <todo> todo, <in_progress> in progress, <blocked> blocked
|
||||
- Decisions: <open> open, <escalated> escalated
|
||||
- Inbox: <count> unread hub messages
|
||||
|
|
@ -201,7 +201,7 @@ source: daily-state-hub-wsjf-triage
|
|||
|
||||
| Rank | Action | Candidate | WSJF | Confidence | Why now |
|
||||
|------|--------|-----------|------|------------|---------|
|
||||
| 1 | work-next | <workstream/task> | 0.0 | high | <short reason> |
|
||||
| 1 | work-next | <workplan/task> | 0.0 | high | <short reason> |
|
||||
|
||||
## Loose Ends
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue