You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Adopt Matt Pocock’s wayfinder Method (v1.1.0, skills/engineering/wayfinder) as a pre-spec planning Box.
Why
wayfinder is the headline of v1.1.0 and its author’s recommended default in place of grill-with-docs whenever the work is too big for one agent session. It charts a loose idea as a map on the issue tracker: sub-issues with blocking relationships, each scoped to the size of one agent session, typed research / grilling / prototype / task. When the map is complete it feeds to-spec.
It independently arrives at two decisions this plugin already made — ADR-0013 (the tracker is the single source of truth for "where are we") and ADR-0007 (blocked-by canonical sequencing). That convergence is a strong signal it belongs here.
It also fits the DLC’s productivity thesis precisely: a HITL orchestrator that emits AFK work. The human works the grilling and prototype tickets; the research tickets are dispatchable to an Archon run (#276). That is the on-ramp pattern of ADR-0024, pointed at the pre-spec phase instead of intake.
Design questions for the ADR
Container.wayfinder is human-paced, so it is a command/skill, not an Archon workflow (ADR-0017). Confirm.
Relationship to /explore.wayfinder + research overlap /explore’s research pipeline, and a tracker map is arguably better than findings.md. Does /explore shrink to the AFK spike + spike/<slug> preservation, or retire outright?
Relationship to /specs. A completed map feeds to-spec. Does the map become a recognised /specs input alongside the existing branch-on-input paths (ADR-0020)?
Ticket types vs the label taxonomy.wayfinder’s research / grilling / prototype / task types must map onto classification.labels rather than introducing a second vocabulary — the same single-source-of-truth binding /triage performs (ADR-0024).
Corrected 2026-08-05 — the premise was overruled by practice. PR chore: de-dogfood unic-archon-dlc and upgrade Matt's skills to upstream main #298 admits wayfinder:* as a fifth, tool-scoped label namespace in this repo (wayfinder:map, :research, :prototype, :grilling, :task), deliberately separate from the state / type / priority / area tiers, with ADR-0032 amended rather than superseded to record it. So the open question is no longer “how do we avoid a second vocabulary” but: does the DLC bind wayfinder’s types to classification.labels, or does it adopt a tool-scoped namespace the way this repo did? A tool-scoped namespace is not the drift risk ADR-0024 guards against — that rule exists because /triage, /tickets and /build must agree on state, and a wayfinder ticket type is not a state. Grill this against the repo’s own experience once /wayfinder has actually run here.
Dispatch. Does the DLC auto-dispatch AFK-typed map tickets, or does the human dispatch them?
Blocked by
#281 — the box set is deliberately frozen at nine for the v1.1.0 migration.
Context
Locked in a grilling session on 2026-07-31 and deferred so the migration would not become a second redesign. See #279 for the Harness/Method design this builds on.
Adopt Matt Pocock’s
wayfinderMethod (v1.1.0,skills/engineering/wayfinder) as a pre-spec planning Box.Why
wayfinderis the headline of v1.1.0 and its author’s recommended default in place ofgrill-with-docswhenever the work is too big for one agent session. It charts a loose idea as a map on the issue tracker: sub-issues with blocking relationships, each scoped to the size of one agent session, typedresearch/grilling/prototype/task. When the map is complete it feedsto-spec.It independently arrives at two decisions this plugin already made — ADR-0013 (the tracker is the single source of truth for "where are we") and ADR-0007 (blocked-by canonical sequencing). That convergence is a strong signal it belongs here.
It also fits the DLC’s productivity thesis precisely: a HITL orchestrator that emits AFK work. The human works the grilling and prototype tickets; the research tickets are dispatchable to an Archon run (#276). That is the on-ramp pattern of ADR-0024, pointed at the pre-spec phase instead of intake.
Design questions for the ADR
Container.
wayfinderis human-paced, so it is a command/skill, not an Archon workflow (ADR-0017). Confirm.Relationship to
/explore.wayfinder+researchoverlap/explore’s research pipeline, and a tracker map is arguably better thanfindings.md. Does/exploreshrink to the AFK spike +spike/<slug>preservation, or retire outright?Relationship to
/specs. A completed map feedsto-spec. Does the map become a recognised/specsinput alongside the existing branch-on-input paths (ADR-0020)?Ticket types vs the label taxonomy.
wayfinder’sresearch/grilling/prototype/tasktypes must map ontoclassification.labelsrather than introducing a second vocabulary — the same single-source-of-truth binding/triageperforms (ADR-0024).Corrected 2026-08-05 — the premise was overruled by practice. PR chore: de-dogfood unic-archon-dlc and upgrade Matt's skills to upstream main #298 admits
wayfinder:*as a fifth, tool-scoped label namespace in this repo (wayfinder:map,:research,:prototype,:grilling,:task), deliberately separate from the state / type / priority / area tiers, with ADR-0032 amended rather than superseded to record it. So the open question is no longer “how do we avoid a second vocabulary” but: does the DLC bind wayfinder’s types toclassification.labels, or does it adopt a tool-scoped namespace the way this repo did? A tool-scoped namespace is not the drift risk ADR-0024 guards against — that rule exists because/triage,/ticketsand/buildmust agree on state, and a wayfinder ticket type is not a state. Grill this against the repo’s own experience once/wayfinderhas actually run here.Dispatch. Does the DLC auto-dispatch AFK-typed map tickets, or does the human dispatch them?
Blocked by
#281 — the box set is deliberately frozen at nine for the v1.1.0 migration.
Context
Locked in a grilling session on 2026-07-31 and deferred so the migration would not become a second redesign. See #279 for the Harness/Method design this builds on.