coulomb-loop/workplans/LOOP-WP-0001-kaizen-improvement-stack.md

---
id: LOOP-WP-0001
type: workplan
title: "Kaizen Improvement Stack (coach + metrics + optimization)"
domain: communication
repo: coulomb-loop
status: done
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: done
    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: done
    title: Expand pilot to three repos and record metrics at session close
  - id: T08
    status: done
    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:** done
**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: done
priority: high
state_hub_task_id: "16c54902-a1c5-4e24-9bc3-5c7b8c30abe3"
```

2026-06-18: `activity_core/context_resolvers/kaizen.py` shipped (7 tests pass).
Dry-run returned 6 scheduled runs. `ACTIVITY_DEFINITION_DIRS` includes coulomb-loop;
DB sync pending when `ACTCORE_DB_URL` stack is up. Enable definitions incrementally.

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: done
priority: medium
state_hub_task_id: "e60fa833-9407-460a-b1d1-7e08850fa291"
```

Completed 2026-06-18: 3/3 consecutive hourly E2E cycles (cron 09:00 chain + manual
cycles 2–3). Session-close metrics on all 3 pilots. Evidence: `bootstrap-log.md`.

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: done
priority: low
state_hub_task_id: "7c77ec4f-594c-4122-9c64-af5c4071446d"
```

Completed 2026-06-18: promoted to stabilize phase — daily crons (metrics 08:00,
coach 09:00, optimization 10:00). Updated pilot `schedule.yml`, activity-definitions,
and activity-core Temporal schedules. `loops/kaizen-stack/cadence.yml` approved.

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