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.
2.1 KiB
DEC-003 — ActivityDefinition Copy vs Reference
Status: accepted Date: 2026-06-18 Owner: Bernd Blocks: LOOP-WP-0001 T04, activity-core sync workflow
Question
How should coulomb-loop ActivityDefinitions relate to kaizen-agentic supplier templates?
Context
ADR-002 assigns ActivityDefinition copies to the customer repo. activity-core syncs from its own catalog path (ACT-ADR-002). Two sync models are possible.
Options
A — Customer-owned copies (recommended)
Copy supplier templates into coulomb-loop/activity-definitions/. activity-core
syncs from coulomb-loop path (or vendored subtree). Customer edits cron, labels,
roster params without supplier release.
| Pros | Cons |
|---|---|
| Coulomb controls cadence ramp (hourly bootstrap) | Drift from supplier templates |
| Matches ADR-002 | Manual merge when supplier updates templates |
B — Supplier catalog only
Reference supplier repo path; activity-core syncs kaizen-agentic/docs/integrations/activity-definitions/.
| Pros | Cons |
|---|---|
| Single source of truth | Hourly bootstrap crons don't match supplier weekly defaults |
| Less copy maintenance | Customer cannot tune without supplier PR |
C — Hybrid manifest
coulomb-loop/activity-definitions/manifest.yaml lists supplier source + local overrides (cron, enabled, labels). activity-core merge tool applies patches.
| Pros | Cons |
|---|---|
| Drift-aware automation | Requires new activity-core or coulomb-loop tooling |
| Best long-term for multiple customers | Not available today |
Recommendation
Option A for bootstrap (minimal tooling). Track Option C in KAIZEN-WP-0008 as supplier playbook enhancement for second customer.
Decision record
| Field | Value |
|---|---|
| Chosen option | A — customer-owned copies |
| Decided by | Bernd Worsch |
| Decided at | 2026-06-18 |
| Notes | Option C hybrid manifest tracked in KAIZEN-WP-0008 T08 |
On approval
Proceed with LOOP-WP-0001 T04 copy step; document merge procedure in loops/kaizen-stack/supplier-notes.md.