Files

ci / test (push) Has been cancelled

Details

feat: complete KAIZEN-WP-0008 customer engagement supplier deliverables

Add repo layout doc, ADR-006 convention, playbook v1 with supplier-notes,
override manifest design, and wiki integration. Mark workplan done (10/10).

2026-06-18 11:02:09 +02:00

2.3 KiB

Raw Blame History

ActivityDefinition Override Manifest (design)

Status: design-only (DEC-003 option C future) Implements: KAIZEN-WP-0008 T08 Runtime: none in v1 — customer-owned copies (option A) during bootstrap

Problem

Customer repos copy supplier ActivityDefinitions and tune cron, labels, and enabled flags. When supplier templates change, manual merge is error-prone. A manifest declares source + overrides without duplicating full definition bodies.

Proposed file

activity-definitions/manifest.yaml in the customer repo:

version: "1"
supplier_repo: kaizen-agentic
supplier_path: docs/integrations/activity-definitions
engagement: coulomb-loop

definitions:
  - supplier_id: kaizen-weekly-coach-orientation
    customer_id: coulomb-hourly-coach-orientation
    source: ../../kaizen-agentic/docs/integrations/activity-definitions/weekly-coach-orientation.md
    overrides:
      id: coulomb-hourly-coach-orientation
      name: Hourly Kaizen Coach Orientation (coulomb-loop bootstrap)
      owner: coulomb-loop
      governance: coulomb_social
      enabled: true
      trigger:
        cron_expression: "15 * * * *"
      context_sources:
        - params:
            roster: /home/worsch/coulomb-loop/loops/kaizen-stack/roster.yaml
            cadence: daily

  - supplier_id: kaizen-low-success-rate-review
    customer_id: coulomb-low-success-rate-review
    overrides:
      enabled: false
      owner: coulomb-loop

Merge rules (future tooling)

Parse supplier definition markdown (frontmatter + body)
Deep-merge overrides (customer wins on conflict)
Write customer copy to activity-definitions/<customer_id>.md
sync_activity_definitions reads customer copies only (unchanged today)

Ownership

Layer	Owner
Manifest schema	kaizen-agentic (supplier ADR/extension)
Manifest instance	customer repo
Merge CLI	TBD — `coulomb-loop` or `activity-core`
Sync runtime	activity-core (unchanged)

Bootstrap path (today)

Use option A: hand-copy definitions, edit cron/labels, track drift in loops/kaizen-stack/supplier-notes.md. Revisit manifest when a second customer engagement starts.

coulomb-loop docs/decisions/DEC-003-activity-definition-ownership.md
customer-engagement-playbook.md

2.3 KiB Raw Blame History