tpf3-overtake/docs/agents/issue-tracker.md

Issue tracker: Gitea

Issues and specs for this repo live as Gitea issues on git.arthurerlich.de (repo haylan/tpf3-overtake). Use the tea CLI for all operations (see the gitea-tea skill).

Conventions

• Create an issue: tea issues create --title "..." --description "...". Use a heredoc for multi-line bodies.
• Read an issue: tea issues <number> --comments
• List issues: tea issues list --state open --fields index,title,body,labels with --labels filters as needed.
• Comment on an issue: tea comment <number> "..."
• Apply / remove labels: tea issues edit <number> --add-labels "..." / --remove-labels "..."
• Close: tea issues close <number> (comment first with tea comment)

Infer the repo from git remote -v — tea does this inside a clone.

Pull requests as a triage surface

PRs 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> --comments.

Wayfinding operations

Used by /wayfinder. The map is a single issue labelled wayfinder:map; child tickets are issues labelled wayfinder:<type> (research/prototype/grilling/task) with Part of #<map> at the top of the body and listed in the map's task list.

• Blocking: a Blocked by: #<n>, #<n> line at the top of the child body. Unblocked when every blocker is closed.
• Frontier query: open children of the map, minus any with an open blocker or an assignee; first in map order wins.
• Claim: assign the issue to yourself (tea issues edit <n> --add-assignees <user>).
• Resolve: comment the answer, close the issue, then append a pointer to the map's Decisions-so-far.