From 96f795a63a6f53cc7bf38df329167964682c0e12 Mon Sep 17 00:00:00 2001 From: alexion Date: Fri, 31 Jul 2026 16:03:00 -0400 Subject: [PATCH] fix(wayfinder): simplify map references --- skills/wayfinder/ARTIFACTS.md | 18 +++++++++--------- skills/wayfinder/SKILL.md | 11 ++++++----- 2 files changed, 15 insertions(+), 14 deletions(-) diff --git a/skills/wayfinder/ARTIFACTS.md b/skills/wayfinder/ARTIFACTS.md index bad6638..d2d9d16 100644 --- a/skills/wayfinder/ARTIFACTS.md +++ b/skills/wayfinder/ARTIFACTS.md @@ -25,7 +25,8 @@ Never use a bare identifier as a human-facing reference. ## Map The map is the effort's root artifact and has no `parent`. -It is an index rather than the store for ticket resolutions. +It is a route summary rather than the store for ticket resolutions. +Only the Frontier links to tickets or other artifacts. ```markdown --- @@ -48,9 +49,9 @@ tags: - [[]] -## Resolutions so far +## Decisions so far - + ## Not yet specified @@ -63,14 +64,13 @@ tags: Map status is `open` while any live ticket or fog remains and `complete` when neither remains. -The Frontier is a derived navigation index. +The Frontier is a derived navigation index and the map's only artifact-link section. Ticket metadata is authoritative. Repair the Frontier whenever it is missing, stale, or inconsistent with ticket state. Order Frontier links by artifact identifier unless the user chooses another ticket. -For a resolved Grill or Task ticket, link the ticket and give a one-line gist. -For a resolved Research or Prototype ticket, give the ticket's gist once and nest links to every result artifact beneath it. -Do not copy the resolution into the map. +Under **Decisions so far**, record one concise, self-contained decision for each resolved ticket. +Do not link the ticket or its result artifacts, identify the ticket, or copy supporting detail from the canonical resolution into the map. ## Tickets @@ -125,8 +125,8 @@ Use `PI_SESSION_ID` when available and an equivalent harness session identifier Claims do not expire automatically. The acting agent uses the available context to recover an abandoned claim. -Only resolved tickets appear under **Resolutions so far**. -An out-of-scope ticket is closed and linked from **Out of scope** with the reason it lies beyond the destination. +Only resolved tickets contribute decisions under **Decisions so far**. +An out-of-scope ticket is closed, while **Out of scope** states the excluded work and reason in plain language without linking or identifying the ticket. ## Results diff --git a/skills/wayfinder/SKILL.md b/skills/wayfinder/SKILL.md index 5961f15..af338d7 100644 --- a/skills/wayfinder/SKILL.md +++ b/skills/wayfinder/SKILL.md @@ -61,8 +61,8 @@ One fog entry may become several tickets or disappear as the frontier advances. The destination fixes scope. Work beyond it belongs under **Out of scope**, never under **Not yet specified**. -When an existing ticket proves to be beyond the destination, mark it out of scope and link it from that section with the reason. -Do not record a scope boundary as a resolution on the route. +When an existing ticket proves to be beyond the destination, mark it out of scope and summarize the excluded work and reason in that section without an artifact link. +Do not record a scope boundary as a decision on the route. ## Select the mode @@ -98,7 +98,7 @@ Never resolve more than one non-Research ticket in a session. 1. **Orient.** Read the map at low resolution rather than loading every ticket. Reconcile its derived Frontier against ticket metadata. - Done when the destination, Notes, prior resolutions, fog, scope boundary, and current Frontier agree with the artifacts. + Done when the destination, Notes, prior decisions, fog, scope boundary, and current Frontier agree with the artifacts. 2. **Claim one ticket.** Use the user-named ticket when it is actionable. Otherwise take the first Frontier ticket in artifact-identifier order. @@ -110,8 +110,9 @@ Never resolve more than one non-Research ticket in a session. Load related artifacts only when needed. Done when the question has a resolution or the prerequisite Task is complete. 4. **Record the resolution.** - Persist the canonical result, resolve the ticket, and append its one-line gist and artifact links under the map's **Resolutions so far** according to [`ARTIFACTS.md`](ARTIFACTS.md). - Done when the resolution lives in exactly one canonical place and the map points to it without restating it. + Persist the canonical result, resolve the ticket, and append its concise decision under the map's **Decisions so far** according to [`ARTIFACTS.md`](ARTIFACTS.md). + Do not link or identify the resolved ticket or its result artifacts from the map. + Done when the resolution lives in exactly one canonical place and the map states only the resulting decision. 5. **Advance the frontier.** Create tickets surfaced by the resolution and wire their blockers. Graduate newly precise fog, remove invalidated tickets, move beyond-destination work out of scope, and recompute the Frontier.