Record supplied VoidKontrol specification and repository guidance

docs/agents/issue-tracker.md

@@ -0,0 +1,27 @@
+# Issue tracker: Gitea
+
+Issues and specs for this repo live as Gitea issues. Use the official [`tea`](https://gitea.com/gitea/tea) CLI for all operations.
+
+## Conventions
+
+- **Create an issue**: `tea issues create --title "..." --description "..."`.
+- **Read an issue**: `tea issues <number>`.
+- **List issues**: `tea issues`; use `tea issues --state all` for all states and `tea issues --format json` for machine-readable output.
+- **Comment on an issue**: `tea comment issue <number>`.
+- **Apply / remove labels**: `tea issues edit <number> --add-labels "..."` / `--remove-labels "..."`.
+- **Close**: `tea issues close <number>`.
+- **Pull requests**: use `tea pulls create`, `tea pulls <number>`, and `tea pulls checkout <number>`.
+
+Configure the Gitea instance with `tea login add`. `tea` uses repository context from the current clone when available.
+
+## Merge requests as a triage surface
+
+**Pull requests as a request surface: no.**
+
+## When a skill says "publish to the issue tracker"
+
+Create a Gitea issue.
+
+## When a skill says "fetch the relevant ticket"
+
+Run `tea issues <number>`.