proxy/docs/agents/issue-tracker.md

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