kandev/docs/specs/platform/README.md

---
status: draft
system: platform
specification_version: 1
migration: in_progress
owners:
  - kandev
---

# Platform system

## Purpose

The platform system owns cross-cutting runtime services, configuration,
observability, notifications, localization, lifecycle safety, and shared
operational guarantees.

Repository validation performance, including local commit checks and shared CI
execution, belongs here. The CI system retains hosted workflow trust policy.

Shared read-capacity protection and aggregate reporting availability belong here.
Domain systems retain ownership of source records and workspace context identity.

## Ownership

This system owns startup and shutdown contracts, process and port-independent
runtime safety, configuration precedence, diagnostics, notifications,
localization, feature toggles, health, and shared session recovery services.

Settings discovery and interface parity belong to Platform. Each settings domain
retains ownership of its values, validation, authority, and persistence.

## Exclusions

- Executor-specific runtime environments belong to the [executor
  system](../executors/README.md).
- Agent identity belongs to the [agent system](../agents/README.md).
- Desktop shell behavior belongs to the [desktop system](../desktop/README.md).

## Specification map

### Requirements

- [CI performance](requirements/ci-performance.md)

- [Startup lifecycle](requirements/startup-lifecycle.md)
- [Startup progress visibility](requirements/startup-progress-visibility.md)

- [Agent-accessible Kandev settings](requirements/agent-settings-parity.md)



- [Agent process exit and stderr drain](requirements/agent-process-exit-drain.md)
- [Agentctl instance stop idempotency](requirements/agentctl-instance-stop.md)
- [Agent Runtime Availability](requirements/agent-runtime-availability.md)
- [Background Work Liveness](requirements/background-work-liveness.md)
- [Backend restart page recovery](requirements/backend-restart-page-recovery.md)
- [Bounded Task Status Delivery](requirements/bounded-task-status-delivery.md)
- [Viewport-bounded Session Delivery](requirements/viewport-bounded-session-delivery.md)
- [Shared Cron Loop Safety When Office Is Disabled](requirements/cron-office-disabled-safety.md)
- [Environment-specific browser tab title prefixes](requirements/dev-preview-title-prefixes.md)
- [Browser console retention](requirements/browser-console-retention.md)
- [Diagnostic logging](requirements/diagnostic-logging.md)
- [Duration-aware E2E sharding and CI reliability](requirements/e2e-duration-aware-sharding.md)
- [External CI runner capacity](requirements/external-e2e-runner-capacity.md)
- [Expected runtime log severity](requirements/expected-runtime-log-severity.md)
- [Feature Toggles](requirements/feature-toggles.md)
- [Git Credential Lease Reissue](requirements/git-credential-lease-reissue.md)
- [Git Subprocess Admission](requirements/git-subprocess-admission.md)
- [Go dev launcher and minimal Node surface](requirements/go-dev-launcher.md)
- [Health Endpoint — Surface the Running Version](requirements/health-endpoint-version.md)
- [Watcher And Task Fallback Localization](requirements/i18n-audit-watcher-copy.md)
- [Additional I18n Audit Gaps](requirements/i18n-second-audit-gaps.md)
- [Internationalization (i18n)](requirements/i18n.md)
- [LSP File Intelligence](requirements/lsp-file-intelligence.md)
- [Session MCP Attachment Observability](requirements/mcp-session-observability.md)
- [Mid-Turn Steering](requirements/mid-turn-steering.md)
- [Semantic Notifications](requirements/notifications.md)
- [Apprise rescan](requirements/apprise-rescan.md)
- [Required Persisted Store Parity](requirements/postgres-domain-store-parity.md)
- [Provider Error Recovery](requirements/provider-error-recovery.md)
- [Session Config Reconciliation Across Agent Types](requirements/session-config-cross-agent-reconcile.md)
- [Session subscription recovery](requirements/session-subscription-recovery.md)
- [Setup and Launch Timeout](requirements/setup-launch-timeout.md)
- [Quiet benign teardown log noise on shutdown](requirements/shutdown-log-noise.md)
- [Do not surface backend-shutdown turn aborts as agent failures](requirements/shutdown-turn-failure-suppression.md)
- [Background subsystem context-cancellation log severity](requirements/shutdown-background-canceled-logs.md)
- [Startup Configuration Parity](requirements/startup-configuration-parity.md)
- [Prevent Host Sleep During Active Tasks](requirements/task-sleep-inhibition.md)
- [Traditional Chinese locales (Taiwan and Hong Kong)](requirements/traditional-chinese-locales.md)
- [Workspace Git Status](requirements/workspace-git-status.md)

### System design

- [CI performance](system-design/ci-performance.md)

- [Startup lifecycle](system-design/startup-lifecycle.md)
- [Startup progress visibility](system-design/startup-progress-visibility.md)

- [Agent-accessible Kandev settings](system-design/agent-settings-parity.md)
- [Core settings domain adoption](system-design/agent-settings-domains.md)



- [Agent process exit and stderr drain](system-design/agent-process-exit-drain.md)
- [Agentctl instance stop idempotency](system-design/agentctl-instance-stop.md)
- [Apprise rescan](system-design/apprise-rescan.md)
- [Background Work Liveness](system-design/background-work-liveness.md)
- [Backend restart page recovery](system-design/backend-restart-page-recovery.md)
- [Browser console retention](system-design/browser-console-retention.md)
- [Bounded Task Status Delivery](system-design/bounded-task-status-delivery.md)
- [Viewport-bounded Session Delivery](system-design/viewport-bounded-session-delivery.md)
- [Diagnostic logging System Design Part 1](system-design/diagnostic-logging-01.md)
- [Diagnostic logging System Design Part 2](system-design/diagnostic-logging-02.md)
- [Expected runtime log severity](system-design/expected-runtime-log-severity.md)
- [Duration-aware E2E sharding and CI reliability](system-design/e2e-duration-aware-sharding.md)
- [External CI runner capacity](system-design/external-e2e-runner-capacity.md)
- [Health Endpoint — Surface the Running Version](system-design/health-endpoint-version.md)
- [Internationalization (i18n)](system-design/i18n.md)
- [LSP File Intelligence System Design Part 1](system-design/lsp-file-intelligence-01.md)
- [LSP File Intelligence System Design Part 2](system-design/lsp-file-intelligence-02.md)
- [Session MCP Attachment Observability](system-design/mcp-session-observability.md)
- [Required Persisted Store Parity](system-design/postgres-domain-store-parity.md)
- [Provider Error Recovery](system-design/provider-error-recovery.md)
- [Provider Response-Attempt Recovery](system-design/provider-response-attempt-recovery.md)
- [Workspace Git Status](system-design/workspace-git-status.md)
- [Go dev launcher and startup version](system-design/go-dev-launcher.md)
- [Startup database selection continuity](system-design/startup-database-selection-continuity.md)
- [Background subsystem context-cancellation log severity](system-design/shutdown-background-canceled-logs.md)

## Migration record

Migration remains in progress while legacy source detail is extracted from the
canonical requirement and system-design documents. Use the catalog command to
find current sources.

## Related systems

- [Agents](../agents/README.md): consumes shared runtime services.
- [Executors](../executors/README.md): owns execution-environment details.
- [Desktop](../desktop/README.md): embeds platform startup and shutdown.
- [Workspaces](../workspaces/README.md): owns cached context identity and read recovery.