Workspace Organization

从创建任务材料开始保持工作区清晰，让当前任务和历史材料可查找、可恢复；沿用工作区和项目已有约定，不强制统一目录。

默认工作区布局

没有既定项目约定时，新材料按以下职责组织；目录按需创建，已有路径和运行时所需目录保留原位：

<workspace>/
  AGENTS.md                工作规则
  MEMORY.md                恢复入口及索引
  notes/                   跨任务的知识和决策
  tasks/<主题>/record.md   任务状态、决定、验证与产物位置
  tasks/<主题>/runs/       重复运行的产物，按需分批
  scripts/                 确实被多个任务复用的工具
  worktrees/               项目未指定位置时的工作副本

单个任务的计划、报告、脚本和验证材料放在其任务位置，不为每种材料新建根目录。.raft/、.slock/、.agents/、.codex/、.claude/ 等运行时和技能目录由相应环境维护，整理时保留；已有工作规则文件同样保留，环境兼容设置由维护人员处理。

日常放置与收尾

• 一件事的材料放在同一位置。先查项目规则及已有任务位置；新建时可用编号或主题命名，例如 tasks/jobs-plan/，相关任务、issue 和 PR 记入任务记录。已有可识别路径不因命名不同而改名。
• 有持续材料时创建 record.md，记录目标、状态、决定和产物位置；小任务只写必要内容。验证、日志和临时产物按需放置，不预建空目录；重复运行按需分批并记录保留要求。大产物放在已核实有权限且适用的位置，代码使用项目指定的工作副本，均记录路径。
• 状态或位置变化时更新 MEMORY.md：保留角色、必要约束、知识索引，以及进行中任务的状态、路径和下一步；细节放在任务记录。保持简短，但不遗漏恢复所需的信息。可按需参考 记忆与任务记录模板。
• 修改已发布内容前读取远端正文，保留他人新增内容；本地底稿按用途和保留要求处理，保留必要的原文备份与交付证据。
• 完成后更新状态，任务材料优先保留原位。记录结果、证据路径与未完成事项，从进行中列表移除并保留必要历史指针。归档和清理前核实权限、保留要求及路径依赖；活动路径、运行文件、未提交工作区、仍被使用的文件和凭据保持原位。

盘点与规划

• 确认范围、所有权、允许的操作和适用规则。区分进行中任务、待验收代码、已完成但仍需保留的证据、可再生成的临时文件和用途不明的内容；记录与任务或 issue 的关联。不要把历史状态当成当前授权或运行状态。
• 优先为已有材料补充 MEMORY.md 或已有索引：写清任务、当前状态、关键决策和指向材料的路径；新任务按已有习惯分组，避免重复复制。活跃工作、运行文件、未提交 worktree 和外部依赖文件优先保持原位。
• 只删除经核实无用且在授权范围内的文件；自己创建的临时文件在确认不再使用、无需保留且无其他依赖后可按任务权限清理，并简记范围。其他人的文件或归属、用途不明的内容先保留并确认；用户数据、凭据和交付证据不按临时文件处理。不得把凭据值写入索引、日志、报告或备份，保存验证输出前检查并脱敏；不擅自移动、复制、上传密钥或改变权限。

引用检查与安全迁移

迁移已有材料前，先阅读 引用检查与安全迁移，核对授权、路径依赖和恢复方案；不能确认安全时保留原路径，改用索引。