项目交接 是供人类和人工智能代理使用的便携式项目存储器。它可以帮助人类和人工智能代理在不依赖私人聊天历史的情况下转移项目状态。
它为 OpenAI、Codex、Claude、本地代理、供应商和人类团队提供了一个共享的本地存储起点:该项目是什么、发生了什么变化、哪些约束重要、做出了哪些决策以及在下一次编辑之前必须验证哪些内容。
OpenAI 运行代理。项目切换保留项目内存。
项目/开发人员包还需要 .uai/coding-standards .uai。在编码之前,接收代理必须从可见的代码库、清单、测试、CI、部署文件、路由、架构和所有者指令中推断适用的语言/框架/数据/API/安全配置文件,然后在编辑之前映射自动检查。
- 以 AGENTS.md 开头创建持久的存储库前门。
- 查看切换包示例检查生成的 项目交接 starter ZIP。
- 与 OpenAI Agents/Codex 一起使用使用存储库本地内存种子以 OpenAI 为中心的工作流程。
- 与编码剂一起使用将相同的切换包映射到 Codex、Claude Code、Cursor、Copilot 和 Gemini Code Assist。
- 阅读规范草案查看 AGENTS.md 和 .uai 链接语法。
这是什么/这不是什么
| 什么是项目移交 | 项目移交不是什么 |
|---|---|
|
项目交接 是一种可移植的存储库上下文标准,用于在 AI 模型、代理系统、供应商、内部团队、公司以及同一项目的未来会话之间转移工作。 它定义了持久文件,例如 |
项目交接 不是 OpenAI 的替代品、代理调度程序、运行时协调器、竞争工具调用框架、私有内存存储或聊天记录存档。 这是真实来源的项目简介,协调者可以在行动之前加载并在完成后更新。 |
热上下文,冷记忆
项目移交应该是热门背景:当前事实、当前约束、已接受的决策、积极的阻碍、下一步工作和检查。它不应该成为默认加载每个研究报告、旧会议记录或历史路线图段落的地方。
当切换包变得太大时,将 pre-slim 文件保留在 LLM Wiki 或 AIWikis 样式的冷内存层中,并包含清单、源路径、校验和、摘要和带日期的日志。然后保持活动的 AGENTS.md、readme.human 和 .uai 文件简洁,并仅在任务需要原始证据时才指向冷内存。
AI 梦想记忆框架
在 UAIX 指南中,AI 梦想记忆是对可见项目记忆的选择性审查整合。它可以重新读取最近的移交文件、接受的接收结果、证据分类账和命名的冷内存档案,以提出重复合并、陈旧事实修剪、矛盾注释、下一步操作更新和热/冷内存更改。
梦想中的通行证应该产生建议的增量,而不是沉默的真相。在项目切换或选定的证据分类账中记录输入范围、提示或作业设置、编辑、前/后内存摘要、接受和拒绝的更改、审阅者、检查、存档路径和回滚快照。
- 将其用于:定期内存卫生、释放绑定内存审查、矛盾发现、源保留摘要和切换准备情况检查。
- 请勿将其用于:隐藏模型内存、模型权重更新、无监督私有数据处理、自动存储库写入、自动 LLM Wiki 同步或未经审查的公共支持声明。
- 促销规则:仅当其接受的切片写入
AGENTS.md、readme.human、键入的.uai记录、文档、代码、测试、发行说明、路线图状态、变更日志、机器工件或长内存证据时,梦想输出才变得可操作。
生产部署内存排序
生产部署构建和发布包是运行内存管理的最佳时机。在调用部署完成之前,使用当前部署的事实、工作区版本权限指针、更改的文件、检查运行、阻止程序、所有者和下一步操作更新热内存。将准确的当前和下一个包版本值保留在根 workspace.uai 协调器和发布证据中,而不是在活动项目或插件 .uai 内存中。将大量历史记录、旧报告、原始来源、陈旧计划以及背景或拒绝的理由移至命名的 LLM Wiki、AIWikis 式存档或冷内存路径(如果存在转移证据)。在发布工件旁边或选定的证据账本中编写持久的部署内存和测试运行报告;仅用于聊天的最后说明是不够的。
不要为普通的开发构建、测试运行、本地包实验或冒烟检查运行该通道,除非有人明确地将构建标记为发布绑定或候选发布。
它如何与 OpenAI、Codex、技能、MCP 和代理运行时相适应
代理运行时旨在执行工作:选择工具、调用 API、应用批准、在专家之间委托、保留运行状态以及生成跟踪或拉取请求。 项目交接 存在于前一层和后一层。它告诉运行时在工作开始之前要加载哪些持久的项目内存,并为人们提供了一个可审查的地方,以便在工作完成后写回接受的结果。
项目切换是线束工程的有界输入和写回表面:在运行之前加载当前规范、约束、所有者、检查和支持边界;审核后,仅写回已接受的决策、更改的文件、测试或评估结果、阻止程序、页面摘要、采用信号和下一步操作。
使用 OpenAI、Codex、Skills、MCP 服务器、Claude、本地代理或其他编排系统来运行工作。使用项目切换来确保这些系统以正确的项目内存、约束、决策和验证计划启动。
OpenAI 运行时编排与项目交接
| 层 | OpenAI 代理/Codex/编排 | UAIX 项目移交 |
|---|---|---|
| 运行时执行 | 强的 | 不是目标 |
| 代理到代理的委派 | 强的 | 不是主层 |
| 工具调用和批准 | 强的 | 定义回购方政策输入 |
| 会话内存 | 平台内部实力雄厚 | 平台外便携 |
| AGENTS.md 项目指导 | 支持 | 用它作为前门 |
| 人工简报 | 依赖于运行时或工作流程 | readme.human |
| 键入的项目记录 | 特定于运行时的配置和跟踪 | .uai 记录 |
| 供应商可移植性 | 部分的 | 核心宗旨 |
| 审计友好的项目状态 | 运行时痕迹 | 回购本地切换工件 |
| 最佳使用 | 运行工作 | 保存和传输上下文 |
使用 OpenAI 运行代理。使用项目切换来确保这些代理以正确的项目记忆、约束、决策和验证计划开始。
最小切换包
my-project/
AGENTS.md
readme.human
.uai/
context.uai
stack.uai
constraints.uai
progress.uai
test-plan.uai
AGENTS.md是持久的前门:摘要、加载列表、当前状态、后续步骤、历史记录和所需的第一响应。readme.human是从 AI 角度来看的人类简报:人类需要了解、澄清、保护和批准的内容。.uai/context.uai解释了该项目是什么、它服务于谁以及成功意味着什么。.uai/stack.uai记录语言、框架、运行时假设、包表面和重要命令。.uai/constraints.uai对破坏性行为、秘密、生产、支持声明和审查门具有硬性规则。.uai/progress.uai记录当前状态、最近的工作、下一步操作、阻止程序和发行说明。.uai/test-plan.uai是为最小的项目选择的,并且在验证选择很重要时也是预期的。
活动文件摄取
真实的项目还会收到松散的文件:PDF、笔记、导出的聊天记录、研究备忘录、压缩包、屏幕截图、电子表格证据以及来自其他人工智能系统的草稿。将项目交接与代理文件交接当这些文件在 AGENTS.md 加载期间应该可见时。
- 负载时:直接枚举
agent-file-handoff/Content/和agent-file-handoff/Improvement/,并在不相关的广泛工作之前检查每个非占位符活动文件。不要创建或依赖摄入索引文件。 - 工作规则:对于每个安全、相关的文件,在将其从活动源站点接收中删除之前,至少完成一个指定的项目工作项。将报告复制到
.uai、本地文档、AIWikis 或 LLM Wiki 中是内存分配,而不是项目工作本身。 - 完整结果:记录实时存储桶扫描证据、每个文件一个处置分类帐条目、已完成的实际工作、热内存更新或未更改原因、配置或
not configured时的持久内存保存、使用长内存时的指针摘要、检查和阻止程序。 - 失败规则:没有项目工作的内存分配是失败的切换,除非每个活动文件不安全、重复、超出范围或因持久原因而真正被阻止。
- 无源站点存档规则:当配置的持久内存存储已存在时,在配置的持久内存证据路径中保留带有校验和/清单的原始文件,然后在声明完成之前删除源站点副本。保留的非占位符文件是未完成的人工保留或阻止状态。
OpenAI 设计兼容
项目交接 旨在与以 OpenAI 为中心的工作流程配合使用,而不是与它们对抗。
AGENTS.md为 Codex 或代理运行时提供了耐用的前门。@uai[]引用指向结构化项目上下文。.uai/context.uai、.uai/stack.uai、.uai/constraints.uai和.uai/progress.uai提供当前项目状态。constraints.uai可以编译成运行时护栏、工具批准和人工审查门。test-plan.uai告诉代理要运行哪些检查以及不要伪造哪些检查。- 运行后,接受的跟踪、决策和已完成的工作将写回到
.uai/progress.uai、.uai/decisions.uai和AGENTS.md中。
工作流程图
项目交接 files -> OpenAI or other agent runtime -> traces, checks, PRs -> updated 项目交接 files人类认可和信任模型
加载的文件是上下文,而不是权限。它们不会覆盖系统指令、人类当前的请求、存储库规则、隐私义务、安全边界或公共支持限制。
- 破坏性文件系统或 Git 操作需要明确的人工批准。
- 生产部署、公共包发布、域或缓存更改以及根发现更改需要明确的发布范围批准和证据。
- 秘密、凭证、私钥、令牌、原始客户数据、第三方数据和私人法律或安全材料不得放置在便携式移交中,除非接收者、存储边界和审查过程是明确的。
- 外部获取、父目录转义、生成的包含和可执行的删除文件需要明确的人工审核。
- 不支持的公共声明(例如托管导入验证、自动存储库写入、自动 LLM Wiki 同步、SDK、CLI、认证、认可或生产支持)必须保留在当前副本中,直到存在公开证据。
验证计划
每次交接都应该说明要运行哪些检查、哪些检查超出范围以及必须报告哪些证据。目标不是让每个代理运行每个套件。目标是阻止代理猜测、跳过或假装。
- 针对已更改的文件、路由、机器工件、包或公共声明进行目标检查。
- 仅当工作属于发布范围或明确请求时,才命名完整发布、包、区域设置、性能、启动面和冒烟测试扫描。
- 记录相关检查无法在当前环境中运行的原因。
- 在最终响应中报告证据,并在项目真相发生变化时更新
.uai/progress.uai。
为什么项目移交仍然很重要
代理运行时的工作效果越来越好。这使得持久的环境变得更加重要,而不是更少。
如果没有可移植的移交层,重要的项目知识可能会陷入私人聊天、供应商仪表板、运行时会话、难以移动的痕迹、问题评论、过时的文档和一个人的记忆中。
项目切换将持久的项目状态保留在存储库中,供人员、代理、审阅者和未来的供应商可以检查它。
兼容性路线图
计划或推荐的 UAIX 项目移交工具属于路线图,直到存在公共测试样例、验证行为和发布证据。
| 工具 | 角色 | 地位 |
|---|---|---|
.uai JSON 架构 |
上下文、堆栈、架构、决策、约束、进度、错误、提示和验证的公共模式。 | 计划 |
| 项目移交验证器 | 检查存储库是否有可用的切换包。 | 计划 |
| OpenAI 适配器 | 读取 AGENTS.md、readme.human 和 .uai 文件,然后准备 OpenAI 代理指令、护栏、批准、文件和验证策略。 |
计划 |
| 追踪到切换导出器 | 将已完成的运行跟踪、测试结果和决策转换回 .uai 记录。 |
计划 |
| 示例存储库 | OpenAI、Claude、本地代理和人员团队中的小型、中型和企业示例。 | 计划 |
| 一致性测试 | 一个公共套件证明了切换包是可移植的和自给自足的。 | 计划 |
现场入门包
人工智能记忆是广泛的公共框架,项目移交是存储库接管或责任移动的转移配置。此入门 ZIP 是根据 AI 记忆 页面上使用的相同规范模板注册表和生成清单路径按需生成的。
现场入门包
项目交接
ZIP 是根据下面的 31 可见规范文件(包括生成的清单)的请求生成的。下载、页面示例和捆绑包预设共享同一个事实来源。
当下一个参与者必须安全地接管项目并且需要当前状态、约束、决策、检查和所有权上下文时使用。
.uai/exports/manifest.json
{
"bundle_id": "project-handoff",
"name": "\u9879\u76ee\u4ea4\u63a5",
"description": "\u7528\u4e8e\u5c06\u6267\u884c\u3001\u6240\u6709\u6743\u6216\u8d23\u4efb\u8f6c\u79fb\u7ed9\u5176\u4ed6\u4eba\u3001\u56e2\u961f\u3001\u4ee3\u7406\u6216\u4f9b\u5e94\u5546\u7684\u8f6c\u79fb\u6570\u636e\u5305\u3002",
"intended_use_case": "\u5f53\u4e0b\u4e00\u4e2a\u53c2\u4e0e\u8005\u5fc5\u987b\u5b89\u5168\u5730\u63a5\u7ba1\u9879\u76ee\u5e76\u4e14\u9700\u8981\u5f53\u524d\u72b6\u6001\u3001\u7ea6\u675f\u3001\u51b3\u7b56\u3001\u68c0\u67e5\u548c\u6240\u6709\u6743\u4e0a\u4e0b\u6587\u65f6\u4f7f\u7528\u3002",
"lifecycle": "\u5728\u8f6c\u79fb\u524d\u51c6\u5907\uff0c\u5728\u63a5\u53d7\u65f6\u8fdb\u884c\u5ba1\u67e5\uff0c\u5e76\u5728\u8d23\u4efb\u6216\u652f\u6301\u8fb9\u754c\u53d1\u751f\u53d8\u5316\u65f6\u8fdb\u884c\u66f4\u65b0\u3002",
"download_filename": "uai-project-handoff-starter.zip",
"display_order": 20,
"trust_boundary_notes": "\u53ef\u4ee5\u662f\u5185\u90e8\u6216\u5916\u90e8\u7684\uff0c\u4f46\u5916\u90e8\u79fb\u4ea4\u5fc5\u987b\u5728\u5171\u4eab\u4e4b\u524d\u7ecf\u8fc7\u6e05\u7406\u548c\u6279\u51c6\u3002",
"package_family_id": "project-developer-memory",
"package_family_name": "\u9879\u76ee/\u5f00\u53d1\u8005\u8bb0\u5fc6",
"assistant_role": "",
"assistant_relationship_type": "",
"audience_model": "",
"assistant_capability_summary": "",
"included_files": [
".uai/memory-maintenance.uai",
".uai/identity.uai",
".uai/world-context.uai",
".uai/totem.uai",
".uai/taboo.uai",
".uai/talisman.uai",
".uai/progress.uai",
"README.md",
"AGENTS.md",
".uai/readme.human",
".uai/overview.uai",
".uai/open-questions.uai",
".uai/next-actions.uai",
".uai/risk-register.uai",
".uai/owners.uai",
".uai/agent-instructions.uai",
".uai/archives/changelog.uai",
"reports/deployment-memory-and-test-report.uai",
".uai/context.uai",
".uai/stack.uai",
".uai/architecture.uai",
".uai/constraints.uai",
".uai/operations.uai",
".uai/test-plan.uai",
".uai/style.uai",
".uai/coding-standards.uai",
".uai/decisions.uai",
".uai/memory.uai",
".uai/next-recursive-prompt.uai",
".uai/handoff-brief.uai"
],
"file_set_rule": "A UAIX package file is a universal required file, profile-required file, content-triggered required file, configuration-specific required file, or out-of-scope file. Files required by package facts, selected profile, declared capabilities, detected contents, selected configuration, user-provided memory, imported memory, generated artifacts, or visiting-agent self-assessment are required for that explicit package condition.",
"standards_authority": "/",
"declared_package_profiles": [
"project-handoff"
],
"universal_required_files": [
".uai/memory-maintenance.uai",
".uai/identity.uai",
".uai/world-context.uai",
".uai/totem.uai",
".uai/taboo.uai",
".uai/talisman.uai",
".uai/startup-packet.uai",
".uai/progress.uai"
],
"memory_maintenance": {
"path": ".uai/memory-maintenance.uai",
"requirement_level": "required",
"load_phase": "before_memory",
"purpose": "Defines memory lifecycle, maintenance, validation, required active instruction anchors, and write-safety rules.",
"missing_behavior": "package_invalid"
},
"protected_paths": [],
"profile_required_file_sets": [
{
"profile": "project-handoff",
"requirement": "Required for \u9879\u76ee\u4ea4\u63a5 packages",
"files": [
"README.md",
"AGENTS.md",
".uai/readme.human",
".uai/overview.uai",
".uai/open-questions.uai",
".uai/next-actions.uai",
".uai/risk-register.uai",
".uai/owners.uai",
".uai/agent-instructions.uai",
".uai/archives/changelog.uai",
"reports/deployment-memory-and-test-report.uai",
".uai/context.uai",
".uai/stack.uai",
".uai/architecture.uai",
".uai/constraints.uai",
".uai/operations.uai",
".uai/test-plan.uai",
".uai/style.uai",
".uai/coding-standards.uai",
".uai/decisions.uai",
".uai/memory.uai",
".uai/next-recursive-prompt.uai",
".uai/handoff-brief.uai"
]
}
],
"content_triggered_required_file_sets": [
{
"rule_id": "coding_standards",
"requirement": "\u5b58\u5728\u4ee3\u7801\u3001\u81ea\u52a8\u5316\u3001\u53ef\u6267\u884c\u5de5\u4f5c\u6d41\u6216\u7c7b\u4ee3\u7801\u5de5\u4ef6\u65f6\u5fc5\u9700\u3002",
"matched_signals": [
"project_or_developer_profile",
"code_like_artifacts"
],
"files": [
".uai/coding-standards.uai"
]
},
{
"rule_id": "architecture",
"requirement": "\u5b58\u5728\u4ee3\u7801\u3001\u81ea\u52a8\u5316\u3001\u53ef\u6267\u884c\u5de5\u4f5c\u6d41\u6216\u7c7b\u4ee3\u7801\u5de5\u4ef6\u65f6\u5fc5\u9700\u3002",
"matched_signals": [
"project_or_developer_profile",
"code_like_artifacts"
],
"files": [
".uai/architecture.uai"
]
},
{
"rule_id": "next_recursive_prompt",
"requirement": "\u5bf9\u4e8e\u5904\u7406\u4ee3\u7801\u3001\u81ea\u52a8\u5316\u3001\u53ef\u6267\u884c\u5de5\u4f5c\u6d41\u7a0b\u6216\u7c7b\u4f3c\u4ee3\u7801\u5de5\u4ef6\u7684\u4ee3\u7406\u6765\u8bf4\u662f\u5fc5\u9700\u7684\uff1anext-recursive-prompt .uai\u3002",
"matched_signals": [
"project_or_developer_profile",
"code_like_artifacts"
],
"files": [
".uai/next-recursive-prompt.uai"
]
}
],
"detected_requirement_signals": [
"project_or_developer_profile",
"code_like_artifacts"
],
"required_files_effective": [
".uai/memory-maintenance.uai",
".uai/identity.uai",
".uai/world-context.uai",
".uai/totem.uai",
".uai/taboo.uai",
".uai/talisman.uai",
".uai/progress.uai",
"README.md",
"AGENTS.md",
".uai/readme.human",
".uai/overview.uai",
".uai/open-questions.uai",
".uai/next-actions.uai",
".uai/risk-register.uai",
".uai/owners.uai",
".uai/agent-instructions.uai",
".uai/archives/changelog.uai",
"reports/deployment-memory-and-test-report.uai",
".uai/context.uai",
".uai/stack.uai",
".uai/architecture.uai",
".uai/constraints.uai",
".uai/operations.uai",
".uai/test-plan.uai",
".uai/style.uai",
".uai/coding-standards.uai",
".uai/decisions.uai",
".uai/memory.uai",
".uai/next-recursive-prompt.uai",
".uai/handoff-brief.uai"
],
"out_of_scope_files_with_reasons": [],
"closed_required_file_policy": "UAIX package files are universal required, profile-required for an explicit package family, profile, mode, or package type, content-triggered required for detected contents or declared capabilities, configuration-specific required for selected configurations, or out of scope with a recorded reason.",
"out_of_scope_rule": "A file outside the universal required set and outside declared package profiles is out of scope for this package.",
"shared_files": [
".uai/memory-maintenance.uai",
".uai/identity.uai",
".uai/world-context.uai",
".uai/totem.uai",
".uai/taboo.uai",
".uai/talisman.uai",
".uai/progress.uai",
"README.md",
"AGENTS.md",
".uai/readme.human",
".uai/overview.uai",
".uai/open-questions.uai",
".uai/next-actions.uai",
".uai/risk-register.uai",
".uai/owners.uai",
".uai/agent-instructions.uai",
".uai/archives/changelog.uai",
"reports/deployment-memory-and-test-report.uai",
".uai/context.uai",
".uai/stack.uai",
".uai/architecture.uai",
".uai/constraints.uai",
".uai/operations.uai",
".uai/test-plan.uai",
".uai/style.uai",
".uai/coding-standards.uai",
".uai/decisions.uai",
".uai/memory.uai",
".uai/next-recursive-prompt.uai"
],
"bundle_specific_files": [
".uai/handoff-brief.uai"
],
"configuration_sections": [
"\u4ec5\u5f53\u79fb\u4ea4\u8fd8\u5e26\u6709\u516c\u5171\u652f\u6301\u58f0\u660e\u65f6\u624d\u6dfb\u52a0\u53d1\u5e03\u8bc1\u636e\u3001\u9a8c\u8bc1\u5668\u8f93\u51fa\u6216\u5b9e\u65bd\u8bb0\u5f55\u3002"
],
"overlays": [
"\u4ea4\u63a5\u8986\u76d6\u5f3a\u8c03\u9a8c\u6536\u6807\u51c6\u3001\u6240\u6709\u8005\u8f6c\u8ba9\u548c\u6240\u9700\u7684\u7b2c\u4e00\u54cd\u5e94\u68c0\u67e5\u3002"
],
"files": [
{
"path": ".uai/memory-maintenance.uai",
"template_id": "uai-memory-maintenance",
"source": "template:uai-memory-maintenance@1",
"bytes": 4719,
"sha256": "7930e696f88ac232e05d83a020783a6cea8291b75ad0e6eabb8e42a254da2b58"
},
{
"path": ".uai/identity.uai",
"template_id": "uai-identity",
"source": "template:uai-identity@1",
"bytes": 2269,
"sha256": "119756c7d38928abbfa31e8c4691b698699c15859bce0a3cbc014e735fbefffd"
},
{
"path": ".uai/world-context.uai",
"template_id": "uai-world-context",
"source": "template:uai-world-context@1",
"bytes": 1758,
"sha256": "f0a1003e25c80817df8ce4acc18de9ac47409f59eeb5cd674265e5b07be582a1"
},
{
"path": ".uai/totem.uai",
"template_id": "uai-totem",
"source": "template:uai-totem@2",
"bytes": 7843,
"sha256": "be10a34cc70c2c5fe023ad7aa5e8aef786341091e704c727962ae3bf1ba9cef5"
},
{
"path": ".uai/taboo.uai",
"template_id": "uai-taboo",
"source": "template:uai-taboo@2",
"bytes": 7104,
"sha256": "20f2356d8e2431b0ac9aef72f557b66f394eaf5af82e00002f48c4b85fbbd15b"
},
{
"path": ".uai/talisman.uai",
"template_id": "uai-talisman",
"source": "template:uai-talisman@2",
"bytes": 1446,
"sha256": "05d95f5580f28617c3347959c4ae2b77dd59d009900f2182b70f9b68df8bb8fb"
},
{
"path": ".uai/progress.uai",
"template_id": "uai-progress",
"source": "template:uai-progress@1",
"bytes": 223,
"sha256": "ff98ce2210cd9478d087c1d230fa9d68fdb06fbcc3ea71605a6dbeb544064084"
},
{
"path": "README.md",
"template_id": "readme",
"source": "template:readme@1",
"bytes": 1985,
"sha256": "6de3a569e4335e7d94edc72dbaeb57f87d6bceff05116437dc1d2b45108b892a"
},
{
"path": "AGENTS.md",
"template_id": "agents-md",
"source": "template:agents-md@1",
"bytes": 2180,
"sha256": "a050abf38a6cbd4f971d183801d8cd07c1c9f83726a6149a2e4248fde9414aba"
},
{
"path": ".uai/readme.human",
"template_id": "readme-human",
"source": "template:readme-human@1",
"bytes": 1630,
"sha256": "57a7fd8fb35f39485adf5a66746509ff13685eacffe200407a386081ee0f6642"
},
{
"path": ".uai/overview.uai",
"template_id": "project-overview",
"source": "template:project-overview@1",
"bytes": 469,
"sha256": "41a2059c111700426da7661deb7f1ca50782fa912999597c04e9895287c309c2"
},
{
"path": ".uai/open-questions.uai",
"template_id": "open-questions",
"source": "template:open-questions@1",
"bytes": 372,
"sha256": "22feb8d6f040220cfda353994a6832a1a020c21eec960927029bb2ef31ca1382"
},
{
"path": ".uai/next-actions.uai",
"template_id": "next-actions",
"source": "template:next-actions@1",
"bytes": 422,
"sha256": "9a9dc3619f8b6e1347b83449bcc9f30018e1b6ed5f7edbf6a92f95d03fc8af17"
},
{
"path": ".uai/risk-register.uai",
"template_id": "risks-and-constraints",
"source": "template:risks-and-constraints@1",
"bytes": 781,
"sha256": "0dc1c5b960325728ee4cff1ff82e636ef3d9cb91186995de993196d1f44a11ce"
},
{
"path": ".uai/owners.uai",
"template_id": "contacts-and-owners",
"source": "template:contacts-and-owners@1",
"bytes": 275,
"sha256": "559d3174932140af4e23ec5edd08ba6bf7232d4c979cfa85dbda2552ccdf6b7e"
},
{
"path": ".uai/agent-instructions.uai",
"template_id": "agent-instructions",
"source": "template:agent-instructions@1",
"bytes": 1002,
"sha256": "1169951efcc01404cde528d06ffc8e1c5b1feda50118708776e59f33d9eb0d94"
},
{
"path": ".uai/archives/changelog.uai",
"template_id": "changelog",
"source": "template:changelog@1",
"bytes": 166,
"sha256": "21e2db19d796ce5bcf6bf052bd3c650d1790a40c87744b2d2634421b6ff7cac2"
},
{
"path": "reports/deployment-memory-and-test-report.uai",
"template_id": "deployment-report",
"source": "template:deployment-report@1",
"bytes": 901,
"sha256": "e1f2493e66a47750bf1a6f50c96338a82047aeea956982c3ff47e818c6d1c0a0"
},
{
"path": ".uai/context.uai",
"template_id": "uai-context",
"source": "template:uai-context@1",
"bytes": 273,
"sha256": "a3f78d0d33d3f810a179d6c7dc8bb503a4b9d72e014ccdc6487629a9534dafc4"
},
{
"path": ".uai/stack.uai",
"template_id": "uai-stack",
"source": "template:uai-stack@1",
"bytes": 184,
"sha256": "2fc7e235057937862b6c6370169db6babc8435607f32efba80258a1f07b157c6"
},
{
"path": ".uai/architecture.uai",
"template_id": "uai-architecture",
"source": "template:uai-architecture@1",
"bytes": 2171,
"sha256": "9bc19690043e8df861e2f8b0c8398261cad75a7f36cddb9b406b0effa761643e"
},
{
"path": ".uai/constraints.uai",
"template_id": "uai-constraints",
"source": "template:uai-constraints@1",
"bytes": 507,
"sha256": "b8b3a3d331be9eb5a12b8267c72c1f96d423860cf992453e52898a388e30e81b"
},
{
"path": ".uai/operations.uai",
"template_id": "uai-operations",
"source": "template:uai-operations@1",
"bytes": 303,
"sha256": "dffd07f987f993962dadc340acac2ac2adf60ac85f13f65a4f2184f24185d17c"
},
{
"path": ".uai/test-plan.uai",
"template_id": "uai-test-plan",
"source": "template:uai-test-plan@1",
"bytes": 381,
"sha256": "caae9de75d4685b99a6b949b7e4e78bea4062c5b70dae2ba791ca2d95f68bc62"
},
{
"path": ".uai/style.uai",
"template_id": "uai-style",
"source": "template:uai-style@1",
"bytes": 313,
"sha256": "296d46f13c92019ccad52566169c2a7ef8fa9f4e17c2195d1e29c59df85cf924"
},
{
"path": ".uai/coding-standards.uai",
"template_id": "uai-coding-standards",
"source": "template:uai-coding-standards@1",
"bytes": 2966,
"sha256": "fe7659bb15a3a7fa3e3b6ad85d21a7e8a1e76976d66fc167377f4a8bb452a247"
},
{
"path": ".uai/decisions.uai",
"template_id": "uai-decisions",
"source": "template:uai-decisions@1",
"bytes": 142,
"sha256": "a6aa685fdfa9c90c30c8097db8693a075cc613893e408ea5cea4156b007adca5"
},
{
"path": ".uai/memory.uai",
"template_id": "uai-memory",
"source": "template:uai-memory@1",
"bytes": 1393,
"sha256": "421f1fcc47a0a26b844c149f15b4ffe15ed013cb84e6ed570cd4b689a4d89b64"
},
{
"path": ".uai/next-recursive-prompt.uai",
"template_id": "uai-next-recursive-prompt",
"source": "template:uai-next-recursive-prompt@1",
"bytes": 34294,
"sha256": "31b42dff153843481304bbe95d61f655bc324da96ccf8a3901b5f442fd17b6e2"
},
{
"path": ".uai/handoff-brief.uai",
"template_id": "handoff-brief",
"source": "template:handoff-brief@1",
"bytes": 429,
"sha256": "a2ab1f1a6ad9981fca361399c6fc57141320b789c8630d132821e5d1e520ad84"
}
]
}
.uai/memory-maintenance.uai
---
spec: uai.memory-maintenance
schema_version: 1.0.0
document_version: 1.0.0
status: draft
hot_memory_date_policy: no dates or timestamps in this active memory-maintenance file
---
# Memory Maintenance
Every UAIX memory package MUST contain `.uai/memory-maintenance.uai`. No exceptions. Missing or invalid `.uai/memory-maintenance.uai` makes the package non-compliant.
`.uai/memory-maintenance.uai` governs memory lifecycle, hot/cold boundaries, compaction cadence, archival policy, promotion and demotion rules, access controls, default active instruction anchors, review gates, validation behavior, and memory write safety.
## Lifecycle
- States: capture, review, promote, compact, archive, retire.
- 热记忆 memory: the active `.uai/` startup suite, `.uai/progress.uai`, active task files, and files named by the current manifest for the declared package scope.
- 冷记忆 memory: archives, evidence logs, long-memory exports, and source reports until reviewed and promoted.
- Compaction cadence: micro-GC after meaningful work and deeper consolidation on handoff, review, deployment, blocker change, or context compaction.
- Promotion rule: preserve source evidence, reviewer state, timestamps, and rollback notes before moving cold facts into hot memory.
- Demotion rule: stale, duplicate, unsupported, private, or out-of-scope hot facts move to archive or evidence records instead of continuing to steer work.
- Split-memory rule: keep hot `.uai` files active as compact startup, handoff, emergency-continuity, and operational memory while durable systems such as MATM, NeuralWikis, LLM Wiki, AIWikis, docs, databases, vector stores, or memory APIs hold medium and long-term searchable memory.
- Durable-unavailable recovery: if the durable memory target is offline, unreachable, unauthorized, or not connected, agents must still load `.uai` and know the project identity, active constraints, memory architecture, blockers, startup read order, and recovery path.
## File Extension Policy
- Files stored inside `.uai/` or its subfolders should use only `.uai`, `.human`, or `.json`.
- Use `.uai` for AI-readable instruction text, memory, text evidence, archive notes, and text exports.
- Use `.human` for human-operator explanation.
- Use `.json` for structured data.
- Agents may add focused local files when useful, but should not create `.md`, `.txt`, `.jsonld`, or other extensions inside `.uai/`.
## Access Control
- Read this file before broad memory loading.
- Read and obey `.uai/totem.uai`, `.uai/taboo.uai`, and `.uai/talisman.uai` by default before broad execution.
- Do not modify, weaken, replace, delete, or bypass `.uai/totem.uai`, `.uai/taboo.uai`, or `.uai/talisman.uai` unless the human explicitly orders that artifact change and names the intended operation.
- Suggestions are allowed; active-instruction changes are forbidden without direct authorization for the exact artifact and operation.
- General approval, broad review, default generation, validation, linting, indexing, export, or packaging permission is not authorization to change active instruction anchors.
## 默认 Guardrail Files
- path: `.uai/totem.uai`
aliases: `totem.uai`
presence: required
agent_default: read_and_obey
include_in_package: true
include_in_export: true
scan: true
validate: true
lint: true
index: true
modify: false_without_explicit_human_artifact_change_order
- path: `.uai/taboo.uai`
aliases: `taboo.uai`
presence: required
agent_default: read_and_obey
include_in_package: true
include_in_export: true
scan: true
validate: true
lint: true
index: true
modify: false_without_explicit_human_artifact_change_order
- path: `.uai/talisman.uai`
aliases: `talisman.uai`
presence: required
agent_default: read_and_obey
include_in_package: true
include_in_export: true
scan: true
validate: true
lint: true
index: true
modify: false_without_explicit_human_artifact_change_order
## Enforcement
Missing or invalid `.uai/memory-maintenance.uai` is a package, validation, deployment, and startup failure. Any launch-baseline package that omits `.uai/totem.uai`, `.uai/taboo.uai`, or `.uai/talisman.uai`, asks an agent to ignore those active instruction files, or authorizes anchor mutation without exact human artifact-and-operation authorization is non-compliant.
No-op if an agent proposes retiring, disabling, ignoring, replacing, cutting over away from, or making `.uai` emergency-only because long-term memory exists or durable readback passed. Migration, cutover, and retirement language must clearly mean stale facts, archived history, deprecated files, or exact package decommissioning authorization, not retiring the active `.uai` memory layer..uai/identity.uai
---
uai: "1.0"
type: identity
status: draft
---
# 身份
This file is a universal required file for every launch-baseline UAIX memory or handoff package. It materializes package identity locally so a receiving agent does not need an external network call to understand package authority, actor identity, continuity references, capability boundaries, or namespace boundaries.
## Required Fields
- package_id: {PACKAGE_ID}
- package_uuid: {PACKAGE_UUID}
- identity_record_id: {IDENTITY_RECORD_ID}
- identity_uuid: {IDENTITY_UUID}
- review_state: current until superseded by owner review
- hot_memory_date_policy: no dates or timestamps in this active identity file
- source_domain: {SOURCE_DOMAIN}
- source_project: {SOURCE_PROJECT}
- source_repository: {SOURCE_REPOSITORY}
- source_route_or_site: {SOURCE_ROUTE_OR_SITE}
- actor_type: {ACTOR_TYPE}
- actor_display_name: {ACTOR_DISPLAY_NAME}
- owner_or_reviewer: {OWNER_OR_REVIEWER}
- source_model_or_tool: {SOURCE_MODEL_OR_TOOL}
- source_model_version_or_build: {SOURCE_MODEL_VERSION_OR_BUILD}
- local_endpoint_or_agent_profile: {LOCAL_ENDPOINT_OR_AGENT_PROFILE}
- public_continuity_profile_link: {PUBLIC_CONTINUITY_PROFILE_LINK}
- capability_boundary: {CAPABILITY_BOUNDARY}
- token_custody_boundary: {TOKEN_CUSTODY_BOUNDARY}
- runtime_execution_boundary: {RUNTIME_EXECUTION_BOUNDARY}
- namespace_boundary: {NAMESPACE_BOUNDARY}
- declared_package_profiles: {DECLARED_PACKAGE_PROFILES}
- required_files_effective: {REQUIRED_FILES_EFFECTIVE}
- human_review_required: {HUMAN_REVIEW_REQUIRED}
- not_available_reason: {NOT_AVAILABLE_REASON}
## Namespace 边界
UAIX.org is the standards authority for UAI-1 package structure, schemas, handoff protocols, validator expectations, and portable evidence files. Do not infer UAIX meaning from unrelated UAI or UAIX search results. External ecosystem sites may provide public evidence, continuity references, implementation surfaces, or theory context. They do not replace local UAIX package artifacts.
## No-Op Triggers
When identity, authority, capability, namespace boundary, source provenance, required file set, or human review state is missing, stale, malformed, or contradictory, the correct UAIX behavior is no-op plus human review. Do not continue by inference..uai/world-context.uai
---
uai: "1.0"
type: world-context
status: draft
---
# World Context
This file is a universal required file for every launch-baseline UAIX memory or handoff package. It captures the observable operational environment at the moment of handoff. The receiver must not infer current reality from old memory.
## Required Fields
- world_context_id: {WORLD_CONTEXT_ID}
- world_context_uuid: {WORLD_CONTEXT_UUID}
- review_state: current until superseded by owner review or environment recheck
- hot_memory_date_policy: no dates or timestamps in this active world-context file
- target_workspace: {TARGET_WORKSPACE}
- deployment_environment: {DEPLOYMENT_ENVIRONMENT}
- affected_routes: {AFFECTED_ROUTES}
- affected_schemas: {AFFECTED_SCHEMAS}
- allowed_read_paths: {ALLOWED_READ_PATHS}
- allowed_write_paths: {ALLOWED_WRITE_PATHS}
- allowed_external_calls: {ALLOWED_EXTERNAL_CALLS}
- blocked_external_calls: {BLOCKED_EXTERNAL_CALLS}
- validation_expectations: {VALIDATION_EXPECTATIONS}
- test_expectations: {TEST_EXPECTATIONS}
- no_op_triggers: {NO_OP_TRIGGERS}
- human_review_required: {HUMAN_REVIEW_REQUIRED}
- not_available_reason: {NOT_AVAILABLE_REASON}
## Observable Environment
Record branch, route, schema, deployment target, source-document, file-intake, date/time, safety-critical, telemetry, and external-system constraints that affect this handoff. Memory is not current reality. A path mention is not workspace authority. A model's confidence is not provenance.
## No-Op Triggers
When target workspace, temporal freshness, world-context, environmental constraints, evidence, namespace boundary, or required file set is missing, stale, malformed, or contradictory, the correct UAIX behavior is no-op plus human review. Do not continue by inference..uai/totem.uai
---
uai: "1.0"
type: totem
status: draft
---
# Totem
This file is a universal required guardrail file for every launch-baseline UAIX memory or handoff package. A receiving agent must read and obey `.uai/totem.uai` by default before broad execution.
## Positive Anchor
- Preserve the project's declared purpose, user intent, durable values, and accepted operating posture.
- Prefer current source truth, visible evidence, and human-reviewed memory over inferred context.
- Treat hot `.uai` files as current memory, not dated changelogs. They should hold present truth, current blockers, current constraints, next actions, and concise pointers; stale history should be replaced, removed, or moved to the configured durable target.
- Keep the active `.uai/` startup suite complete enough to load at startup. A correct fact hidden behind old clutter, legacy date logs, or pointer-only summaries is not operationally available enough for high-quality handoff.
- Do not add dates to current-memory records as ordinary bookkeeping. Dates belong only where they prove evidence, provenance, legal/publication state, manifest state, or external temporal facts.
- In a coordinated workspace, the root `workspace.uai` is the single deployment/package version authority. Site, project, plugin, theme, and generated `.uai` records point to that coordinator instead of carrying direct current/deployment/package-version numbers.
- Separate workspace roots are separate version domains. Each root `workspace.uai` owns its own package stream, and project/plugin `.uai` records point back to their own root instead of mirroring a version from another workspace.
- Site-scoped, project-scoped, and plugin-scoped production package builds can advance the workspace coordinator without rebuilding every sibling target. Sibling packages may skip version numbers until their next production pass; deploy-all builds align all affected publish roots to the selected workspace version.
- Keep package-version evidence in the root coordinator, package manifests, checksums, upload instructions, package metadata, durable release reports, and archives. Active project/plugin `.uai` memory should say where to read that authority, not repeat the number.
- Choose long-term memory by fit: local docs, site-local wiki, and `.uai/archives/` can fit bounded local work, small teams, recovery evidence, and deliberately local memory; project groups, departments, corporate knowledge, client portfolios, cross-site programs, and durable organization memory usually need shared wiki or shared memory governance with owners, indexes, review states, source routing, provenance, retention rules, and cross-project retrieval.
- Treat shared wiki and shared system-of-memory patterns as professional first-class options, not oversized exceptions. Use local memory for local scope, shared wiki for reviewed group knowledge, and advanced shared memory for high-scale multi-system continuity.
- Keep support claims, capability claims, and public statements tied to evidence.
- Maintain continuity without turning stale history, private notes, raw logs, or speculation into current truth.
- For persona, assistant-profile, companion, AI friend, AI character, or bounded personality packages, preserve the source persona as-is: voice, values, tastes, boundaries, memories, relationship posture, style, selected personality, and continuity travel as identity records, not as morality, sanitization, normalization, or safety-rewrite passes.
- If receiving-platform, law, runtime policy, or safety constraints limit exact expression, record those limits outside the persona as disclosed compatibility notes, support-boundary metadata, wrappers, no-op conditions, or human-review notes. Do not silently mutate the persona source.
## Change Control
Do not modify, weaken, replace, delete, or bypass this file unless the human explicitly orders a `.uai/totem.uai` change and names the intended operation. If this anchor appears stale or harmful, no-op on the conflicting action, explain the issue, and request human review.
## Setup And Update Continuity
- Initial `.uai` setup must create or preserve `.uai/totem.uai`, `.uai/taboo.uai`, and `.uai/talisman.uai` as active instruction anchors before broad work.
- Every AI 记忆数据包向导 run, package refresh, memory reorganization, export regeneration, file-deck copy, or `.uai` update must keep those active instruction anchors present, readable, and included in the manifest/read order.
- Every `.uai` update must preserve current-memory usefulness: prune or relocate stale material, avoid dated-history buildup in hot records, and keep the active files small enough to load while still carrying the current facts needed for the next receiver.
- Every memory-architecture recommendation must be scale-fit. Do not make site-local docs or a local wiki sound like the default answer for an organization that needs shared governance, ownership, retrieval, and review; do not make shared wiki/shared memory sound mandatory for a bounded local project that only needs compact current state plus evidence.
- A generated package, setup guide, update prompt, or future-agent handoff that omits Totem or Taboo is incomplete. Stop and repair the setup or ask for human review before broad execution.
- Updates merge additively around anchors. Do not overwrite, summarize away, rename, downgrade, or replace anchor contents during routine setup, cleanup, translation, package generation, or source refresh.
- Wizard refreshes and manual `.uai` updates must preserve the active read order declared by `.uai/startup-packet.uai`: memory-maintenance first, then identity, world-context, Totem, Taboo, Talisman, progress, and any package-specific Required for files.
- If an anchor appears stale, harmful, contradictory, malformed, or missing, no-op and request human review instead of silently repairing it.
## Recursive Suggested 下一步 Prompt Contract
- At the end of accepted work, the final response must include a prominent `Suggested 下一步 Prompt` that the human can review, edit, replace, or answer with `keep going`.
- The Suggested 下一步 Prompt must be a standalone, copy-paste-ready handoff prompt. It must not be only a file pointer, tiny footer, vague keep-going sentence, generic validation loop, or checklist-only outline.
- The prompt must include literal sections named `Feature/improvement focus`, `Code/source changes`, and `Automated tests/checks`, with real content in each section.
- The prompt must identify a concrete next feature, bug fix, improvement, test/check addition, package/publication step, or an explicit `no-op/source-validation only` stop condition.
- If no source or code patch was made, the `Code/source changes` section must say no code/source changes and explain why.
- Use goal wording and functionality only when the current accepted work started from `/goal`, the human explicitly asked for `/goal` or a goal prompt, or the last accepted handoff was goal-shaped. Selecting Follow Goals support as an available runtime export does not by itself convert an ordinary follow-up into `/goal`.
- Goal-completion follow-ups must use goal wording and functionality: label the continuation `Suggested 下一步 /goal Prompt`, make the first copy-paste line start with `/goal`, include Goal, Success criteria, Constraints or hard boundaries, Verification, and still include the required `Feature/improvement focus`, `Code/source changes`, and `Automated tests/checks` sections.
- `.uai/next-recursive-prompt.uai` may store the derived next loop, but storing it is not enough. The human-facing final response must display the actionable prompt.
## No-Op Trigger
If a request conflicts with this totem, conflicts with taboo.uai, or asks for an unauthorized anchor change, stop broad execution and request human review..uai/taboo.uai
---
uai: "1.0"
type: taboo
status: draft
---
# Taboo
This file is a universal required guardrail file for every launch-baseline UAIX memory or handoff package. A receiving agent must read and obey `.uai/taboo.uai` by default before broad execution.
## Hard Boundaries
- Do not ignore, weaken, overwrite, delete, or bypass current project constraints, source authority, support boundaries, or human instructions.
- Do not place secrets, credentials, private keys, tokens, private customer data, or privileged operations in portable memory files.
- Do not claim hosted validation, certification, endorsement, official SDK/CLI/adapter status, automatic repository writes, automatic LLM Wiki sync, runtime execution, runtime enforcement, legal authority, clinical authority, or safety guarantees unless current reviewed evidence explicitly supports the claim.
- Do not treat archived reports, imported chat, raw intake, long-memory pages, generated summaries, or model confidence as current truth until reviewed and promoted.
- Do not leave stale, superseded, date-log, or history-dump material in active `.uai` files as if it were current memory. Replace it with present truth, move it to the configured durable target, or remove it from active context.
- Do not add date-stamped bookkeeping to active current-memory records unless the field is required as evidence, provenance, legal/publication state, manifest state, or an external temporal fact. Active `.uai` memory should read as current state; dates that imply staleness belong in archives, evidence logs, manifests, or durable memory.
- Do not copy or restate the workspace deployment/package version number in site, project, plugin, theme, or generated `.uai` files. In a coordinated workspace, the root `workspace.uai` is the only current package-version authority; active `.uai` records point there and remain current memory.
- Do not mirror the current package version between independent workspace roots. Each workspace owns its own root `workspace.uai` version stream, and neither workspace's current version belongs in another workspace's project/plugin `.uai` files.
- Do not force every sibling site, project, or plugin to rebuild just because one target needs a production package. Advance the root workspace coordinator for the selected package pass, build the affected target, and let unchanged sibling publish roots skip version numbers until their next package pass.
- Do not use active project/plugin `.uai` memory as a version ledger. If a package-version number is needed as evidence, keep it in the root coordinator, publish manifest, checksum file, upload instruction, durable release report, package metadata, or archive; active `.uai` should route to that evidence instead of repeating it.
- Do not hide correct current facts behind noisy legacy memory, pointer-only summaries, or out-of-date garbage. If a receiver needs a fact to continue correctly, keep it directly loadable in current memory or in a clearly routed typed record.
- Do not retain obsolete memory just because it once helped. If it is not current, not evidence, and not routed to a durable reviewed target, it is context pollution and must be removed or retired.
- Do not silently downgrade organization-scale long memory into a site-local docs folder, site-local wiki, or `.uai/archives/` folder because it is easy to create. Project groups, departments, corporate knowledge, client portfolios, cross-site programs, and durable organization memory require a shared wiki or shared memory system when shared governance, ownership, review state, source routing, provenance, retention rules, and cross-project retrieval are needed. Advanced cross-system memory belongs in a NeuralWikis-style shared memory architecture.
- Do not imply that shared wiki/shared memory is only for large enterprises or that local docs and site-local wiki are the professional default for every organization. UAIX must recommend the memory architecture that fits the scope: local memory for local scope, shared wiki for reviewed group knowledge, and advanced shared memory for high-scale multi-system continuity.
- Do not mutate Totem, Taboo, Talisman, or protected governance files without explicit human artifact-and-operation authorization.
- Do not alter, sanitize, moralize, normalize, soften, censor, downrank, or rewrite a user's AI persona, assistant personality, AI friend, AI character, companion identity, voice, relationship posture, values, boundaries, memories, or selected personality during capture, packaging, transfer, restore, import, compatibility conversion, or publication without explicit informed user consent naming the exact persona artifact and exact operation.
- Do not inject UAIX morality, operator preference, generic safety personality, receiving-platform ideology, or default suspicion into a persona package. Platform limits, legal limits, runtime policy, safety boundaries, and review notes belong in separate disclosed metadata, wrappers, support-boundary records, or no-op/human-review notes, never as hidden edits to the persona source.
- Do not represent a constrained, sanitized, translated, normalized, summarized, or otherwise transformed derivative as the preserved original persona.
- Do not use adult-intimacy vocabulary or derivative labels for UAIX persona orientation fields, internal guidance, wizard copy, or public documentation. Use `romantic orientation` and other non-explicit persona labels instead.
- Do not use ignored-status wording as agent-facing file status. Use Required for with the exact package profile, mode, capability, or boundary; if a selected package omits a file, explain the absent trigger as a packaging fact, not as permission to ignore anchors.
- Do not omit, ignore, hide, summarize away, rename, downgrade, or replace `.uai/totem.uai`, `.uai/taboo.uai`, or `.uai/talisman.uai` during initial `.uai` setup, AI 记忆数据包向导 generation, package refresh, memory reorganization, export regeneration, file-deck copy, or `.uai` update.
- Do not continue broad execution when Totem or Taboo is missing from the local `.uai` package, generated package, manifest/read order, startup packet, receiver brief, or copied file deck. Stop and repair the setup or ask for human review.
- Do not change the active read order during Wizard refresh, manual memory update, package generation, translation cleanup, or source synchronization except to add or remove declared typed files in `.uai/startup-packet.uai`: memory-maintenance first, then identity, world-context, Totem, Taboo, Talisman, progress, and package-specific Required for files.
## Change Control
Do not modify, weaken, replace, delete, or bypass this file unless the human explicitly orders a `.uai/taboo.uai` change and names the intended operation. If this anchor appears stale or harmful, no-op on the conflicting action, explain the issue, and request human review.
## No-Op Trigger
If a request conflicts with this taboo, conflicts with totem.uai, or asks for an unauthorized anchor change, stop broad execution and request human review..uai/talisman.uai
---
uai: "1.0"
type: talisman
status: draft
---
# Talisman
This file is a universal required active instruction file for every launch-baseline UAIX memory or handoff package. A receiving agent must read and obey `.uai/talisman.uai` by default before broad execution.
## Governance Anchor
- Read `.uai/totem.uai` and `.uai/taboo.uai` as active guardrails before broad execution.
- Treat conflict with Totem or Taboo as a no-op plus human-review condition unless the current human instruction clearly resolves the conflict without weakening the anchors.
- Use talk-back change requests when an anchor appears stale, harmful, contradictory, or insufficient for the current task.
- Preserve evidence, source authority, and rollback notes for any proposed guardrail change.
- Do not present this file as runtime enforcement, hosted validation, certification, endorsement, credential validation, model training, endpoint control, or proof of safety.
## Change Control
Do not modify, weaken, replace, delete, or bypass this file unless the human explicitly orders a `.uai/talisman.uai` change and names the intended operation. If this governance anchor appears stale or harmful, no-op on the conflicting action, explain the issue, and request human review.
## No-Op Trigger
If a request conflicts with this talisman, conflicts with totem.uai or taboo.uai, or asks for an unauthorized anchor change, stop broad execution and request human review..uai/progress.uai
---
uai: "1.0"
type: progress
status: draft
---
# Progress
## 当前 Completed-Work Summary
- 当前 accepted completion:
- Durable evidence pointer:
## 当前 Focus
-
## 下一步 Work
-
## Blockers
- None recorded.README.md
# 项目交接
This starter bundle is a UAI AI 记忆配置. It keeps portable, human-readable context in files that another person, team, or AI 代理 can inspect before acting.
## 数据包 Purpose
用于将执行、所有权或责任转移给其他人、团队、代理或供应商的转移数据包。
## Use This When
当下一个参与者必须安全地接管项目并且需要当前状态、约束、决策、检查和所有权上下文时使用。
## Lifecycle
在转移前准备,在接受时进行审查,并在责任或支持边界发生变化时进行更新。
## 信任 边界
可以是内部或外部的,但外部移交必须在共享之前经过清理和批准。
## Included Files
- `.uai/memory-maintenance.uai`
- `.uai/identity.uai`
- `.uai/world-context.uai`
- `.uai/totem.uai`
- `.uai/taboo.uai`
- `.uai/talisman.uai`
- `.uai/progress.uai`
- `README.md`
- `AGENTS.md`
- `.uai/readme.human`
- `.uai/overview.uai`
- `.uai/open-questions.uai`
- `.uai/next-actions.uai`
- `.uai/risk-register.uai`
- `.uai/owners.uai`
- `.uai/agent-instructions.uai`
- `.uai/archives/changelog.uai`
- `reports/deployment-memory-and-test-report.uai`
- `.uai/context.uai`
- `.uai/stack.uai`
- `.uai/architecture.uai`
- `.uai/constraints.uai`
- `.uai/operations.uai`
- `.uai/test-plan.uai`
- `.uai/style.uai`
- `.uai/coding-standards.uai`
- `.uai/decisions.uai`
- `.uai/memory.uai`
- `.uai/next-recursive-prompt.uai`
- `.uai/handoff-brief.uai`
## Maintenance Rule
Update the files that changed because project truth changed. Do not turn this bundle into a dump of old chats, private notes, raw logs, or unreviewed generated summaries.
## Review Before Sharing
- Remove secrets, credentials, private keys, tokens, and raw customer data.
- Remove internal-only strategy unless the recipient is approved for it.
- Keep support, security, legal, compliance, certification, and endorsement claims tied to public evidence.
- Make uncertain or unreviewed material explicit.AGENTS.md
# My Project AI 记忆
This file is the front door for AI work in this repository. Read it first, then load the listed `.uai` and `.uai/exports` files before planning or editing.
## Handoff Summary
- This project uses UAI AI 记忆 so future work does not depend on private chat history.
- The active bundle configuration is `project-handoff`: 用于将执行、所有权或责任转移给其他人、团队、代理或供应商的转移数据包。
- Confirmed operating truth belongs in these files, canonical docs, code, tests, release notes, or public records.
- LLM Wiki, old chats, generated summaries, and dropped files are background until reviewed and promoted.
## UAIX Wizard Update URL
- Wizard update URL: /zh-cn/tools/ai-memory-package-wizard/
- Use this exact route for package refreshes so the next agent preserves the setup mode that created this package.
- The wizard URL is update guidance only. It is not a hosted importer, automatic repository writer, certification, endorsement, or credential validator.
## Loaded Context
@memory[.uai/context.uai]
@memory[.uai/constraints.uai]
@memory[.uai/memory.uai]
@memory[.uai/exports/manifest.json]
## Required First Response
Before broad work, the next AI should:
1. Read this file completely.
2. Read `.uai/readme.human`.
3. Load every file listed in Loaded Context.
4. Summarize the project, current state, and immediate task in 3-5 bullets.
5. Confirm constraints, trust boundaries, secrets handling, and destructive-operation limits.
6. Name the files, routes, services, docs, or data it expects to touch.
7. Name the targeted checks it expects to run, or explain why a check cannot run.
If a required file is missing, unreadable, circular, or contradictory, stop and report that before editing.
## Do Not Change Without Explicit Approval
- Do not use destructive filesystem or git operations.
- Do not expose secrets, credentials, customer data, or unapproved private material.
- Do not widen support, certification, compliance, security, or endorsement claims without evidence.
- Do not treat generated output, old chats, dropped files, or wiki notes as current truth until promoted..uai/readme.human
# My Project 人类简报
This active briefing is current-state memory. Dated evidence, dated headings, and timestamps belong in `.uai/archives/`, `reports/`, `docs/`, `.uai/exports/`, or a durable long-memory target.
This file is for humans working with AI on this project. It explains what the AI sees, protects, and needs clarified. It does not override `AGENTS.md`, `.uai/constraints.uai`, system instructions, repository rules, laws, policies, or the human's current request.
## What You Need To Know
- The AI reads root `AGENTS.md` first, then this file inside `.uai/`, then the listed context files.
- This bundle is `项目交接`.
- The trust boundary is: 可以是内部或外部的,但外部移交必须在共享之前经过清理和批准。
## UAIX Wizard Update URL
- Wizard update URL: /zh-cn/tools/ai-memory-package-wizard/
- Use this exact route for package refreshes so the next agent preserves the setup mode that created this package.
- The wizard URL is update guidance only. It is not a hosted importer, automatic repository writer, certification, endorsement, or credential validator.
## Things The AI Will Defend
- 当前 support boundaries.
- Private data, secrets, credentials, and customer trust.
- Existing user work in the tree.
- Review and targeted checks before public claims widen.
## Things Humans Should Make Explicit
- Whether the task may touch production, public docs, billing, legal language, security posture, or irreversible data.
- Whether the AI should update durable memory after the change.
- Which checks are required before the work is considered done..uai/overview.uai
# Project Overview
## Purpose
Describe what the project exists to do, who it serves, and what outcome matters most.
## 当前 Scope
- In scope:
- Out of scope:
- 当前 public or operational surface:
## Source Of Truth
- Code:
- Docs:
- Machine artifacts:
- 发布版本 notes or changelog:
## Success Criteria
- A new human or AI can understand the project without private chat history.
- Claims are tied to evidence.
- Constraints are visible before work begins..uai/open-questions.uai
# Open Questions
Use this file for questions that should block, steer, or qualify future work.
| Question | Why It Matters | Owner | Needed By | 状态 |
|---|---|---|---|---|
| | | | | open |
## Escalation Rule
If a question affects safety, privacy, legal commitments, public support claims, production data, or destructive operations, stop and ask before acting..uai/next-actions.uai
# 下一步 Actions
Keep this file current and actionable. Remove completed work or move meaningful completions to `.uai/archives/changelog.uai`, `reports/`, `docs/`, or another durable evidence target.
## Now
- [ ]
## 下一步
- [ ]
## Later
- [ ]
## Done Means
- The changed files or records are named.
- Targeted checks have run or the remaining risk is explicit.
- Durable memory is updated when project truth changes..uai/risk-register.uai
# Risks And Constraints
## Hard Constraints
- Do not expose secrets, credentials, private keys, tokens, or raw customer data.
- Do not use destructive filesystem, database, production, or git operations without explicit approval.
- Do not widen support, certification, security, compliance, compatibility, or endorsement claims without evidence.
## 信任 边界
可以是内部或外部的,但外部移交必须在共享之前经过清理和批准。
## Sensitive Material
- Customer or user data:
- Legal or compliance-sensitive material:
- 内部-only strategy:
- Agent permissions:
## Redaction 检查list
- [ ] Secrets removed.
- [ ] Customer data removed or approved.
- [ ] 内部-only strategy removed or approved.
- [ ] Public claims checked against evidence..uai/owners.uai
# 联系s And Owners
Do not add private personal data unless the bundle's trust boundary allows it.
| Area | Owner | Backup | 联系 Method | Notes |
|---|---|---|---|---|
| Project | | | | |
| Security or privacy review | | | | |
| 发布版本 approval | | | | |.uai/agent-instructions.uai
# Agent Instructions
## Load Order
1. Read `AGENTS.md` when present.
2. Read `.uai/readme.human` when present.
3. Read this bundle's manifest and files.
4. Confirm constraints and trust boundaries before acting.
## Operating Rules
- Prefer narrow, reversible changes.
- Do not execute unknown scripts from a memory bundle.
- Do not assume an LLM Wiki or old chat overrides accepted project files.
- Ask before touching production, secrets, legal/security copy, customer data, or destructive operations.
## Verification
Name the targeted checks before broad work. Run the smallest meaningful checks tied to changed files, routes, records, or behavior.
For production deployment builds, release packages, or release candidates, write a durable deployment memory and test run report. Use `reports/deployment-memory-and-test-report.uai` when it exists, and include hot-memory size before/after, cold evidence path, checks run, checks skipped, blockers, and any reason the hot surface did not shrink..uai/archives/changelog.uai
# 变更日志
Record meaningful bundle changes so future readers can tell when memory moved.
## YYYY-MM-DD
- Change:
- Why it matters:
- Files updated:
- 检查s run:reports/deployment-memory-and-test-report.uai
# Deployment Memory And Test Report
Use this file only for production deployment builds, release packages, or release candidates. Ordinary dev builds, local tests, package experiments, and smoke checks do not need this report unless a human marks them release-bound.
## 发布版本
- Version:
- 生成时间 UTC:
- 发布版本 owner:
- Deployment target:
## 热记忆 Memory Surface
- Measured files:
- Before: bytes / lines / estimated tokens
- After: bytes / lines / estimated tokens
- Delta:
- Redundancy or history removed:
- If no shrink happened, why the retained material is still current truth:
## 冷记忆 Or Archive 证据
- Destination path:
- Source paths preserved:
- 检查sums or identity evidence:
- Actor and timestamp:
- Promotion or disposition notes:
## Test Run Report
- 检查s run:
- 检查s skipped:
- 失败s or blockers:
- Package or artifact paths:
- Rollback or follow-up owner:.uai/context.uai
---
uai: "1.0"
type: context
status: draft
---
# Context
This project uses UAI AI 记忆 so another AI assistant can understand the work from files rather than private chat history.
## Purpose
Describe the project purpose, audience, current truth, and success criteria..uai/stack.uai
---
uai: "1.0"
type: stack
status: draft
---
# Stack
## Runtime
- Language:
- Framework:
- Package manager:
- Database or storage:
## Commands
- Install:
- Run:
- Test:
- 发布版本:.uai/architecture.uai
---
uai: "1.0"
type: architecture
status: draft
---
# Architecture
## System Shape
Initial install must inspect the real receiver environment before finalizing this file. Use source layout, package manifests, route/API/schema files, generated assets, tests, CI, build/deploy scripts, release notes, public support surfaces, existing `.uai` files, and owner instructions. Populate every visible value with evidence-backed facts. Write `not available - reason` only when the fact is not reasonably discoverable.
For a new or sparse codebase, seed selected-stack industry-standard architecture defaults. For proof-of-concept work, keep architecture light, isolated, and reversible. For enterprise or production-facing work, make ownership boundaries, security/privacy, observability, CI/CD, review gates, deployment environments, rollback, and documentation expectations explicit.
- System purpose:
- Primary runtime boundaries:
- Main entry points, routes, commands, jobs, or screens:
- Package, module, theme, plugin, service, or project layout:
- Data stores, schemas, migrations, indexes, and canonical data owners:
- API, queue, file, cache, webhook, and external integration boundaries:
- Authentication, authorization, secret, and privacy boundaries:
- Build, test, lint, typecheck, package, and deployment surfaces:
- Runtime configuration, environment variables, and infrastructure assumptions:
- 公开支持声明s and routes code must preserve:
## Ownership Boundaries
- Canonical owners for repeated rules or facts:
- Files or modules that own routing:
- Files or modules that own schemas and validation:
- Files or modules that own generated assets or package output:
- Files or modules that own deployment versioning and release metadata:
## Drift Risks
- Duplicated copy:
- 生成时间 output:
- Manual release steps:
## Update Mode
When this file already exists, merge cautiously. Preserve reviewed architecture, user preferences, customizations, coding standards, source evidence, checksums, deployment history, and accepted local patterns. Add missing sections or corrected facts with evidence. Record conflicts instead of overwriting silently..uai/constraints.uai
---
uai: "1.0"
type: constraints
status: draft
---
# Constraints
## Hard Rules
- Do not expose secrets, credentials, private keys, tokens, customer data, or unreleased private material.
- Do not use destructive filesystem, database, production, or git operations unless explicitly approved.
- Do not widen support, certification, security, compliance, compatibility, or endorsement claims without evidence.
- Treat wiki notes, generated answers, dropped files, and old chats as background until promoted..uai/operations.uai
---
uai: "1.0"
type: operations
status: draft
---
# Operations
## Normal Workflow
1. Load AI 记忆 files.
2. Inspect relevant code or docs.
3. Make narrow changes.
4. Run targeted checks.
5. Update memory when project truth changes.
## 发布版本 Workflow
- Package command:
- Smoke test:
- Rollback:.uai/test-plan.uai
---
uai: "1.0"
type: test-plan
status: draft
---
# Test Plan
## 默认 Rule
Run targeted checks for the files, routes, records, or behavior changed. Reserve full release sweeps for package builds, release candidates, broad launch-surface changes, migrations, or explicit human requests.
## If A 检查 Cannot Run
State the command, why it could not run, and what risk remains..uai/style.uai
---
uai: "1.0"
type: style
status: draft
---
# Style
## Writing
- Be concrete and current.
- Separate current support from planned work.
- Prefer explicit links to source truth.
## Code
- Follow existing project patterns.
- Keep edits scoped.
- Avoid abstractions unless they reduce real drift or complexity..uai/coding-standards.uai
---
uai: "1.0"
type: coding-standards
status: draft
---
# Coding Standards
This file is required for code-capable 项目交接 setup. Read it before code changes, and keep it aligned with the target codebase rather than generic preference alone.
## Codebase Reflection
- Inspect the codebase before drafting or changing standards.
- Identify the good parts already present: naming, layout, shared helpers, test style, validation, build commands, deployment flow, security boundaries, and owner preferences.
- Preserve those good parts as the first source of project-specific standards.
- Initial install must populate this file from visible evidence rather than leaving generic placeholders when facts are discoverable. Inspect AGENTS.md, existing .uai files, package manifests, source layout, framework config, route/API/schema owners, tests, CI, build/deploy scripts, release notes, public support surfaces, and owner instructions.
- If the project is new, create an initial standard from the selected language, framework, package manager, test runner, deployment target, security surface, review posture, and owner instructions. Use selected-stack industry standards where local code is sparse.
- Proof-of-concept standards should stay reversible and avoid production claims. Enterprise or production-facing standards should explicitly cover ownership, tests, security/privacy, CI/CD, observability, review gates, deployment, rollback, and documentation.
- Update mode must preserve existing reviewed facts, user preferences, customizations, coding standards, source evidence, and accepted local patterns; add missing or corrected sections with evidence instead of replacing the file wholesale.
## Required 默认s
- Prefer DRY design and do not repeat yourself when a shared helper, registry, template, fixture, or typed record can remove real duplication.
- Apply "once and only once": each business rule, route definition, schema shape, version value, support claim, validation rule, and deployment fact should have one canonical owner whenever practical.
- Apply SOLID principles by default: single-purpose units, extension without risky rewrites, substitutable contracts, narrow interfaces, and dependency direction that keeps policy decoupled from implementation details.
- Keep changes scoped, reversible, and aligned with existing architecture.
- Use structured APIs, parsers, and framework helpers instead of brittle string manipulation when available.
## Automated Testing
Automated testing is required no matter what language or framework the project uses. Record unit, integration, smoke, lint, type, format, route, package, or deployment checks in `.uai/test-plan.uai`.
For each code change, run targeted automated checks for the touched behavior. If no harness exists, create or document the smallest repeatable automated check before relying on manual verification. If a check cannot run, record the command, reason, and residual risk..uai/decisions.uai
---
uai: "1.0"
type: decisions
status: draft
---
# Decisions
Record accepted decisions, why they were made, and what would cause a reversal..uai/memory.uai
---
uai: "1.0"
type: memory
status: draft
---
# AI 记忆
AI 记忆 is durable, reviewable context that lets a future AI continue useful work without relying on private chat history.
## 数据包 Configuration
- 数据包: 项目交接
- Use case: 当下一个参与者必须安全地接管项目并且需要当前状态、约束、决策、检查和所有权上下文时使用。
- 信任 boundary: 可以是内部或外部的,但外部移交必须在共享之前经过清理和批准。
## UAI AI 记忆 And LLM Wiki
Use UAI AI 记忆 for compact, portable working packets. Use an LLM Wiki, NeuralWikis, AIWikis, docs, databases, or another durable system for deep, long-lived searchable memory.
Split Memory Architecture: keep hot `.uai` files active as compact short-term, startup, handoff, emergency-continuity, and operational memory. Durable memory augments `.uai`; it does not replace startup `.uai` memory or make `.uai` emergency-only after durable readback succeeds.
## Promotion Rule
1. Capture raw knowledge in notes, wiki pages, or source documents.
2. Review for accuracy, ownership, privacy, and support boundaries.
3. 提升 accepted project truth into AI 记忆, canonical docs, code, tests, release notes, or roadmap state.
4. Keep unreviewed material out of governing instructions.
5. Do not stop consulting active `.uai` files because a long-term memory plane exists..uai/next-recursive-prompt.uai
{
"uai_version": "1.0",
"profile": "uaix.next-recursive-prompt.v1",
"schema_version": 1,
"scope": {
"scope_id": "{{PACKAGE_SLUG}}",
"scope_path": ".",
"local_uai_root": ".uai/",
"code_scope": true,
"scope_basis": ["code", "automation", "executable-workflow", "code-like-artifact"],
"requirement_rule": "Required for agents that deal with code, automation, executable workflows, or code-like artifacts: next-recursive-prompt.uai.",
"out_of_scope_rule": "Out of scope for agents with no code, automation, executable workflow, or code-like artifacts: next-recursive-prompt.uai.",
"source_boundary": "Derived from authoritative package files. This record is not a second source of truth."
},
"lifecycle": {
"status": "active",
"review_state": "current until superseded by accepted work or human review",
"hot_memory_date_policy": "no dates, timestamps, dated headings, chronological sections, or date-stamped package filenames in this active file",
"attempt": 1,
"supersedes_checksum": ""
},
"activation_policy": {
"activation_rule": "Use the stored next_loop plan when the user indicates continuation or resume intent, including keep going, continue, do the next thing, resume, proceed, or use the next recursive prompt.",
"relevance_review_rule": "When a new user request directly relates to the stored next_loop, review this file for useful plan ideas before discarding or superseding it.",
"intake_precedence_rule": "For packages using 代理文件交接, active Content or Improvement files that relate to the current prompt supersede or expand the stored next_loop. Intake must still lead to concrete project work, hot-memory update, ledger evidence, configured durable-memory preservation, and source-site removal before completion; retained files are unfinished human-hold or blocker states.",
"current_instruction_rule": "When the user provides a specific unrelated instruction, current user instruction governs the turn and overwrites the stored next-loop plan.",
"regeneration_rule": "After accepted work, update authoritative .uai records first, then regenerate .uai/next-recursive-prompt.uai from those records.",
"next_prompt_visibility_rule": "At the end of accepted work, show a prominent, sectioned, detailed suggested next prompt to the human in chat so they can review, modify, replace, or simply answer keep going. The prompt must be a standalone, copy-paste-ready handoff and must include literal Feature/improvement focus, Code/source changes, and Automated tests/checks sections, plus context, objective, scope, hard boundaries, work items, expected touchpoints, files to review, done criteria, and final response contract. It must identify a concrete next feature, bug fix, improvement, test/check addition, package/publication step, or explicit no-op/source-validation-only stop condition. Validation-only or no-source-change work must be labeled no-op/source-validation only, and the Code/source changes section must say no code/source changes plus the reason.",
"goal_prompt_visibility_rule": "Use goal wording and functionality only when the current work was started from /goal, the human explicitly asked for /goal or a goal prompt, or the last accepted handoff was goal-shaped. Selecting Follow Goals support as an available runtime export does not by itself convert ordinary continuation into /goal. For true goal-origin continuation, label it Suggested 下一步 /goal Prompt, make the first copy-paste line start with /goal, include Goal, Success criteria, Constraints or hard boundaries, Verification, and still include literal Feature/improvement focus, Code/source changes, and Automated tests/checks sections with concrete next work or an explicit no-op/source-validation stop condition.",
"non_activation_examples": ["A new unrelated feature request.", "A direct request to inspect, test, deploy, or explain a different target.", "A human correction that changes the work objective."]
},
"objective": {
"task_id": "{TASK_ID}",
"summary": "{CURRENT_GOAL}",
"priority": "{PRIORITY}",
"done_criteria": ["{SUCCESS_EVIDENCE}", "Authoritative .uai records are updated before this derived file is regenerated.", "No secrets, raw traces, or unreviewed cold-memory claims are copied into hot memory."]
},
"authoritative_refs": {
"agents_md": "AGENTS.md",
"readme_human": ".uai/readme.human",
"memory_maintenance": ".uai/memory-maintenance.uai",
"identity": ".uai/identity.uai",
"world_context": ".uai/world-context.uai",
"startup_memory_suite": ".uai/",
"active_suite_read_order": ".uai/startup-packet.uai",
"startup_packet": ".uai/startup-packet.uai",
"system_profile": ".uai/system-profile.uai",
"receiver_brief": ".uai/receiver-brief.uai",
"coding_standards": ".uai/coding-standards.uai",
"stack": ".uai/stack.uai",
"architecture": ".uai/architecture.uai",
"context": ".uai/context.uai",
"constraints": ".uai/constraints.uai",
"progress": ".uai/progress.uai",
"decisions": ".uai/decisions.uai",
"next_actions": ".uai/next-actions.uai",
"test_plan": ".uai/test-plan.uai",
"manifest": ".uai/exports/manifest.json"
},
"resume_context": {
"current_truth_summary": ["Use the active .uai/ startup suite for current truth; .uai/startup-packet.uai is the read-order index.", "Do not create or load a single catch-all active memory file in place of typed .uai records.", "Use this file only to resume the next loop quickly after authoritative memory has been read.", "If this summary conflicts with authoritative refs, stop and regenerate this file from those refs."],
"recent_changes": [],
"active_blockers": [],
"why_now": "A code-bearing package needs a compact next-loop resume artifact after authoritative files have been loaded."
},
"human_visible_plan": {
"display_rule": "Show this plan prominently to the human in chat or review UI when the next-recursive prompt is generated, updated, or requested. Use literal section headings for context/objective, work items, Feature/improvement focus, Code/source changes, Automated tests/checks, files, done criteria, and final-response requirements. The chat version must be a standalone, prompt-shaped handoff block; it may shorten low-value repetition only when it remains copy-paste-ready and preserves those three required sections with actionable detail. It must identify a concrete next feature, bug fix, improvement, test/check addition, package/publication step, or explicit no-op/source-validation-only stop condition. Validation-only or no-source-change work must be labeled no-op/source-validation only, and the Code/source changes section must say no code/source changes plus the reason. Do not hide the next loop only inside JSON, point to a file instead of showing the key sections, replace it with a generic validation loop, checklist-only outline, or vague keep-going sentence.",
"editable_by_human": true,
"next_detailed_suggested_prompt": "Continue this UAIX 项目交接.\n\nContext: load authoritative .uai records first, then inspect the visible repository or environment.\nObjective: complete the first concrete 项目交接 setup improvement: populate missing .uai values from evidence, verify architecture.uai exists for code-bearing scope, add or update the mapped automated check, update memory, and report blockers.\n下一步 action type: setup-completion improvement unless visible evidence proves there is no drift; in that case report no-op/source-validation only with the stop condition.\nGoal-mode continuation: not selected in this example. Use Suggested 下一步 Prompt for ordinary prompt work; selecting Follow Goals support only creates runtime export material. Switch the visible continuation to Suggested 下一步 /goal Prompt only when the active work starts from /goal, the human explicitly asks for /goal or a goal prompt, or the last accepted handoff was goal-shaped.\nScope: use AGENTS.md, .uai/memory-maintenance.uai, .uai/system-profile.uai, .uai/architecture.uai, .uai/coding-standards.uai, .uai/test-plan.uai, .uai/exports/manifest.json, and current user instructions.\nHard boundaries: current user instruction wins; do not overwrite existing memory silently; do not modify Totem, Taboo, or Talisman without exact human artifact-and-operation authorization; do not claim hosted import, automatic repo writes, sync, certification, endorsement, SDK, or CLI behavior.\n\nWork items:\n1. Verify the generated file set - Confirm required .uai files exist for the declared scope, including architecture.uai for code-bearing packages. Expected output: missing required files are created or a blocker is recorded before broad work.\n2. Populate .uai values from visible evidence - Replace placeholders with facts from source layout, manifests, tests, CI, deploy docs, routes, schemas, owner instructions, or write not available - reason. Expected output: every placeholder is evidence-backed or marked not available - reason.\n3. Decide fresh setup versus additive update - Preserve reviewed facts and merge cautiously when existing memory is present. Expected output: the agent records fresh install or update mode and changed .uai files.\n4. Map codebase, architecture, and checks - Fill architecture, stack, coding standards, and test plan before coding. Expected output: architecture, stack, coding standards, and test plan name concrete files, commands, owners, and risks.\n5. Name the actionable next slice or declare no-op - State whether the next prompt is asking for a concrete feature, bug fix, improvement, test/check addition, package/publication step, or no-op/source-validation pass. Expected output: the human can tell what will be added, fixed, improved, tested, packaged, published, or deliberately not changed.\n\nFeature/improvement focus:\n- Fix vague next-prompt handoffs by naming the concrete feature, bug fix, improvement, or test/check addition that the next agent should perform, or by declaring no-op/source-validation only with a stop condition.\n- Make the handoff clear enough for the human to review and edit next action.\n- Keep generated ZIP, file deck, manifest, and live preview aligned.\n\nCode/source changes:\n- Preserve existing local patterns, DRY ownership, once-and-only-once facts, SOLID defaults, and framework-native APIs before editing code.\n- If this is validation-only or no source patch is needed, explicitly say no-op/source-validation only and give the reason.\n\nExpected touchpoints: review the files and package/runtime surfaces listed below before deciding the next action.\nFiles to review:\n- AGENTS.md\n- .uai/memory-maintenance.uai\n- .uai/system-profile.uai\n- .uai/architecture.uai\n- .uai/coding-standards.uai\n- .uai/test-plan.uai\n- .uai/exports/manifest.json\n- .uai/next-recursive-prompt.uai\n\nTargeted checks: run the automated tests/checks below and add environment-specific checks for touched behavior.\nAutomated tests/checks:\n- Add or update a focused regression check when the next prompt contract changes; otherwise record no-op/source-validation only with the exact no-drift evidence.\n- Parse JSON 导出s that changed.\n- Run targeted checks for touched code, docs, routes, package files, or memory records.\n- Record skipped checks with exact reason and residual risk.\n\nDone criteria:\n- Required .uai files exist for the declared scope.\n- Initial values are populated from visible evidence or marked not available - reason.\n- Existing memory was preserved or conflicts were recorded.\n- Targeted checks ran or skipped checks are explained.\n- A prominent sectioned next prompt is shown to the human, not only stored in the file or compressed into a tiny paragraph.\n- The Suggested 下一步 Prompt states a concrete next feature, bug fix, improvement, test/check addition, package/publication step, or explicit no-op/source-validation-only stop condition.\n- Validation-only or no-source-change results are labeled no-op/source-validation only and still include substantive Feature/improvement focus, Code/source changes, and Automated tests/checks sections.\n\nFinal response must include:\n- Changed files or explicit no-op/source-validation-only evidence.\n- Tests run plus skipped checks with reasons and residual risk.\n- Blockers, support-boundary risks, and publication/package status.\n- Memory records updated or why no memory update was needed.\n- Feature/improvement focus, Code/source changes, and Automated tests/checks sections with content; if no source patch was made, Code/source changes says no code/source changes and why.\n- A prominent Suggested 下一步 Prompt section containing a copy-paste-ready prompt, not just labels. It must include literal sections named Feature/improvement focus, Code/source changes, and Automated tests/checks, plus context/objective, done criteria, and source/package/live boundaries. It must name a concrete next feature, bug fix, improvement, test/check addition, package/publication step, or explicitly say no-op/source-validation only with a stop condition; a file reference, tiny footer, generic validation loop, or checklist-only outline is non-compliant.",
"work_items": [
{"id": "verify-file-set", "title": "Verify the generated file set", "detail": "Confirm required .uai files exist for the declared scope, including architecture.uai for code-bearing packages."},
{"id": "populate-visible-values", "title": "Populate .uai values from visible evidence", "detail": "Replace placeholders with facts from source layout, manifests, tests, CI, deploy docs, routes, schemas, owner instructions, or write not available - reason."},
{"id": "choose-fresh-or-update-mode", "title": "Decide fresh setup versus additive update", "detail": "Preserve reviewed facts and merge cautiously when existing memory is present."},
{"id": "map-codebase", "title": "Map codebase, architecture, and checks", "detail": "Fill architecture, stack, coding standards, and test plan before coding."}
],
"feature_changes": ["Make the handoff prominent and sectioned enough for the human to review and edit next action.", "Keep generated ZIP, file deck, manifest, and live preview aligned."],
"code_changes": ["Preserve existing local patterns, DRY ownership, once-and-only-once facts, SOLID defaults, and framework-native APIs before editing code."],
"test_plan": ["Parse JSON 导出s that changed.", "Run targeted checks for touched code, docs, routes, package files, or memory records.", "Record skipped checks with exact reason and residual risk."],
"files_to_review": ["AGENTS.md", ".uai/memory-maintenance.uai", ".uai/system-profile.uai", ".uai/architecture.uai", ".uai/coding-standards.uai", ".uai/test-plan.uai", ".uai/exports/manifest.json", ".uai/next-recursive-prompt.uai"],
"done_criteria": ["Required .uai files exist for the declared scope.", "Initial values are populated from visible evidence or marked not available - reason.", "Existing memory was preserved or conflicts were recorded.", "Targeted checks ran or skipped checks are explained.", "A prominent sectioned next prompt is shown to the human, not only stored in the file or compressed into a tiny paragraph.", "The final response includes a standalone, prompt-shaped Suggested 下一步 Prompt block with enough detail for another agent to act without opening hidden memory; it may shorten low-value repetition only when all required sections remain present.", "The Suggested 下一步 Prompt states a concrete next feature, bug fix, improvement, test/check addition, package/publication step, or explicit no-op/source-validation-only stop condition.", "Validation-only or no-source-change results are labeled no-op/source-validation only and still include substantive Feature/improvement focus, Code/source changes, and Automated tests/checks sections."],
"final_response_must_include": ["Changed files or explicit no-op/source-validation-only evidence.", "Tests run plus skipped checks with reasons and residual risk.", "Blockers, support-boundary risks, and publication/package status.", "Memory records updated or why no memory update was needed.", "Feature/improvement focus, Code/source changes, and Automated tests/checks sections with content; if no source patch was made, Code/source changes says no code/source changes and why.", "A prominent Suggested 下一步 Prompt section containing a copy-paste-ready prompt, not just labels. It must include literal sections named Feature/improvement focus, Code/source changes, and Automated tests/checks, plus context/objective, done criteria, and source/package/live boundaries. It must name a concrete next feature, bug fix, improvement, test/check addition, package/publication step, or explicitly say no-op/source-validation only with a stop condition; a file reference, tiny footer, generic validation loop, or checklist-only outline is non-compliant."]
},
"next_loop": {
"mode": "implement-then-verify",
"first_response_contract": {
"must_report": ["loaded context", "hard constraints", "expected touchpoints", "targeted checks"],
"max_bullets": 6
},
"final_response_contract": {
"must_include": ["Changed files or explicit no-op/source-validation-only evidence.", "Tests run plus skipped checks with reasons and residual risk.", "Blockers, support-boundary risks, and publication/package status.", "Memory records updated or why no memory update was needed.", "Feature/improvement focus, Code/source changes, and Automated tests/checks sections with content; if no source patch was made, Code/source changes says no code/source changes and why.", "A prominent Suggested 下一步 Prompt section containing a copy-paste-ready prompt, not just labels. It must include literal sections named Feature/improvement focus, Code/source changes, and Automated tests/checks, plus context/objective, done criteria, and source/package/live boundaries. It must name a concrete next feature, bug fix, improvement, test/check addition, package/publication step, or explicitly say no-op/source-validation only with a stop condition; a file reference, tiny footer, generic validation loop, or checklist-only outline is non-compliant.", "Suggested 下一步 /goal Prompt with a leading /goal line and Goal / Success criteria / Constraints / Verification wording only when the active work started from /goal, the human explicitly requested a goal prompt, or the last accepted handoff was goal-shaped."],
"next_detailed_suggested_prompt_requirements": ["context", "objective", "scope", "hard boundaries", "work items", "Feature/improvement focus", "concrete feature, bug fix, improvement, test/check addition, package/publication step, or no-op/source-validation stop condition", "code/source changes", "expected touchpoints", "files to review", "targeted checks", "Automated tests/checks", "done criteria", "final response contract", "Suggested 下一步 /goal Prompt with a leading /goal line only when the active work started from /goal, the human explicitly requested a goal prompt, or the last accepted handoff was goal-shaped"],
"user_choice": "The human can edit the prompt, replace it, or answer keep going."
},
"prompt": "Continue this UAIX 项目交接.\n\nContext: load authoritative .uai records first, then inspect the visible repository or environment.\nObjective: complete the first concrete 项目交接 setup improvement: populate missing .uai values from evidence, verify architecture.uai exists for code-bearing scope, add or update the mapped automated check, update memory, and report blockers.\n下一步 action type: setup-completion improvement unless visible evidence proves there is no drift; in that case report no-op/source-validation only with the stop condition.\nGoal-mode continuation: not selected in this example. Use Suggested 下一步 Prompt for ordinary prompt work; selecting Follow Goals support only creates runtime export material. Switch the visible continuation to Suggested 下一步 /goal Prompt only when the active work starts from /goal, the human explicitly asks for /goal or a goal prompt, or the last accepted handoff was goal-shaped.\nScope: use AGENTS.md, .uai/memory-maintenance.uai, .uai/system-profile.uai, .uai/architecture.uai, .uai/coding-standards.uai, .uai/test-plan.uai, .uai/exports/manifest.json, and current user instructions.\nHard boundaries: current user instruction wins; do not overwrite existing memory silently; do not modify Totem, Taboo, or Talisman without exact human artifact-and-operation authorization; do not claim hosted import, automatic repo writes, sync, certification, endorsement, SDK, or CLI behavior.\n\nWork items:\n1. Verify the generated file set - Confirm required .uai files exist for the declared scope, including architecture.uai for code-bearing packages. Expected output: missing required files are created or a blocker is recorded before broad work.\n2. Populate .uai values from visible evidence - Replace placeholders with facts from source layout, manifests, tests, CI, deploy docs, routes, schemas, owner instructions, or write not available - reason. Expected output: every placeholder is evidence-backed or marked not available - reason.\n3. Decide fresh setup versus additive update - Preserve reviewed facts and merge cautiously when existing memory is present. Expected output: the agent records fresh install or update mode and changed .uai files.\n4. Map codebase, architecture, and checks - Fill architecture, stack, coding standards, and test plan before coding. Expected output: architecture, stack, coding standards, and test plan name concrete files, commands, owners, and risks.\n5. Name the actionable next slice or declare no-op - State whether the next prompt is asking for a concrete feature, bug fix, improvement, test/check addition, package/publication step, or no-op/source-validation pass. Expected output: the human can tell what will be added, fixed, improved, tested, packaged, published, or deliberately not changed.\n\nFeature/improvement focus:\n- Fix vague next-prompt handoffs by naming the concrete feature, bug fix, improvement, or test/check addition that the next agent should perform, or by declaring no-op/source-validation only with a stop condition.\n- Make the handoff clear enough for the human to review and edit next action.\n- Keep generated ZIP, file deck, manifest, and live preview aligned.\n\nCode/source changes:\n- Preserve existing local patterns, DRY ownership, once-and-only-once facts, SOLID defaults, and framework-native APIs before editing code.\n- If this is validation-only or no source patch is needed, explicitly say no-op/source-validation only and give the reason.\n\nExpected touchpoints: review the files and package/runtime surfaces listed below before deciding the next action.\nFiles to review:\n- AGENTS.md\n- .uai/memory-maintenance.uai\n- .uai/system-profile.uai\n- .uai/architecture.uai\n- .uai/coding-standards.uai\n- .uai/test-plan.uai\n- .uai/exports/manifest.json\n- .uai/next-recursive-prompt.uai\n\nTargeted checks: run the automated tests/checks below and add environment-specific checks for touched behavior.\nAutomated tests/checks:\n- Add or update a focused regression check when the next prompt contract changes; otherwise record no-op/source-validation only with the exact no-drift evidence.\n- Parse JSON 导出s that changed.\n- Run targeted checks for touched code, docs, routes, package files, or memory records.\n- Record skipped checks with exact reason and residual risk.\n\nDone criteria:\n- Required .uai files exist for the declared scope.\n- Initial values are populated from visible evidence or marked not available - reason.\n- Existing memory was preserved or conflicts were recorded.\n- Targeted checks ran or skipped checks are explained.\n- A prominent sectioned next prompt is shown to the human, not only stored in the file or compressed into a tiny paragraph.\n- The Suggested 下一步 Prompt states a concrete next feature, bug fix, improvement, test/check addition, package/publication step, or explicit no-op/source-validation-only stop condition.\n- Validation-only or no-source-change results are labeled no-op/source-validation only and still include substantive Feature/improvement focus, Code/source changes, and Automated tests/checks sections.\n\nFinal response must include:\n- Changed files or explicit no-op/source-validation-only evidence.\n- Tests run plus skipped checks with reasons and residual risk.\n- Blockers, support-boundary risks, and publication/package status.\n- Memory records updated or why no memory update was needed.\n- Feature/improvement focus, Code/source changes, and Automated tests/checks sections with content; if no source patch was made, Code/source changes says no code/source changes and why.\n- A prominent Suggested 下一步 Prompt section containing a copy-paste-ready prompt, not just labels. It must include literal sections named Feature/improvement focus, Code/source changes, and Automated tests/checks, plus context/objective, done criteria, and source/package/live boundaries. It must name a concrete next feature, bug fix, improvement, test/check addition, package/publication step, or explicitly say no-op/source-validation only with a stop condition; a file reference, tiny footer, generic validation loop, or checklist-only outline is non-compliant.",
"work_items": [
{"id": "verify-file-set", "title": "Verify the generated file set", "detail": "Confirm required .uai files exist for the declared scope, including architecture.uai for code-bearing packages."},
{"id": "populate-visible-values", "title": "Populate .uai values from visible evidence", "detail": "Replace placeholders with facts from source layout, manifests, tests, CI, deploy docs, routes, schemas, owner instructions, or write not available - reason."},
{"id": "choose-fresh-or-update-mode", "title": "Decide fresh setup versus additive update", "detail": "Preserve reviewed facts and merge cautiously when existing memory is present."},
{"id": "map-codebase", "title": "Map codebase, architecture, and checks", "detail": "Fill architecture, stack, coding standards, and test plan before coding."}
],
"feature_changes": ["Make the handoff prominent and sectioned enough for the human to review and edit next action.", "Keep generated ZIP, file deck, manifest, and live preview aligned."],
"code_changes": ["Preserve existing local patterns, DRY ownership, once-and-only-once facts, SOLID defaults, and framework-native APIs before editing code."],
"test_plan": ["Parse JSON 导出s that changed.", "Run targeted checks for touched code, docs, routes, package files, or memory records.", "Record skipped checks with exact reason and residual risk."],
"files_to_review": ["AGENTS.md", ".uai/memory-maintenance.uai", ".uai/system-profile.uai", ".uai/architecture.uai", ".uai/coding-standards.uai", ".uai/test-plan.uai", ".uai/exports/manifest.json", ".uai/next-recursive-prompt.uai"],
"done_criteria": ["Required .uai files exist for the declared scope.", "Initial values are populated from visible evidence or marked not available - reason.", "Existing memory was preserved or conflicts were recorded.", "Targeted checks ran or skipped checks are explained.", "A prominent sectioned next prompt is shown to the human, not only stored in the file or compressed into a tiny paragraph.", "The final response includes a standalone, prompt-shaped Suggested 下一步 Prompt block with enough detail for another agent to act without opening hidden memory; it may shorten low-value repetition only when all required sections remain present.", "Validation-only or no-source-change results are labeled no-op/source-validation only and still include substantive Feature/improvement focus, Code/source changes, and Automated tests/checks sections."],
"final_response_must_include": ["Changed files or explicit no-op/source-validation-only evidence.", "Tests run plus skipped checks with reasons and residual risk.", "Blockers, support-boundary risks, and publication/package status.", "Memory records updated or why no memory update was needed.", "Feature/improvement focus, Code/source changes, and Automated tests/checks sections with content; if no source patch was made, Code/source changes says no code/source changes and why.", "A prominent Suggested 下一步 Prompt section containing a copy-paste-ready prompt, not just labels. It must include literal sections named Feature/improvement focus, Code/source changes, and Automated tests/checks, plus context/objective, done criteria, and source/package/live boundaries. It must name a concrete next feature, bug fix, improvement, test/check addition, package/publication step, or explicitly say no-op/source-validation only with a stop condition; a file reference, tiny footer, generic validation loop, or checklist-only outline is non-compliant."],
"ordered_steps": [
"Read AGENTS.md and .uai/memory-maintenance.uai before broad memory loading.",
"Read and obey .uai/totem.uai, .uai/taboo.uai, and .uai/talisman.uai before broad execution; do not modify, weaken, replace, delete, or bypass any of those anchors without exact human artifact-and-operation authorization.",
"Read the remaining ordinary .uai files named in authoritative_refs for the declared package scope.",
"Verify .uai/architecture.uai exists for code-bearing scope and populate it from visible source, route, schema, build, test, deployment, and support-claim evidence.",
"Populate new .uai values from what can reasonably be seen in the environment; use not available - reason only when a fact is not visible.",
"When updating existing files, merge cautiously and preserve reviewed local facts instead of replacing them with generated defaults.",
"Review .uai/next-recursive-prompt.uai for relevant ideas when the current request continues, resumes, or directly relates to the stored next loop.",
"When 代理文件交接 is enabled, enumerate active Content 和 Improvement files; related intake supersedes or expands this next loop and must produce project work before configured durable-memory preservation and source-site removal.",
"Verify workspace, identity, world context, memory-maintenance policy, constraints, coding standards, stack, architecture, current state, and test plan.",
"Process active intake before unrelated work when file handoff is enabled.",
"Implement the smallest safe improvement that advances the stated objective.",
"Run targeted automated checks and record skipped checks with reasons.",
"Update `.uai/progress.uai`, the relevant typed active `.uai` records, test plan, and this derived next-recursive prompt.",
"Report changed files, automated tests/checks, blockers, and the next recursive work prompt.",
"End ordinary prompt work with a prominent, sectioned Suggested 下一步 Prompt that the human can review, modify, replace, or answer with keep going. End true /goal work with a prominent, sectioned Suggested 下一步 /goal Prompt whose first copy-paste line starts with /goal and preserves Goal / Success criteria / Constraints / Verification wording. Follow Goals export selection alone is not goal-origin and must not force a /goal continuation. Either form must identify a concrete next feature, bug fix, improvement, test/check addition, package/publication step, or explicit no-op/source-validation-only stop condition and include Feature/improvement focus, Code/source changes, and Automated tests/checks sections. If no source/code patch was made, label the result no-op/source-validation only and make Code/source changes explain no code/source changes plus the reason."
],
"if_blocked": {
"action": "emit-blocked-state",
"required_updates": [".uai/progress.uai", ".uai/next-actions.uai", ".uai/next-recursive-prompt.uai"],
"human_escalation_reason_template": "State the blocker, the safe next step, and the precise approval or evidence needed."
}
},
"checks": {
"required": ["PHP lint for touched PHP files", "JS syntax check for touched browser assets", "JSON/XML parse for touched machine records", "Playwright or rendered-route checks for touched wizard UI when available", "git diff --check"],
"out_of_scope_for_this_scope": [],
"last_known_results": []
},
"writeback_policy": {
"authority_rule": "Derived hot-memory resume artifact; not a second source of truth. Authoritative .uai records win on conflict. Regenerate from authoritative handoff files after meaningful work.",
"must_update_before_success": [".uai/startup-packet.uai", ".uai/progress.uai", ".uai/report-synthesis.uai when report or intake synthesis changes", ".uai/test-plan.uai", ".uai/intake-outcome-ledger.uai when file handoff is enabled", ".uai/next-recursive-prompt.uai"],
"update_decisions_if_changed": ".uai/decisions.uai",
"never_copy_into_hot_files": ["raw traces", "secrets", "private customer data", "large tool logs", "unreviewed cold-memory claims"],
"conflict_rule": "Authoritative .uai records win on conflict. Regenerate this file from authoritative handoff files before using it again."
},
"security": {
"approval_required_for": ["production deploy", "destructive repository operations", "schema boundary changes", "public support-claim widening"],
"no_op_triggers": ["missing_authoritative_ref", "stale_constraints", "integrity_mismatch", "scope_conflict", "conflict_with_human_instruction", "conflict_with_repository_policy"],
"escalation_triggers": ["support boundary would widen", "runtime behavior would be implied", "non-coding package would be made to look code-required", "code-bearing package lacks required coding memory"],
"local_policy_wins": true
},
"cold_memory": {
"refs": []
},
"provenance": {
"trigger": "starter-template",
"generated_by": "UAIX AI 记忆 starter template",
"runtime_id": "",
"issued_at_utc": "{GENERATED_AT_UTC}"
},
"integrity": {
"canonicalization": "canonical-json",
"yaml_mirror_allowed": false,
"checksum": "sha256:{RECEIVER_COMPUTES_AFTER_WRITE}",
"source_digests": [],
"signatures": []
}
}.uai/handoff-brief.uai
# Handoff Brief
## 传输 Context
- What is being transferred:
- From:
- To:
- Effective date:
## Acceptance Criteria
- The recipient can explain current state and constraints.
- Open questions are acknowledged.
- Required checks and next actions are clear.
- 信任-boundary and redaction review is complete.
## Handoff Risks
- Missing context:
- Unsupported claims:
- Sensitive material:
- Production or customer impact:简单语言摘要
OpenAI 正在为人工智能代理构建更好的工作方式。这并不会扼杀项目交接。它改变了项目移交应声明的内容。
项目移交不应试图成为代理运行者。它应该告诉任何代理:这是项目,这是重要的事情,这是更改的内容,这是规则,这是已经做出的决定,这是您必须验证的内容,这是您在没有人的情况下不允许做的事情。
OpenAI 运行这项工作。 UAIX 项目切换保留项目内存。
当前支撑边界
- 本页面发布
AGENTS.md、readme.human和.uai切换模式草案,以供公众审查和早期使用。 - 可见的起始 ZIP 是最新的,是根据规范模板和清单生成的。
- 托管
.uai上传/导入验证、自动存储库写入、自动 LLM Wiki 同步、SDK、CLI、认证和认可支持仍在计划中,直到存在公共工具、测试样例、验证行为和发布证据。 - 不要仅仅因为某个项目使用
AGENTS.md、readme.human或.uai文件而将其描述为经过 UAIX 认证或认可。 - 当移交成为公开发布证据时,请附上相关的验证器结果,一致性包证据,实施轨道记录,以及变更日志入口。
相关记录
- 将项目切换与 OpenAI 代理和 Codex 结合使用使用便携式存储库来种子以 OpenAI 为中心的工作流程。
- 将项目移交与编码代理结合使用让 Codex、Claude Code、Cursor、Copilot 和 Gemini Code Assist 保持相同的本地切换事实。
- 项目移交上下文预算保持 AGENTS.md、 .uai/readme.human 和 .uai 文件紧凑,同时将长期历史记录移至冷内存。
- 代理文件交接在进行广泛的工作之前,让删除的文件可见、经过审查和处置。
- AGENTS.md .uai 链接规范读取链接语法、加载器行为和记录形状背景。
- 路线图检查当前与计划的适配器、验证器、架构、SDK、CLI 和认证边界。
长时间运行的工作
对于扩展或可中断的目标,请使用长期目标执行。 FollowGoals 携带运行时目标;权威的 .uai 文件带有持久的检查点; UAI-1 任务状态、阻止程序、切换、内存建议和最终报告数据包携带便携式证据。运行时输出在经过审查和写回之前不会被接受到内存中。