Files
kaizen-agentic/docs/integrations/activity-definitions/weekly-optimization-review.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-optimization-review Weekly Kaizen Optimization Review false kaizen-agentic custodian proposed
type cron_expression timezone misfire_policy
cron 0 10 * * 1 Europe/Berlin skip
type query params bind_to
resolver discover_kaizen_scheduled_repos
domain cadence
custodian weekly
context.scheduled_runs

Weekly Kaizen Optimization Review

Every Monday 10:00 Berlin time, opens an optimization-agent review task for each schedule-eligible repo whose .kaizen/schedule.yml enables the optimization agent. Chains the agent orientation with the existing metrics optimizer so the review is evidence-backed.

id: run-weekly-optimization
for_each: context.scheduled_runs
bind_as: r
condition: 'r.agent == "optimization" and r.enabled == true'
action:
  task_template: "Weekly optimization review: {{r.repo}}"
  description: |
    {{r.prepare_command}}
    kaizen-agentic metrics optimize          # refresh evidence
    Then load agents/agent-optimization.md, paste the prepared bundle plus the
    optimizer report, and act on recommendations. At session close:
    kaizen-agentic metrics record optimization --success --time <s> --quality <0-1>
  target_repo: "{{r.repo}}"
  priority: medium
  labels: ["kaizen", "agent-run", "optimization", "scheduled", "automated"]

CLI mapping: kaizen-agentic schedule prepare optimization then kaizen-agentic metrics optimize.

Complementarity: this generalizes the metrics-only weekly-metrics-optimize definition into a full agent run. Repos may run either; running both duplicates the optimizer step.

Activation: sync into activity-core via make sync-activity-definitions after the resolver is enabled; hold at enabled: false until smoke-tested.