# Issue tracker: Local Markdown

本仓库的任务与规格存放在 `.scratch/`。

## 文件约定

- 每个功能一个目录：`.scratch/<feature-slug>/`。
- 规格：`.scratch/<feature-slug>/spec.md`。
- 实现任务：`.scratch/<feature-slug>/issues/<NN>-<slug>.md`，
  从 `01` 编号，每个任务独立一个文件。
- 分诊状态记录在任务文件顶部附近的 `Status:` 行，
  取值参见 `triage-labels.md`。
- 评论与讨论历史追加在文件底部的 `## Comments` 下。

## 发布与读取

技能要求“发布到 issue tracker”时，在上述约定路径创建文件，
按需创建目录。

技能要求“获取相关 ticket”时，读取用户指定路径；
若只提供编号，则在对应功能的 issues 目录中定位文件。
编号存在歧义时，先确认所属功能。

## Wayfinding

以下约定供 `/wayfinder` 使用：

- 总览：`.scratch/<effort>/map.md`，
  包含 Notes、Decisions-so-far 和 Fog。
- 子任务：`.scratch/<effort>/issues/NN-<slug>.md`，
  从 `01` 编号，正文记录待解决问题。
- `Type:` 取值为 research、prototype、grilling 或 task。
- Wayfinding 使用独立的工作状态：
  `Status: open`、`Status: claimed`、`Status: resolved`。
- 依赖记录为 `Blocked by: NN, NN`；
  所有依赖均 resolved 后，任务才解除阻塞。
- 下一个任务：按编号选择 open 且未被阻塞的任务。
- 领取：开始工作前写入 `Status: claimed`。
- 完成：在 `## Answer` 下追加答案，写入 `Status: resolved`，
  并向 map.md 的 Decisions-so-far 追加摘要和任务链接。