Files
kaizen-agentic/docs/integrations/activity-definitions/weekly-coach-orientation.md
tegwick 3b2edd4a9e feat: scheduled agent execution via activity-core (WP-0006, v1.3.0)
Enable kaizen agents to run on a regular cadence against a preselected repo
roster, orchestrated by activity-core and prepared by kaizen-agentic — without
this repo owning cron, Temporal workers, or an LLM runtime.

CLI + module:
- src/kaizen_agentic/schedule.py — .kaizen/schedule.yml parse/validate/scaffold
- `kaizen-agentic schedule` group: init, validate, list, prepare <agent>
  (prepare bundles agent prompt + memory + metrics + repo pointers, offline)
- tests/test_schedule_cli.py — 15 tests

Contract & design:
- ADR-005 scheduled agent execution; schema doc + example manifest
- discover_kaizen_scheduled_repos resolver spec, state-hub roster fields,
  kaizen.schedule.prepared event payload, activity-core handoff checklist
- INTEGRATION_PATTERNS Pattern 2 extended with roster model

ActivityDefinition drafts (enabled: false):
- weekly-coach-orientation, weekly-optimization-review

Docs: agency-framework, CLI cheat sheet, PACKAGE_RELEASE runner prereqs,
EcosystemIntegration, CHANGELOG, TODO. Workplan closed (status: done).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-17 08:19:51 +02:00

1.8 KiB

id, name, enabled, owner, governance, status, trigger, context_sources
id name enabled owner governance status trigger context_sources
kaizen-weekly-coach-orientation Weekly Kaizen Coach Orientation false kaizen-agentic custodian proposed
type cron_expression timezone misfire_policy
cron 0 9 * * 1 Europe/Berlin skip
type query params bind_to
resolver discover_kaizen_scheduled_repos
domain cadence
custodian weekly
context.scheduled_runs

Weekly Kaizen Coach Orientation

Every Monday 09:00 Berlin time, opens a coach orientation task for each schedule-eligible repo whose .kaizen/schedule.yml enables the coach agent.

The resolver discover_kaizen_scheduled_repos (see discover-kaizen-scheduled-repos.md) returns one scheduled_run per (repo, agent); this definition selects the coach runs.

id: run-weekly-coach
for_each: context.scheduled_runs
bind_as: r
condition: 'r.agent == "coach" and r.enabled == true'
action:
  task_template: "Weekly coach orientation: {{r.repo}}"
  description: |
    {{r.prepare_command}}
    Then load agents/agent-coach.md in a coding-agent session, paste the
    prepared bundle, and follow the coach synthesis. At session close:
    kaizen-agentic metrics record coach --success --time <s> --quality <0-1>
  target_repo: "{{r.repo}}"
  priority: medium
  labels: ["kaizen", "agent-run", "coach", "scheduled", "automated"]

CLI mapping: kaizen-agentic schedule prepare coach (offline-safe; reads local .kaizen/ state).

Activation: sync into activity-core via make sync-activity-definitions after the discover_kaizen_scheduled_repos resolver is enabled. Keep enabled: false until a manual smoke test passes on a pilot repo. See INTEGRATION_PATTERNS.md Pattern 2.