From 4712eb480437715719352808fd82b8428f6e62b8 Mon Sep 17 00:00:00 2001 From: Danijel Simeunovic Date: Sat, 1 Aug 2026 12:10:50 +0200 Subject: [PATCH] wayfinder instructions --- docs/agents/issue-tracker.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/docs/agents/issue-tracker.md b/docs/agents/issue-tracker.md index fe016af..30e2e36 100644 --- a/docs/agents/issue-tracker.md +++ b/docs/agents/issue-tracker.md @@ -25,3 +25,15 @@ Create a Gitea issue. ## When a skill says "fetch the relevant ticket" Fetch the issue via API or `tea issue view `. + +## Wayfinding operations + +Used by `/wayfinder`. The **map** is a single issue with **child** issues as tickets. + +- **Map**: a single issue labelled `wayfinder:map`, holding the Destination / Notes / Decisions-so-far / Fog body. + - Create: `POST /api/v1/repos/Forte/launchpad/issues` with `{"title":"...","body":"...","labels":[]}` +- **Child ticket**: an issue carrying `Part of #` at the top of its body and a `wayfinder:` label (`research`/`prototype`/`grilling`/`task`). Once claimed, the ticket is assigned to the driving dev. +- **Blocking**: Gitea does not have native issue dependencies. Fall back to a `Blocked by: #, #` line at the top of the child body. A ticket is unblocked when every issue it lists is closed. +- **Frontier query**: list the map's open children — `GET /api/v1/repos/Forte/launchpad/issues?state=open&labels=wayfinder:research,wayfinder:prototype,wayfinder:grilling,wayfinder:task` — then filter to those whose body starts with `Part of #`. Drop any with an open issue in their `Blocked by` line, or with an assignee. First in map order wins. +- **Claim**: `PATCH /api/v1/repos/Forte/launchpad/issues/` with `{"assignees":[""]}` — the session's first write. +- **Resolve**: post the answer as a comment (`POST .../comments`), close the issue (`PATCH` with `{"state":"closed"}`), then append a context pointer (gist + link) to the map's Decisions-so-far by editing the map issue body.