Reports

Reports package metrics and commentary on a schedule. They are ideal for weekly status updates or sprint reviews.

Report Definition

Store files under .kiket/analytics/reports/*.yaml:

title: Weekly Delivery Report
schedule: cron(0 9 ? * MON *)
recipients:
  - leads@example.com
  - product@example.com
sections:
  - heading: Delivery Summary
    metric: throughput
    params:
      project: $project
  - heading: Cycle Time Trend
    metric: cycle_time
    chart: line
  - heading: Blockers
    metric: blockers
    commentary:
      template: blockers.md

Scheduling

• schedule uses Cloud Scheduler cron syntax.
• Reports run in the organization timezone by default; override with timezone.
• You can trigger reports manually from the UI.

Distribution

• Email is the default channel; Slack and webhooks are available via integrations.
• Attach CSV exports with attachments: csv.
• Recipients require access to the underlying project.

Commentary Templates

• Reference Markdown templates stored in .kiket/analytics/templates/.
• Templates can use Liquid placeholders for metrics ({{ metrics.throughput.total }}).

Monitoring

• Delivery logs record success/failure per recipient.
• Use the CLI (kiket analytics report run <report>) to test new definitions.

Automated reports keep stakeholders informed without manual spreadsheet work.