tegwick
e783dc9a2b
Register with state-hub, accept DEC-001–004 and ADR-004 rotation policy, scaffold pilot roster, hourly ActivityDefinition copies, and bootstrap log after schedule init on three custodian pilot repos.
281 lines
No EOL
8.5 KiB
Markdown
281 lines
No EOL
8.5 KiB
Markdown
---
|
||
id: LOOP-WP-0001
|
||
type: workplan
|
||
title: "Kaizen Improvement Stack (coach + metrics + optimization)"
|
||
domain: coulomb_social
|
||
repo: coulomb-loop
|
||
status: active
|
||
owner: coulomb-loop
|
||
topic_slug: coulomb_social
|
||
supplier: kaizen-agentic
|
||
created: "2026-06-18"
|
||
updated: "2026-06-18"
|
||
depends_on: []
|
||
tasks:
|
||
- id: T01
|
||
status: done
|
||
title: Register coulomb-loop in state-hub and sync workplans
|
||
- id: T02
|
||
status: done
|
||
title: Declare pilot roster for kaizen improvement stack
|
||
- id: T03
|
||
status: done
|
||
title: Scaffold .kaizen/schedule.yml on pilot target repos
|
||
- id: T04
|
||
status: done
|
||
title: Copy and tune ActivityDefinitions for hourly bootstrap cadence
|
||
- id: T05
|
||
status: todo
|
||
title: activity-core handoff — enable resolver and sync definitions
|
||
- id: T06
|
||
status: done
|
||
title: Hourly bootstrap smoke test on single pilot repo
|
||
- id: T07
|
||
status: todo
|
||
title: Expand pilot to three repos and record metrics at session close
|
||
- id: T08
|
||
status: todo
|
||
title: Promote cadence to daily after bootstrap exit criteria met
|
||
state_hub_workstream_id: "90a05147-7b95-4ce7-96bf-39cdb487b557"
|
||
---
|
||
|
||
# LOOP-WP-0001 — Kaizen Improvement Stack
|
||
|
||
**Status:** active
|
||
**Owner:** coulomb-loop (customer)
|
||
**Supplier:** kaizen-agentic
|
||
**Repo:** coulomb-loop
|
||
|
||
## Goal
|
||
|
||
Establish the **primary self-improvement loop** for the Coulomb fleet: a chained
|
||
sequence that turns project metrics into coach synthesis and optimization action.
|
||
|
||
```mermaid
|
||
flowchart LR
|
||
AC[activity-core hourly cron]
|
||
RES[discover_kaizen_scheduled_repos]
|
||
M[metrics optimize]
|
||
C[schedule prepare coach]
|
||
O[schedule prepare optimization]
|
||
AC --> RES --> M --> C --> O
|
||
```
|
||
|
||
This loop generalizes the supplier's Monday Stack (`weekly-metrics-optimize` →
|
||
`weekly-coach-orientation` → `weekly-optimization-review`) into a **cadence-ramped**
|
||
engagement starting at **hourly** during bootstrap.
|
||
|
||
## Customer / supplier boundary
|
||
|
||
| coulomb-loop (customer) | kaizen-agentic (supplier) |
|
||
|-------------------------|---------------------------|
|
||
| Pilot roster, acceptance criteria, cadence policy | Agent prompts, `schedule` / `metrics` CLI, ADR-005 contract |
|
||
| ActivityDefinition copies under `activity-definitions/` | Reference definitions in `docs/integrations/activity-definitions/` |
|
||
| Loop health records in `loops/kaizen-stack/` | Customer-repo bootstrap learnings fed back to supplier |
|
||
|
||
Agents (`coach`, `optimization`) accumulate memory in **target repos**, not in
|
||
`coulomb-loop`. This repo holds contracts and operations only.
|
||
|
||
## Cadence ramp
|
||
|
||
| Phase | Cron (Europe/Berlin) | ActivityDefinitions |
|
||
|-------|----------------------|---------------------|
|
||
| Bootstrap | `0 * * * *` (hourly) | `hourly-metrics-optimize`, `hourly-coach-orientation`, `hourly-optimization-review` |
|
||
| Stabilize | `0 8 * * *` (daily 08:00) | rename/switch to daily variants |
|
||
| Operate | Mon 08:00–10:00 (weekly) | align with supplier weekly templates |
|
||
|
||
Promotion from hourly → daily requires LOOP-WP-0004 regulator sign-off after
|
||
bootstrap exit criteria (see Part 4).
|
||
|
||
## Part 1 — Engagement bootstrap
|
||
|
||
## Register coulomb-loop in state-hub
|
||
|
||
```task
|
||
id: LOOP-WP-0001-T01
|
||
status: done
|
||
priority: high
|
||
state_hub_task_id: "c66d2e98-8f3e-4119-89e7-2b6f67b6596d"
|
||
```
|
||
|
||
Completed 2026-06-18: `register_project.sh coulomb_social`, topic_id patched,
|
||
`fix-consistency` indexed LOOP-WP-0001–0004. See LOOP-WP-0000.
|
||
|
||
## Declare pilot roster
|
||
|
||
```task
|
||
id: LOOP-WP-0001-T02
|
||
status: done
|
||
priority: high
|
||
state_hub_task_id: "65994889-2f41-46e3-9c47-00cedc59fd81"
|
||
```
|
||
|
||
DEC-001 option A accepted. `loops/kaizen-stack/roster.yaml` committed with
|
||
`active` (3 custodian pilots), `expansion_queue`, and `saturated` per ADR-004.
|
||
|
||
## Scaffold schedule opt-in on pilot repos
|
||
|
||
```task
|
||
id: LOOP-WP-0001-T03
|
||
status: done
|
||
priority: high
|
||
state_hub_task_id: "2293b8bd-20b1-4d54-bd1c-8311004e59f9"
|
||
```
|
||
|
||
Completed 2026-06-18: `schedule init`, `memory init coach|optimization`, bootstrap
|
||
hourly crons (`coach :15`, `optimization :30`) on kaizen-agentic, the-custodian,
|
||
activity-core. All `schedule validate` pass.
|
||
|
||
## Scaffold schedule opt-in on pilot repos (reference)
|
||
|
||
In each pilot **target repo** (not coulomb-loop):
|
||
|
||
```bash
|
||
kaizen-agentic schedule init --timezone Europe/Berlin
|
||
kaizen-agentic schedule validate
|
||
```
|
||
|
||
Override defaults for bootstrap:
|
||
|
||
```yaml
|
||
agents:
|
||
coach:
|
||
cadence: daily # schema enum; cron carries hourly during bootstrap
|
||
cron: "0 * * * *"
|
||
enabled: true
|
||
optimization:
|
||
cadence: daily
|
||
cron: "30 * * * *" # offset 30 min after metrics+coach chain
|
||
enabled: true
|
||
```
|
||
|
||
Commit `.kaizen/schedule.yml` in each pilot repo. Initialize metrics dirs:
|
||
`kaizen-agentic memory init coach` and `memory init optimization` (creates metrics scaffold).
|
||
|
||
## Part 2 — activity-core integration
|
||
|
||
## Copy and tune ActivityDefinitions
|
||
|
||
```task
|
||
id: LOOP-WP-0001-T04
|
||
status: done
|
||
priority: high
|
||
state_hub_task_id: "53025f59-f00a-4792-950a-878e867803b2"
|
||
```
|
||
|
||
Five definitions in `coulomb-loop/activity-definitions/` (hourly stack + quality).
|
||
Handoff doc: `docs/integrations/activity-core-handoff.md`.
|
||
|
||
Copy supplier templates into `coulomb-loop/activity-definitions/`:
|
||
|
||
| File | Based on | Bootstrap cron |
|
||
|------|----------|----------------|
|
||
| `hourly-metrics-optimize.md` | `weekly-metrics-optimize` | `0 * * * *` |
|
||
| `hourly-coach-orientation.md` | `weekly-coach-orientation` | `15 * * * *` |
|
||
| `hourly-optimization-review.md` | `weekly-optimization-review` | `30 * * * *` |
|
||
|
||
Set `owner: coulomb-loop`, `governance: coulomb_social`, `enabled: false` until
|
||
smoke test passes. Resolver params: `domain: custodian` for pilot, `cadence: daily`
|
||
(schema) with per-repo cron override from schedule.yml.
|
||
|
||
## activity-core handoff
|
||
|
||
```task
|
||
id: LOOP-WP-0001-T05
|
||
status: todo
|
||
priority: high
|
||
state_hub_task_id: "16c54902-a1c5-4e24-9bc3-5c7b8c30abe3"
|
||
```
|
||
|
||
Open coordination track with activity-core:
|
||
|
||
1. Implement `discover_kaizen_scheduled_repos` per supplier spec (if not done)
|
||
2. `make sync-activity-definitions` with coulomb-loop copies
|
||
3. Dry-run resolver against pilot roster
|
||
4. Enable one definition at a time (`hourly-metrics-optimize` first)
|
||
|
||
Reference: `docs/integrations/activity-core-handoff.md` (coulomb-loop) and
|
||
`kaizen-agentic/docs/integrations/activity-core-handoff-wp0006.md` (supplier).
|
||
|
||
## Part 3 — Pilot and promote
|
||
|
||
## Hourly bootstrap smoke test (single repo)
|
||
|
||
```task
|
||
id: LOOP-WP-0001-T06
|
||
status: done
|
||
priority: medium
|
||
state_hub_task_id: "a5ecda96-f299-421c-b393-ae54bfbf9ae0"
|
||
```
|
||
|
||
Smoke pass on all 3 pilots (prepare bundles 6.9–9.7 KB). Log:
|
||
`loops/kaizen-stack/bootstrap-log.md`. activity-core wiring still pending (T05).
|
||
|
||
On `kaizen-agentic` only:
|
||
|
||
```bash
|
||
kaizen-agentic schedule validate
|
||
kaizen-agentic schedule prepare coach
|
||
kaizen-agentic metrics optimize
|
||
kaizen-agentic schedule prepare optimization
|
||
```
|
||
|
||
Verify non-empty prepare bundles. Manually simulate activity-core task payload.
|
||
Record outcome in `loops/kaizen-stack/bootstrap-log.md`.
|
||
|
||
**Bootstrap exit (single repo):** 3 consecutive hours where all three steps complete
|
||
without manual intervention.
|
||
|
||
## Three-repo pilot with metrics
|
||
|
||
```task
|
||
id: LOOP-WP-0001-T07
|
||
status: todo
|
||
priority: medium
|
||
state_hub_task_id: "e60fa833-9407-460a-b1d1-7e08850fa291"
|
||
```
|
||
|
||
Enable activity-core definitions for full pilot roster. Each session close:
|
||
|
||
```bash
|
||
kaizen-agentic metrics record coach --success --time <s> --quality <0-1>
|
||
kaizen-agentic metrics record optimization --success --time <s> --quality <0-1>
|
||
```
|
||
|
||
**Bootstrap exit (fleet pilot):** 3 consecutive hourly cycles across all 3 repos.
|
||
|
||
## Promote to daily cadence
|
||
|
||
```task
|
||
id: LOOP-WP-0001-T08
|
||
status: todo
|
||
priority: low
|
||
state_hub_task_id: "7c77ec4f-594c-4122-9c64-af5c4071446d"
|
||
```
|
||
|
||
After LOOP-WP-0004 regulator approves:
|
||
|
||
1. Update pilot `schedule.yml` crons to daily (`0 8`, `0 9`, `0 10`)
|
||
2. Switch activity-core definitions to daily variants
|
||
3. Record promotion decision in state-hub
|
||
|
||
## Definition of done
|
||
|
||
- Hourly loop runs end-to-end on 3 pilot repos via activity-core task creation
|
||
- `schedule prepare` bundles are actionable in coding-agent sessions
|
||
- Metrics recorded for coach and optimization on each run
|
||
- Cadence promotion path documented and ready for regulator approval
|
||
|
||
## Out of scope
|
||
|
||
- Fleet-wide rollout beyond pilot (follows LOOP-WP-0004 approval)
|
||
- Implementing resolvers in coulomb-loop (activity-core owns runtime)
|
||
- Headless LLM invocation
|
||
|
||
## Supplier feedback (for kaizen-agentic)
|
||
|
||
Capture in `loops/kaizen-stack/supplier-notes.md`:
|
||
|
||
- friction from `schedule init` / `prepare` on customer engagement
|
||
- missing CLI flags for engagement repos
|
||
- template gaps for customer ActivityDefinition copies |