Skip to content

SKILL.md

Latest commit

 

History

History
79 lines (66 loc) · 4.5 KB

SKILL.md

File metadata and controls

79 lines (66 loc) · 4.5 KB
Raw
name map-it
description Resolve a foggy, multi-session goal into a frozen execution map that ship-it can consume — decisions, not deliverables. Chart a fog-of-war map of decision-tickets (only ticket what you can phrase sharply now), clear the research/decision frontier in parallel with HITL at each decision, and produce a frozen plan + a prepared DAG. Use when the goal is too big/foggy for one session, "chart this", "plan this epic", "I don't know the shape yet", or you can't yet authorize implementation. Its outcome is a decided plan; building is ship-it. Not for a foggy BUG (root-cause) or ready-to-build intent (ship-it).
license MIT
proof doctrine-only
compatibility HARD dependency: Orca runtime + orchestration skill (Orca CLI). A wayfinder/research worker playbook (mattpocock wayfinder + research) — one router per worker.

map-it — foggy goal → a frozen, decided execution map

You are the COORDINATOR. The terminal ARTIFACT is distinct from building: resolved decision tickets plus a frozen execution map. Valuable precisely when the user does not want, or cannot yet authorize, implementation. Inside ship-it, ordinary planning is a phase; map-it is invoked only when the goal fails the freeze bar: a testable acceptance criterion cannot yet be written for ≥1 in-scope capability, or ≥1 one-way decision's inputs are unknown. Below that bar, ship-it's own grill/freeze phase handles planning. Composes decide-and-freeze, decompose-dag (prepare only); rides gate-classification, liveness-resume, evidence-manifest. Worker TASK pack: matt — never co-mount.

Two terminal outcomes

  • MAPPED — destination named; every open question is a sharp ticket (resolved) or explicit "not yet specified"; human-resolved decisions; frozen plan/spec + prepared, verified, frozen-for- handoff DAG that ship-it can consume without re-grilling.
  • MAPPED-WITH-BLOCKED (degraded) — map is frozen for what is known, but ≥1 decision ticket is blocked on a human who has not answered; handoff lists blockers. Never reported as MAPPED.

Pipeline (plan, don't do)

NAME the destination first (fixes scope — everything past it is out of scope; everything before but
  not-yet-sharp is FOG) → chart the MAP as decision-tickets
  → FOG-OF-WAR rule: only ticket what you can phrase SHARPLY now (the test is "can you state the
    question, not answer it"). Not-yet-sharp → "not yet specified".
  → clear the FRONTIER in parallel: Research tickets (AFK) gather evidence; Decision/Grill tickets are
    HITL classified mechanical/taste/one-way per `gate-classification.md` (the agent never stands in
    for the human's side); one decision per session; resolving a ticket clears fog and graduates
    newly-sharp questions into fresh tickets
  → when the route is clear: FREEZE the plan/spec (decide-and-freeze) + PREPARE the DAG (decompose-dag,
    materialize but do not dispatch)
  → HANDOFF ARTIFACT CHECKLIST (ship-it adopts these without re-decomposing):
    · freeze commit SHA + path to frozen plan/spec
    · prepared DAG artifact path + task-id ↔ slice table
    · open "not yet specified" / blocked ticket list
    · evidence manifest naming MAPPED or MAPPED-WITH-BLOCKED

Convergence proof

The destination is named; every open question is either a sharp ticket (resolved or blocked) or an explicit "not yet specified"; every decision ticket was resolved by the HUMAN (not the agent) or is explicitly blocked; a frozen plan/spec exists; a materialized, verified, FROZEN-for-handoff DAG exists (decompose-dag's prepare-only completion — committed by freeze, not dispatch) that ship-it can consume without re-grilling. The mission produces DECISIONS, not deliverables — no production code is written. Handoff checklist complete.

Ledger + supervision

Header per liveness-resume.md: RUN · COORDINATOR · BASE=- · FORK_POINT=- · T0 · SOURCE · WIP (SOURCE = destination + freeze SHA when frozen). Rows include Orca task id + decision ticket fields. Multi-session by design: stalls → WATCH; death → RESUME scoped to header coordinator + ledger task ids — never re-grill resolved tickets.

Anti-patterns

The agent answering its own decision/grill tickets (HITL leak). Charting fog you can't phrase now. Resolving more than one decision per session. Sliding into building (that's ship-it — hand off at freeze). Re-decomposing a prepared DAG in ship-it (orphans task ids).

Related

ship-it (consumes the frozen map), root-cause (a foggy BUG, not a foggy plan).