Files
lpt-meta/.agents/roles/workspace-layout.md
T

1.5 KiB

工作区资产归属

  • 功能:规定各类文档与产物放在哪个仓库/目录,避免重复、错位与正文复制。
  • 何时用:新增或修改文档时;决定某段说明该写进哪个仓库时;处理优化清单时;判断某个文件是否该出现在 meta 仓库时;放规则或技能时。

规则

文档归属

  • 所有系统文档统一在 lpt-docs 仓库维护,代码仓库不保留 README、docs/ 等文档文件。
  • lpt-docs 只维护系统概念描述和设计思路,不保存开发记录、系统中间态和开发过程产物。
  • 跨仓库的实现优化清单记录在 meta 仓库 OPTIMIZATION_BACKLOG.md(只放待办、依据与验收标准);概念与设计仍归 lpt-docs。
  • 修改 lpt-docs 后,如需在 meta 仓库补充说明,保持 meta 仓库不复制文档正文。

meta 仓库的维护边界

  • 本 meta 仓库只维护 AGENTS.md、.gitignore、.agents/(代理技能与通用规则)和 docs/diagrams/(图表评审产物),不要在本仓库根目录创建业务代码或系统文档。
  • .gitignore 忽略所有子项目目录,只放行上述根级条目,避免把独立 Git 仓库提交进本 meta 仓库。

规则与技能的落位

  • 通用规则(跨仓库)→ meta 仓库 .agents/roles/。
  • 项目专属规则 → 该仓库自己的 roles/。
  • 工作区级技能 → .agents/skills/<技能名>/;子项目专属技能 → 该仓库 skills/。