文件空间布局

沿用 LemonBoss 现有「company-scoped 文件根」。所有 DevLoop 项目落在 data/companies/{cid}/projects/{pid}/ 下，与已有 conversations/ / memory/ 并列。

全景目录树

data/
└── companies/
    └── {cid}/
        ├── agents/{agentId}/             # 复用：现有 agent 沙箱
        ├── conversations/                # 复用
        ├── memory/                       # 复用根
        │   └── devloop/                  # NEW · DevLoop Agent 跨项目长期记忆 (M-11)
        │       ├── pm/{topic}.md
        │       ├── architect/{topic}.md
        │       ├── coder/{topic}.md
        │       └── ...
        └── projects/                     # NEW · LoopController 根
            └── {pid}/
                ├── .git/                     # NEW · per-project git repo (见 arch-git-versioning)
                ├── .gitignore                # NEW · 排除 agent-state · history · stream.log · runs stdout
                ├── project.json              # 项目元数据 (M-1)
                ├── prd/                      # NEW · PM 写的多页 PRD 站点 (M-3)
                │   ├── index.html
                │   ├── reading-guide.html
                │   ├── assets/{shell.css, shell.js, search-index.json}
                │   ├── product/{background, personas, original-req, scope, success-metrics, glossary}.html
                │   ├── feature/feature-tree.html
                │   ├── flow/user-flows.html
                │   └── prototype/proto-{viewName}.html
                ├── sdd/                      # NEW · Architect 写的多页 SDD 站点 (M-4) · 待 Phase 3 详定
                │   ├── index.html
                │   ├── assets/{shell.css, shell.js, search-index.json}
                │   └── mvcp/{model, view, control, process}.html
                ├── units.json                # Architect 字段 + UnitRegistry status (M-2)
                ├── timeline.ndjson           # 全流程统一日志 append-only (M-13)
                ├── bugs.ndjson               # NEW · 跨 run bug 台账 (M-14)
                ├── changelog.ndjson          # NEW · 版本变更流 (M-15)
                ├── agent-state/              # NEW · Agent 持久化运行态
                │   ├── pm.json               # M-10 AgentRuntimeState
                │   ├── pm-todo.json          # M-12 AgentTodolist
                │   ├── architect.json
                │   ├── architect-todo.json
                │   ├── coder.json            # 单 agent 同时只跑一个 unit
                │   ├── coder-todo.json
                │   ├── ... (tester, integrator, bug-triager)
                │   └── snapshots/            # 输入/输出快照,call_id 索引
                │       ├── {call_id}-in.json
                │       └── {call_id}-out.json
                ├── history/                  # 全部 rev 归档
                │   ├── prd-rev-001.html
                │   ├── prd-rev-002.html
                │   ├── sdd-rev-001.html
                │   └── units-rev-001.json
                ├── units/
                │   ├── auth-be/
                │   │   ├── spec.json
                │   │   ├── code/             # Coder 输出
                │   │   │   ├── server.js
                │   │   │   ├── auth-service.js
                │   │   │   └── ...
                │   │   ├── tests/            # Tester 输出
                │   │   │   └── login.spec.ts
                │   │   ├── contract.json     # Coder 写
                │   │   ├── coder.log         # Coder 自己的决策日志
                │   │   └── runs/
                │   │       └── {runId}/
                │   │           ├── result.json
                │   │           └── stdout.txt
                │   ├── auth-fe/...
                │   └── profile-be/...
                ├── integration/
                │   ├── spec.json             # Architect 写
                │   └── runs/
                │       └── {runId}/
                │           ├── result.json   # Integrator 写
                │           ├── triage.json   # BugTriager 写
                │           └── process.log
                └── stream.log                # SSE 客户端视角日志 (7 天滚动)

红 = 新增目录 · 灰 = 已存在并复用

命名规则

占位符	格式	示例
{cid}	company id (UUID)	c-lemonv-001
{pid}	p- + 时间戳后 6 位	p-731042
{unitId}	{feature}-{type}	auth-be · profile-fe
{runId}	run-{YYYYMMDD-HHMM}	run-20260513-0731
L2 runId	run-int-{YYYYMMDD-HHMM}	run-int-20260513-1031

沙箱边界（写白名单）

Agent	cwd	可写路径
PM	projects/{pid}/	prd.html · history/prd-*
Architect	projects/{pid}/	sdd.html · units.json (字段) · integration/spec.json · history/sdd-* · history/units-*
Coder	projects/{pid}/units/{unitId}/	code/** · contract.json · coder.log
Tester	projects/{pid}/units/{unitId}/	tests/** · runs/{runId}/**
Integrator	projects/{pid}/	integration/runs/{runId}/**
BugTriager	projects/{pid}/	integration/runs/{runId}/triage.json

沙箱由 Claude CLI 的 cli.sandbox.writeAllowList 配置强制执行；越权写直接被工具层拒绝。

磁盘占用估算

项目规模	Unit 数	典型大小
小	3-5	~5 MB（含日志）
中	10-20	~30 MB
大	50+	~150 MB

主要开销在 runs/*/stdout.txt（每次 vitest 完整输出）。如需节省，启用 project.json.compressOldRuns: true 自动 gzip 14 天前的 run 目录。

多项目共享

同一 company 下不同项目之间默认隔离。如需共享代码（如公共 utils），约定：

• 在 companies/{cid}/shared/ 放置共享库
• Unit spec 通过 spec.shared_deps: ["@shared/utils"] 显式声明
• Coder 沙箱里 shared/ 是只读挂载，Coder 不能改

P1~P4 不实现 shared，留给 P5 视实际需要再加。