Feature specs

September 1, 2026 ยท View on GitHub

Specs for user-visible features that span several modules. A feature owned by a single subsystem belongs in ../modules/ instead.

SpecCovers
aws-control.mdThe AWS account portal and S3-backed cloud drive app: accounts, Drive/Library/Backup, consent and confirmation guards, sharing.
dashboard-token-auth.mdSigned, IP-pinned dashboard tokens, session TTLs, and token refresh.
session-work-ledger.mdPer-session durable work state (goal, phase, tried, artifacts) on disk, its MCP tools, and monitor-loop snapshot injection.
babysit-pr-watch.mdZero-token PR polling for babysit loops: a script cron that wakes the owning session only on unexpected state.
agent-interrupt-controller.mdkiro_crew.irq: masking, coalescing, epoch resets and an error backstop for script-cron pollers, so a cheap probe interrupts an expensive agent turn instead of the turn polling. Also the app-facing probe SDK.
app-sdk-durable-jobs-and-view-state.mdProposed, not implemented. Two App SDK surfaces: a gateway-side durable run record so a long action's state survives unmount and restart, and URL-backed view state so an app can express where the user is. Reference consumers and migration path.
mcp-probe-quarantine.mdA durable consecutive-probe-failure count per MCP server, surfaced on its dashboard row with a reset control. The unmount half is deferred; the spec records why.
prompt-optimizer.mdRewriting a draft prompt on demand, and the paste-forwarding surface.
inline-action-buttons.mdAgent-proposed buttons rendered inline in chat.
workflow-chat-cards.mdRendering a workflow run's progress as a chat card.
steering-viewer.mdViewing the steering files a session loaded.
stt-streaming.mdLive dictation in the composer: the three providers, the WebSocket frames, the local recognizer's endpointing and partial pipeline, and the model download.
voice-streaming.mdStreaming voice replies, and the text normalization applied before synthesis.
turn-complete-chime.mdThe end-of-turn audio cue.
turn-stats-footer.mdThe per-turn token and timing footer.
model-fallback.mdThe throttle-exhaustion model fallback (agent.fallback_model): trigger, shared walk, sticky restore, visibility.
code-approvers.mdTier routing for code review approvers.
claude-code-provider.mdClaude Code as a selectable ACP harness: the live spawn path, the two binaries it needs on the machine, and the MCP gap a Claude session still carries.
agent-host-contract.mdWhat an agent backend must supply besides speaking ACP: agent layout, session store, identity, sandbox, MCP delivery, billing, permission engine, auxiliary runtimes โ€” kiro-cli, KAS and Claude Code side by side, with the new-provider checklist.