一个项目一个文件夹，里面是 Markdown。人读它，agent 也读它。
目录长这样
projects/
└── lutpul/
├── README.md
├── issues/
│ ├── 001-window-shadow.md
│ └── 002-mobile-icons.md
└── notes/
一条 issue
---
title: 窗口阴影偏了一像素
status: open
owner: me
---
在 1.5 倍缩放下，右下角的投影压住了边框。
agent 改的是同一批文件，所以它不需要额外的接口，也不需要同步；git diff 就是进度。