AI-readable Index

Fast file and document index for AI agents. **Do not duplicate** AGENTS.md rules or full essays from [core-architecture-thinking.md](../platform/architecture/ov

Purpose

Fast file and document index for AI agents. Do not duplicate AGENTS.md rules or full essays from core-architecture-thinking.md. Use context-pack.md for read order.

Start Here

Priority	Document	Use when
1	`AGENTS.md`	Strong rules, checks, package boundaries
2	`docs/start-here/context-pack.md`	Task-specific doc routing
3	`docs/platform/architecture/overview/core-architecture-thinking.md`	Build, state, tokens, UI layers, anti-patterns
4	`docs/start-here/project-brief.md`	Product summary
5	`docs/platform/architecture/repo/monorepo-workspace-guide.md`	Which app/package to open, dev commands

AI Execution Modes

Direct Implementation Mode is the default. Large task size alone is not enough to trigger Slicing Mode.

Read these only when Opt-in Slicing Mode, RFC Mode, ADR Mode, phase planning, or proceed-gated work is explicitly requested:

docs/development/ai/protocols/ai-execution-protocol.md
docs/development/ai/protocols/cost-gate.md
docs/development/ai/protocols/task-splitting-protocol.md
docs/development/rfcs/README.md
docs/development/adr/README.md

Architecture Docs (by topic)

Topic	Document
Monorepo apps & packages	monorepo-workspace-guide.md, package-graph.md
Cloudflare deploy & Access	cloudflare-deploy-and-access.md, ../operations/deployment.md
Public website and SEO	public-website-layer.md, ../seo/ai-crawler-policy.md, cloudflare-deploy-and-access.md
Build / Rsbuild / React 18	build-and-rendering.md
Shell boot & login	../ai/os-startup-flow.md
App registry & routes	app-registry.md, app-contract-view.md
Control-plane apps	app-map.md, personal-data-graph.md, connectors.md, prompt-studio.md, activity-and-events.md
Runtime-first platform	desktop-runtime.md, runtime-first-platform.md, prox-studio-system.md, desktop-surface-engine.md, workspace-surface-runtime.md
Studio blueprints	studio-blueprint.md
App adapters and placements	app-adapter-model.md, app-registry.md, app-contract-view.md
Device Studio clients	../clients/device-studio/README.md, ../clients/device-studio/studio-view-json.md, client-and-os-roadmap.md
URL and owner resources	url-resource-model.md, url-and-surface-model.md, ../roadmap/app-namespace-and-domain-strategy.md
Datasets as resources	../data/datasets-as-first-class-resources.md, data-surface.md
Cmd+K and commands	command-palette.md, command-system.md, actions.md - spatial summoning, generate/open/connect/execute posture, and command provider boundaries.
I18n and AI translation	i18n-and-translation.md, glossary.md - English-first v0.1 and future localization/AI translation posture.
URL, Surface, Store listings	url-and-surface-model.md, ../platform/app-store-surfaces.md
Hub model	../platform/hub-app-model.md
Space/Desktop persistence	space-desktop-window-session.md, ../db/os-shell-backend-model.md
Windows & Spaces	window-manager.md
State boundaries	state-model.md
Data flow & API	data-flow.md, api-map.md, runtime-view.md
App package boundaries	os-apps.md, app-registry.md, package-boundaries.md, package-taxonomy.md
Generated graphs	arch-observability.md
Refactor / lint rules	refactor-guardrails.md
ADRs	decisions/
App URLs / domains (roadmap)	../roadmap/app-namespace-and-domain-strategy.md
MCP catalog & safety	../ai/mcp-catalog.md
Trust, safety, regional profiles	../trust-safety/overview.md, ../compliance/overview.md, region-and-feature-profiles.md

Roadmap (identity & routing)

Topic	Document
Creator-owned paths, `appId`, subdomains	../roadmap/app-namespace-and-domain-strategy.md
Hub, Surface, owner-scoped Store URLs	url-and-surface-model.md
Roadmap index	../roadmap/README.md
Platform incubation	../roadmap/platform-incubation-roadmap.md
Device Studio / PWA / native companion	../clients/device-studio/README.md, ../roadmap/mobile-ai-first-remote-os.md

Design Docs

Topic	Document
Design entry	../design/DESIGN.md
Design operating system	../design/design-operating-system.md
Visual baseline	../design/visual-regression-baseline.md
Deck-as-code	../design/deck-as-code.md
Tokens & Tailwind	../design/tokens.md
`os-ui` layering	../design/component-layering.md
Shell chrome	../design/os-shell-design-language.md
App interiors	../design/app-design-language.md
Agent design discipline	../design/ai-design-workflow.md

Key Source Paths

Area	Path
Shell entry	`apps/os-shell/src/index.tsx`
Public Shell homepage	`apps/os-shell/src/index.tsx`, `apps/os-shell/src/surfaces/landing/`, `apps/os-shell/public/robots.txt`, `apps/os-shell/public/llms.txt`, `apps/os-shell/public/llms-full.txt`
Registry	`apps/os-shell/src/apps/registry.ts`
Cmd+K apps	`apps/os-shell/src/shell/command/commandPaletteApps.ts`
Cmd+K UI	`packages/ui/os-ui/src/shell/CommandSurface.tsx`
Cmd+K spatial commands	`apps/os-shell/src/shell/state/commandModelItems.tsx`
Studio contract	`packages/contracts/studio-contract/src/index.ts`
Studio registry	`packages/runtime/studio-registry/src/index.ts`
Studio routes	`apps/os-shell/src/router.tsx`, `apps/os-shell/src/surfaces/studio/`, `apps/os-shell/src/surfaces/modes/`
Studio Engine host	`apps/os-shell/src/surfaces/DesktopSurfaceRoot.tsx`
New dialog	`apps/os-shell/src/shell/topbar/NewDialog.tsx`
Public site routes	`apps/os-shell/src/surfaces/pages/LandingSurface.tsx`, `apps/os-shell/src/surfaces/pages/OfficialPageSurface.tsx`
Dataset Hub	`apps/os-shell/src/surfaces/pages/DatasetHubSurface.tsx`
Settings Console	`apps/os-shell/src/surfaces/pages/SettingsConsoleSurface.tsx`
Introduction App	`packages/apps/system-apps/src/apps/core/introduction/`, `packages/onboarding/src/index.ts`
Extracted Studio Engines	`packages/studio-engines/cli/src/`, `packages/studio-engines/block/src/`, `packages/studio-engines/board/src/`, `packages/studio-engines/flow/src/`
Alma UI package	`packages/features/ai-ui/src/components/OsAlmaPanel.tsx`
OS Shell i18n	`apps/os-shell/src/i18n/`
Window + Spaces store	`apps/os-shell/src/window-manager/store.ts`
Shell controller	`apps/os-shell/src/shell/useDesktopShellController.ts`
OS apps	`packages/apps/system-apps/src/apps/`
App category packages	`packages/apps/user-apps/src/apps/`, `packages/apps/user-connector-apps/src/apps/`, `packages/apps/dev-apps/src/apps/`, `packages/apps/admin-apps/src/apps/`, `packages/apps/game-apps/src/apps/`, `packages/apps/founder-apps/src/apps/`, `packages/apps/community-apps/src/apps/`, `packages/apps/hub-apps/src/apps/`
App shared primitives	`packages/apps/app-shared/src/`
Hola welcome app	`packages/apps/system-apps/src/apps/growth/hola/`
App Map	`packages/apps/system-apps/src/apps/core/app-map/`
Personal Data Graph	`packages/apps/user-apps/src/apps/data-graph/`
Connector Wall	`packages/apps/user-connector-apps/src/apps/user-connectors/connector-wall/`
Prompt Studio	`packages/apps/user-apps/src/apps/prompt-studio/`
Activity	`packages/apps/user-apps/src/apps/activity/`
Managed link resolver	`apps/os-shell/src/shell/links/resolveManagedLink.ts`
Platform host map	`packages/runtime/app-registry/src/platformHosts.ts`
Global shortcuts	`apps/os-shell/src/shell/GlobalShortcuts.tsx`
Mission Control	`apps/os-shell/src/shell/spaces/MissionControlOverlay.tsx`
Tokens CSS	`packages/ui/design-tokens/css/prox.css`
UI package	`packages/ui/os-ui/src/index.ts`
App contract	`packages/contracts/app-contract/src/index.ts`
Actions primitives	`packages/ui/actions/src/index.ts`
Command primitives	`packages/ui/command/src/index.ts`
Forms primitives	`packages/ui/forms/src/index.ts`
Editor primitives	`packages/ui/editor/src/index.ts`
Collaboration primitives	`packages/features/collaboration/src/index.ts`
Notification primitives	`packages/ui/notifications/src/index.ts`
Search primitives	`packages/features/search/src/index.ts`
Files primitives	`packages/features/files/src/index.ts`
AI UI primitives	`packages/features/ai-ui/src/index.ts`
Security UI primitives	`packages/features/security-ui/src/index.ts`
Workspace UI primitives	`packages/features/workspace-ui/src/index.ts`
Activity primitives	`packages/ui/activity/src/index.ts`
Data contract	`packages/contracts/data-contract/src/index.ts`
Data table primitives	`packages/features/data-table/src/index.ts`
Data viz primitives	`packages/features/data-viz/src/index.ts`
Media primitives	`packages/features/media/src/index.ts`
Maps primitives	`packages/features/maps/src/index.ts`
API worker	`apps/api-worker/src/index.ts`
Docs sync	`scripts/sync-docs-content.mjs`, `pnpm docs:sync`
Join Us app	`packages/apps/founder-apps/src/apps/join-us/JoinUsApp.tsx`