Skip to content

Team Calendar & Capacity Sync

Keep your organization’s schedule aligned with PTO, focus blocks, and training by connecting external calendars directly into Kiket.

Configure Event Types via YAML

Team calendar event types, labels, and approval rules are pulled from your project definition. Add a .kiket/team_calendar.yaml file alongside the rest of your configuration (or the equivalent entry in your definition repository):

model_version: "1.0"
event_types:
  - id: pto
    label: Paid Time Off
    requires_approval: true
  - id: holiday
    label: Company Holiday
    requires_approval: false
  - id: focus
    label: Focus Block
    requires_approval: false

When the configuration loader runs it stores the definition on the project and organization. The Team Calendar UI automatically hides the approval toggle and enforces the rule per event type: requests marked requires_approval: true stay Pending until a manager approves them, while the rest schedule immediately.

Subscribe to the Team Calendar

  • Every user receives a private ICS link (visible in Team Calendar → Subscribe in your calendar).
  • Paste the link into Google Calendar, Outlook, or Apple Calendar to see approved events.
  • Regenerate the link at any time; previous URLs are revoked immediately.

Import External Calendars

  1. In Team Calendar → Calendar Integrations, paste the ICS feed URL from your HRIS or shared calendar.
  2. Choose an auto-refresh interval (hourly, 3-hour, 6-hour, 12-hour, or daily).
  3. Kiket fetches the feed on schedule, imports PTO/focus events, and flags each sync in the Integrations list. You can trigger a manual sync or delete the feed at any time.
  4. Imported events are marked as approved, listed with their source, and can be audited from the event timeline.

What’s Supported Today

  • Public ICS feeds that include UID, DTSTART, and DTEND values.
  • Category detection for PTO, holidays, focus blocks, travel, and training.
  • Automatic cancellation handling—when an event disappears from the source feed, Kiket cancels it and restores capacity.

Coming Soon

  • Authenticated feeds (OAuth/shared secrets) and per-feed time zone overrides.
  • Alerting when a feed remains in an error state for more than 12 hours.

Capacity & Burn-Rate Analytics

  • Approved calendar events immediately adjust capacity snapshots and developer availability.
  • The Capacity Impact card on the Usage Dashboard shows:
  • Hours reduced this week + next week vs. the forecast window.
  • Burn-rate alerts when calendar impact exceeds 80% of the forecast.
  • Breakdown by event type (PTO, holiday, focus, training) and the next few upcoming events.
  • Risk alerts notify managers/admins when burn rate stays above the threshold.
  • Automation recipes can now query calendar conflicts to pause risky transitions or escalate when assignees are out.

Tips

  • Keep PTO calendars dedicated per team; set the sync interval to match your HR cadence (daily or 6-hour refresh is common).
  • Use the integrations list to monitor last/next sync timestamps and quickly re-run a feed after updates.
  • Regenerate subscription URLs for users who leave the organization or if a link is accidentally shared.