José Almeida
13 KiB
Feature Specs
Specs for kandev product features, grouped by umbrella. Each spec describes a user-invocable capability and is the source of truth for "is this feature done?"
The bar: an agent given only a spec (no source code) should be able to either reimplement the feature or test the existing system for conformance. See .agents/skills/spec/SKILL.md for the workflow and template.
Status: draft (being written) · approved (accepted design, ready to build) · building (in active development) · shipped (implemented, spec matches code) · archived (deprecated).
needs-upgrade in a spec's frontmatter flags template sections that the original sources did not cover and should be filled in from code (Data model, API surface, State machine, Permissions, Failure modes, Persistence guarantees). All office specs have been brought to the implementability bar; this flag is only used for newly-drafted specs that need a code-driven fill-in pass.
office/ — autonomous agent management
The office umbrella covers kandev's autonomous-agent product surface: workspaces of long-running agents that pick up tasks, coordinate via handoffs, and report through a dashboard.
| Spec | Status |
|---|---|
| overview | draft |
| agents | draft |
| tasks | draft |
| scheduler | draft |
| runtime | draft |
| routing | draft |
| costs | in-progress |
| dashboard | draft |
| live-updates | draft |
| inbox | draft |
| assistant | draft |
| automation-runs | draft |
| automations-settings | draft |
| testing | shipped |
| unread-divider | shipped |
platform/ — cross-cutting capabilities
Product-wide capabilities that are not tied to a single feature area.
| Spec | Status |
|---|---|
| background-work-liveness | shipped |
| task-sleep-inhibition | building |
| i18n | building |
| mid-turn-steering | shipped |
| plugins | draft |
| plugins — authoring experience | draft |
| plugins — marketplace | building |
| semantic-notifications | shipped |
| workspace-git-status | shipped |
| git-subprocess-admission | building |
| bounded-task-status-delivery | approved |
| diagnostic-logging | approved |
tasks/ — task & workflow model
Kandev's task model: documents, execution stages, labels, blocker escalation, subtask checklists, subtree controls, and the unification with the workflow engine.
| Spec | Status |
|---|---|
| documents | shipped |
| execution-stages | shipped |
| labels | shipped |
| title-length-limit | complete |
| model-unification | draft |
| run-scheduling | building |
| without-repositories | draft |
| attach-workspace-sources | building |
| remote-contribution-tasks | approved |
| subtask-checklist | shipped |
| subtask-detachment | shipped |
| subtask-completion-trigger | draft |
| subtree-controls | shipped |
| blocked-task-escalation | draft |
| runtime-cleanup | draft |
| archive-confirmation | shipped |
| link-existing-task-github-issue | building |
| wip-limit-pull-system | draft |
| multi-branch | shipped |
| quick-chat-sessions | shipped |
| quick-chat-repository-context | shipped |
| parent-child-message-interrupt | shipped |
| parent-child-task-stop | shipped |
| mcp-task-agent-profile-default | shipped |
| runtime-state-publication-order | shipped |
| agent-generated-titles | approved |
| task-create-executor-default | approved |
| prompt-attachments | draft |
| sidebar-task-edit | approved |
| explicit-completion-signal | shipped |
| cancelled-turn-completion | building |
| conditional-session-settings | approved |
agents/ — agent governance
Roles, governance gates, and granular permissions that apply across human users and office agents.
| Spec | Status |
|---|---|
| runtime-updates | approved |
| profile-disable | draft |
| roles | shipped |
| governance | shipped |
| granular-permissions | draft |
integrations/ — external service integrations
Per-workspace credentials and triage triggers for external services.
| Spec | Status |
|---|---|
| azure-devops-integration | shipped |
| slack | shipped |
| external-mcp | draft |
| mcp-tool-argument-validation | shipped |
| provider-aware-review-automation | approved |
| github-authentication | draft |
| gitlab-integration | shipped |
| jira-status-filter | shipped |
workspaces/ — workspace lifecycle
| Spec | Status |
|---|---|
| creation | building |
| deletion | shipped |
| local-repositories | shipped |
| repository-secrets | shipped |
costs/ — cost tracking & budgets
Subscription quota tracking and per-agent cheap-model profile routing.
| Spec | Status |
|---|---|
| subscription-usage | draft |
| cheap-model-profiles | shipped |
ui/ — cross-cutting UI features
system-page/ — operational diagnostics & maintenance UI
System pages (Radarr/Sonarr-style) for status, disk usage, database maintenance, backups, logs, updates, OSS licenses, and about.
| Spec | Status |
|---|---|
| system-page | draft |
| storage-maintenance | building |
| feature-toggles | draft |
Standalone
| Spec | Status |
|---|---|
| session-subscription-recovery | draft |
| npm-nightly-channel | shipped |
| agent-resume-runtime-recovery | shipped |
| agent-stall-recovery | approved |
| mcp-session-observability | approved |
| auth | building |
| create-local-repository | shipped |
| workflow-cycle-guardrails | building |
| improve-kandev | building |
| homebrew-core | draft |
| native-kandev-cli | draft |
| desktop-tauri-app | shipped |
| lsp-file-intelligence | building |
| public-share-links | draft |
| ssh-executor | draft |
| cli-mode-parity | draft |
| claude-fork-review-allowlist | building |
| workflow-settings-autosave | archived; superseded by settings-manual-save |
| mobile-quick-chat-topbar | building |
| native-code-review | building |
| missing-task-route-recovery | draft |
Conventions
- Spec layout. Umbrella specs live as flat
.mdfiles under the umbrella directory (docs/specs/office/agents.md). Standalone specs use a folder (docs/specs/improve-kandev/spec.md). - Plans are not specs. Implementation plans are committed under
docs/plans/<feature>/with individual sibling task files namedtask-<NN>-<short-slug>.md. Specs are the durable requirements; plans and task files are implementation records for the current buildout. - Bug fixes are not specs. Bugs produce a regression test plus an ADR if they encoded a new convention. See
/fixskill. - Architecture decisions are not specs. ADRs live under
docs/decisions/. See/record decision.
Cross-references
- ADRs:
../decisions/INDEX.md - Spec workflow:
.agents/skills/spec/SKILL.md - Bug-fix workflow:
.agents/skills/fix/SKILL.md