chore: initialize proxyctl specification

docs/agents/issue-tracker.md

@@ -0,0 +1,30 @@
+# 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