generated from coulomb/repo-seed
feat: complete LOOP-WP-0003 and LOOP-WP-0004
Registry hygiene: 3-round pilot bootstrap smoke, helix_forge rollout expansion, daily cadence promotion (DEC-006). Loop regulator: daily collector and weekly session cadence (DEC-007), rotation runbook (T09).
This commit is contained in:
52
loops/regulator/rotation-runbook.md
Normal file
52
loops/regulator/rotation-runbook.md
Normal file
@@ -0,0 +1,52 @@
|
||||
# Repo rotation runbook (ADR-004)
|
||||
|
||||
LOOP-WP-0004 T09 — manual rotation during bootstrap; automation deferred to
|
||||
`kaizen-agentic metrics rotation-signals` CLI.
|
||||
|
||||
## Saturation assessment
|
||||
|
||||
Per `rotation-policy.yml`, compute signals for each active repo (14-cycle window):
|
||||
|
||||
| Signal | Source |
|
||||
|--------|--------|
|
||||
| quality_plateau | `avg_quality_delta < 0.02` vs prior window |
|
||||
| success_stable | `success_rate >= 0.85` |
|
||||
| optimizer_stall | 0 new actionable recommendations |
|
||||
| marginal_gain | 0 progress events / merged changes |
|
||||
|
||||
**Rotate when:** ≥3 of 4 signals true (saturation_score ≥ 0.75).
|
||||
|
||||
```bash
|
||||
# Per pilot repo (supplier CLI follow-on)
|
||||
kaizen-agentic metrics show coach --target /home/worsch/<repo>
|
||||
kaizen-agentic metrics show optimization --target /home/worsch/<repo>
|
||||
kaizen-agentic metrics optimize --target /home/worsch/<repo>
|
||||
```
|
||||
|
||||
## Manual rotation procedure
|
||||
|
||||
1. Run regulator session (`session-template.md`); confirm saturation recommendation
|
||||
2. Update `loops/kaizen-stack/roster.yaml`:
|
||||
- Move repo from `active` → `saturated`
|
||||
- Promote next slug from `expansion_queue`
|
||||
3. Patch saturated repo `.kaizen/schedule.yml`:
|
||||
```yaml
|
||||
agents:
|
||||
optimization:
|
||||
enabled: false
|
||||
```
|
||||
4. Record decision in state-hub (`record_decision` or progress event)
|
||||
5. Append rotation event to `loops/kaizen-stack/health.jsonl`
|
||||
|
||||
## Bootstrap status (2026-06-18)
|
||||
|
||||
No rotation executed — pilots still accumulating metrics (<14 cycles).
|
||||
**Next review:** after 14 daily kaizen-stack cycles or explicit operator request.
|
||||
|
||||
## Automation path
|
||||
|
||||
After 2 successful manual rotations:
|
||||
|
||||
- Enable `saturation_score` in health collector definition
|
||||
- Supplier ships `metrics rotation-signals` (KAIZEN-WP-0008 extension)
|
||||
- Regulator may auto-recommend; human still commits roster changes
|
||||
Reference in New Issue
Block a user