| 1 | # Issue tracker: Local Markdown |
| 2 | |
| 3 | Issues and PRDs for this repo live as markdown files in `.scratch/`. |
| 4 | |
| 5 | ## Conventions |
| 6 | |
| 7 | - One feature per directory: `.scratch/<feature-slug>/` |
| 8 | - The PRD is `.scratch/<feature-slug>/PRD.md` |
| 9 | - Implementation issues are `.scratch/<feature-slug>/issues/<NN>-<slug>.md`, numbered from `01` |
| 10 | - Triage state is recorded as a `Status:` line near the top of each issue file (see `triage-labels.md` for the role strings) |
| 11 | - Comments and conversation history append to the bottom of the file under a `## Comments` heading |
| 12 | |
| 13 | ## When a skill says "publish to the issue tracker" |
| 14 | |
| 15 | Create a new file under `.scratch/<feature-slug>/` (creating the directory if needed). |
| 16 | |
| 17 | ## When a skill says "fetch the relevant ticket" |
| 18 | |
| 19 | Read the file at the referenced path. The user will normally pass the path or the issue number directly. |
| 20 |