Files
coulomb-loop/SCOPE.md
tegwick 27e05552a2 Complete LOOP-WP-0005: DEC-008 weekly operate promotion
Operator override per ADR-003 closes the stabilize observation window
early (day 2/14) and promotes all four loops to weekly Mon crons.
Activity definitions renamed coulomb-daily-* → coulomb-weekly-*;
cadence.yml, dashboard, SCOPE, and health records updated.
activity-core definition sync still required on operator side.
2026-06-19 01:39:47 +02:00

66 lines
2.4 KiB
Markdown

# 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