Files
activity-core/workplans/ACTIVITY-WP-0008-weekly-coding-retro.md

3.6 KiB

id, type, title, domain, repo, status, owner, topic_slug, created, updated, state_hub_workstream_id
id type title domain repo status owner topic_slug created updated state_hub_workstream_id
ACTIVITY-WP-0008 workplan Weekly Coding Retrospection schedule (Saturday evenings) custodian activity-core blocked codex custodian 2026-06-07 2026-06-07 7387fc50-1f2c-471a-9d85-bb085cbd0b63

Weekly Coding Retrospection schedule (Saturday evenings)

Origin: requested from the helix_forge domain. Every Saturday 19:00 Europe/Berlin, read the previous week's coding-session analysis (published to the hub by helix_forge session-memory) and open one improvement suggestion per relevant repo — the three most promising.

This is the same shape as the existing weekly-sbom-staleness activity-definition (cron → context resolver → per-repo task emission); only the data source is new.

Dependency: AGENTIC-WP-0010 (helix_forge) publishes the event_type=coding_retro read model this schedule consumes. That side computes and ranks (top-3 per repo, cross-flavor first, recommendations from the Pattern Catalog); this side schedules and routes.

coding_retro Context Resolver

id: ACTIVITY-WP-0008-T01
status: done
priority: high
state_hub_task_id: "26846304-f5f1-4edf-aba3-227c9b11c9fa"

Add a context resolver (context_resolvers/) returning the latest weekly coding-retro published to the hub (event_type=coding_retro): its suggestions[] (repo, title, recommendation, priority, score), window, and generated_at. Bind under context.retro. Mirror the repo_sbom_status resolver shape so rules can for_each over context.retro.suggestions.

2026-06-07: Implemented query: coding_retro in the State Hub context resolver. It reads recent /progress/ items, selects the latest event_type=coding_retro, normalizes suggestions[], and returns an empty suggestion list while the upstream publisher has not produced a read model yet.

weekly-coding-retro Activity-Definition

id: ACTIVITY-WP-0008-T02
status: done
priority: high
state_hub_task_id: "09eeacb7-dc0d-4617-8398-a99a4e5a227e"

Add activity-definitions/weekly-coding-retro.md: cron 0 19 * * 6 Europe/Berlin, context_source coding_retro, and a rule that for_each over context.retro.suggestions emits one improvement task to target_repo with the suggestion title + recommendation, priority, and labels [coding-retro, improvement, automated]. Ship enabled: false until the resolver

  • publish are verified. A starter draft is provided at activity-definitions/weekly-coding-retro.md (proposed by helix_forge).

2026-06-07: Updated the starter definition against the implemented resolver: cron Saturday 19:00 Europe/Berlin, context_source coding_retro bound to context.retro, and a rule that emits one positive-score suggestion per target repo with the coding-retro/improvement/automated labels. It remains enabled: false until live publish verification succeeds.

Dry-Run Verify + Enable + Docs

id: ACTIVITY-WP-0008-T03
status: wait
priority: medium
state_hub_task_id: "9dcbebe7-13dd-4957-9a72-858418049aef"

Dry-run the definition end-to-end against a published coding_retro read model; confirm one task per relevant repo (≤ 3) with correct routing and no duplicates on re-run. Flip enabled: true. Document alongside weekly-sbom-staleness. After workplan updates, run from ~/state-hub:

make fix-consistency REPO=activity-core

2026-06-07: Added fixture-level dry-run coverage and runbook documentation. Live State Hub did not yet expose a published event_type=coding_retro progress item, so the real dry-run, duplicate check, and enabled: true flip remain blocked on AGENTIC-WP-0010.