# SCOPE

## One-liner

Customer engagement repository for Coulomb fleet self-improvement loops — contracts, rosters, and activity definitions; not agent runtime.

## Core Idea

Coulomb hires kaizen-agentic as supplier. `coulomb-loop` organizes **what** runs,
**where**, and **how often**; supplier agents execute in **target fleet repos**
with project-scoped memory and metrics.

## In Scope

- Engagement INTENT, workplans (LOOP-WP-*), ADRs, decision proposals
- Loop rosters, cadence state, health records under `loops/`
- ActivityDefinition copies for activity-core sync
- state-hub workstream and progress event coordination
- History and assessment artefacts
- reuse-surface capability registration for the engagement itself

## Out of Scope

- Kaizen agent definitions (supplier: `kaizen-agentic`)
- Temporal scheduling and context resolvers (owner: `activity-core`)
- State-hub service code (owner: `state-hub` / `the-custodian`)
- Application code for Coulomb products (e.g. `vergabe-teilnahme`)
- `.kaizen/` runtime state in this repo (lives in target repos)

## Relevant When

- Operating or extending Coulomb fleet self-improvement loops
- Onboarding a new loop or cadence phase
- Reviewing supplier engagement health (LOOP-WP-0004)

## Not Relevant When

- Authoring or publishing kaizen agents (use `kaizen-agentic`)
- Implementing activity-core resolvers (use `activity-core`)
- Product feature work in coulomb_social apps

## Current State

- Status: active (operate — weekly cadence)
- Implementation: four loops operational on custodian pilot roster (3 repos)
- Stability: observation window closed 2026-06-19 via DEC-008 operator override (LOOP-WP-0005 done)
- Usage: internal engagement; weekly Mon crons live; activity-core sync pending

## How It Fits

- Upstream: `kaizen-agentic` (supplier), `state-hub` (roster), `reuse-surface` (registry signals)
- Downstream: `activity-core` (task factory), target fleet repos (execution)
- Often used with: `the-custodian`, `issue-core`

## Getting Oriented

- Start with: `INTENT.md`, `.custodian-brief.md`
- Key paths: `workplans/`, `docs/adr/`, `docs/decisions/`, `history/`
- Pending decisions: `docs/decisions/DEC-*.md`

## Related Repositories

- `kaizen-agentic` — supplier agents and CLI
- `activity-core` — scheduled task execution
- `reuse-surface` — capability registry federation
- `the-custodian` — coordination and state-hub operator