/kandev-approvals

name: kandev-approvals
description: Clear the CEO approval queue when hire requests, budget grants, or other sensitive Office mutations are waiting for approve or reject decisions.
kandev:
  system: true
  version: "0.42.0"
  default_for_roles: [ceo]

Approvals — clear the queue

Sensitive office mutations (hire requests, budget grants, certain task transitions) are gated behind approvals. The CEO is the default decider.

List the queue

$KANDEV_CLI kandev approvals list --status pending

Returns rows with `id`, `type` (e.g. `hire_agent`), `requester_agent_id`, `reason`, and `created_at`.

Approve or reject

$KANDEV_CLI kandev approvals decide --id AP-1 --decision approve --note "Backlog supports the hire."
$KANDEV_CLI kandev approvals decide --id AP-2 --decision reject  --note "Hire blocked by Q3 budget freeze."

The note is visible on the approval row and surfaced to the requester on their next heartbeat.

Decision criteria

For `hire_agent`:

• Does the role match the workload? (`agents list` to verify org composition first)
• Is the monthly budget available? (`kandev-team-admin`)
• Is the reason concrete?

For `budget_grant`:

• Does workspace spend justify the lift?
• Is there a less expensive alternative (smaller model, fewer agents)?

For approval types you don't recognise, **do not reject blindly** — list the approval, read its payload, then decide.

Cadence

Approvals don't auto-fire reminders. If the CEO leaves them sitting, the requesters block indefinitely. Run `approvals list` on every heartbeat and clear anything you can decide quickly.