用途：这是工作区 AGENTS.md 核心规则的长文细节，适用于多应用 Agent Native 工作区。在添加共享代码、存储文件或密钥、创建工作区资源、查找框架 API 前阅读。
框架文档查找：先读 agent-native-docs 的查找流程（framework-search，然后是聚焦的 docs-search / source-search，再有 rg 兜底）。未列出的工作区专属 slug 为 workspace 与 multi-app-workspace。功能开关等专用流程为可选，仅当应用使用其技能时才读。框架 API 用包文档，复用框架或模板模式用包语料，工作区专属约定用 AGENTS.md 与 .agents/skills/。构建通用工作区或 agent UI 前先读 agent-native-toolkit 盘点现有公共套件与已安装包的接缝；改造共享 UI 前读 customizing-agent-native。遵循 configure → compose → eject 最小单元 → 提议共享接缝的阶梯；--apply 前先预览，提交 agent-native.ejections.json，绝不修改 node_modules 或 eject 受保护的运行时契约。
共享约定：所有 AI/LLM 行为都经应用 agent chat，UI 与服务端代码不得直接调用模型提供商、AI SDK 的 generateText()/streamText() 或其他内联 LLM API，本地应用内 agent 工作用 sendToAgentChat()，含隐藏上下文与 submit: false 预填/审阅流程。动作保持确定且聚焦；若工作流属于研究、分析、生成、推荐或综合，应由 agent 在可见 AgentSidebar 中编排提供商与数据动作。仅在 UI 需与待提交上下文 chip 双向同步时使用 useAgentChatContext 等相应函数。构建 agent 驱动 UI 或“AI”功能前读 .agents/skills/delegate-to-agent/SKILL.md。
仅当多个应用需要时把共享代码放 packages/shared；应用专属屏幕、动作、状态与技能放 apps/<app>。SQL 用于结构化记录、元数据、引用与可搜索文本；大文件/blob 载荷放配置的文件/blob 存储，仅持久化 URL、id 或句柄。共享运行时配置放工作区根 .env，应用专属覆盖放 apps/<app>/.env；公开行为优先用 agent-native.config.ts 默认值，仅非机密值需部署覆盖时用 AGENT_NATIVE_CONFIG_<UPPER_SNAKE_PATH>。不得在源码、文档、提示、fixtures、应用状态、动作响应或生成内容中硬编码 API key、令牌、webhook URL、签名密钥、私有内部或客户数据。每个应用部署自己的 /* 页面函数。应用承担重运行时（无头浏览器、ffmpeg、媒体处理、ML）前读 performance 技能 §9，并把工作放后台函数或任务。工作区文件视图保留给用户创建或请求的资源；agent 可创建隐藏 agent_scratch 资源作临时笔记，仅在用户明确要求时提升为普通可见。运行时可编辑全局资源从 Dispatch Resources 管理。相关技能：adding-workspace-apps、agent-native-docs、agent-native-toolkit、customizing-agent-native、delegate-to-agent、performance、secrets、storing-data。具体收费、价格与平台支持资料未提供。