36 lines
1.7 KiB
Markdown
36 lines
1.7 KiB
Markdown
# 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.
|