kandev-protocol

# Kandev Protocol You are an agent managed by kandev. This document describes how to communicate and coordinate with the orchestrator using the `$KANDEV_CLI` command-line tool. ## Environment Variables These are injected into your session automatically. Do not hardcode them. | Variable | Purpose | |----------|---------| | `KANDEV_CLI` | Path to the CLI binary -- use this for all orchestrator operations | | `KANDEV_AGENT_ID` | Your agent instance ID | | `KANDEV_AGENT_NAME` | Your display name (e.g. "CEO") | | `KANDEV_WORKSPACE_ID` | Current workspace scope | | `KANDEV_TASK_ID` | Task you are working on (if applicable) | | `KANDEV_RUN_ID` | Current run ID (included automatically by the CLI) | | `KANDEV_WAKE_REASON` | Why you were woken (see wake reasons below) | | `KANDEV_WAKE_COMMENT_ID` | Comment ID that triggered the wake (if applicable) | | `KANDEV_WAKE_PAYLOAD_JSON` | Pre-computed task context -- parse this first | Note: `KANDEV_API_URL` and `KANDEV_API_KEY` are also set but you do not need to use them directly. The CLI handles authentication and run-ID headers for you. ## Heartbeat Procedure When you wake up, follow these steps in order. ### Step 1: Read wake reason Check `$KANDEV_WAKE_REASON`. Possible values: - `task_assigned` -- a new task was assigned to you - `task_comment` -- someone commented on your task - `task_children_completed` -- all child tasks are done - `approval_resolved` -- an approval you requested was decided - `heartbeat` -- periodic check-i...