31 lines
1.1 KiB
Markdown
31 lines
1.1 KiB
Markdown
# Issue tracker: Local Markdown
|
|
|
|
Issues and specs for this repo live as Markdown files in `.scratch/`.
|
|
|
|
## Conventions
|
|
|
|
- One feature per directory: `.scratch/<feature-slug>/`
|
|
- The spec is `.scratch/<feature-slug>/spec.md`
|
|
- Implementation issues are one file per ticket at
|
|
`.scratch/<feature-slug>/issues/<NN>-<slug>.md`
|
|
- Tickets are numbered from `01`
|
|
- Comments and conversation history are appended under `## Comments`
|
|
|
|
## When a skill says "publish to the issue tracker"
|
|
|
|
Create a new file under `.scratch/<feature-slug>/`, creating the directory if needed.
|
|
|
|
## When a skill says "fetch the relevant ticket"
|
|
|
|
Read the referenced file. The user will normally provide its path or issue number.
|
|
|
|
## Wayfinding operations
|
|
|
|
- Map: `.scratch/<effort>/map.md`
|
|
- Child ticket: `.scratch/<effort>/issues/NN-<slug>.md`
|
|
- `Type:` records `research`, `prototype`, `grilling`, or `task`
|
|
- `Status:` records `claimed` or `resolved`
|
|
- `Blocked by: NN, NN` declares blocking relationships
|
|
- Claim a ticket by setting `Status: claimed`
|
|
- Resolve it by adding `## Answer`, setting `Status: resolved`, and updating the map
|