Guía de ClaudeNivel 4 · Pensar antes de construirLevel 4 · Thinking before building

Wayfinder: un mapa para lo que no entra en una sesiónWayfinder: a map for what doesn't fit in a session

Cuando el trabajo es más grande que una conversación, se planea primero con tickets de decisión y se ejecuta después.When the work is bigger than one conversation, you plan first with decision tickets and execute afterward.

Hay trabajos que no caben en una sesión. A veces ni siquiera son difíciles; son grandes y están envueltos en niebla: sabés más o menos adónde querés llegar, pero no ves el camino. Si lo encarás igual, la sesión se llena de contexto, llega el tope y lo que quedó decidido a medias se pierde en el traspaso.

Wayfinder es otra skill de Matt Pocock (repo mattpocock/skills, se instala con npx skills@latest add mattpocock/skills). Su propuesta es dibujar el mapa antes de dar el primer paso.

Las partes del mapa

El mapa es un documento que sirve de índice, no de depósito. Tiene cuatro secciones:

  • Destino. Qué aspecto tiene llegar: una especificación, una decisión cerrada o un cambio hecho. Se fija primero, porque define el alcance de todo lo demás.
  • Decisiones tomadas. Una línea por cada ticket resuelto, con un link al detalle. La decisión vive en un solo lugar (su ticket) y el mapa solo la resume.
  • Todavía sin especificar. La niebla: cosas que sabés que van a aparecer pero que no podés formular con precisión. No se corta en tickets antes de tiempo. Cuando una decisión la aclara, recién ahí se vuelve ticket.
  • Fuera de alcance. Lo que descartaste a propósito. No vuelve, salvo que cambie el destino.

Cada ticket es una pregunta que se resuelve con una decisión, del tamaño de una sesión. Puede ser investigación, un prototipo, una conversación (acá entra el grill me) o una tarea manual que destraba una decisión. Y una regla simple: una sesión, un ticket.

Planear sin ejecutar

Esto fue lo que más me costó. La skill pide planear y soltar. Cada ticket produce una decisión, no un entregable, y el mapa termina cuando no queda nada por decidir. Las ganas de “ya que estoy, lo hago” suelen indicar que llegaste al borde del mapa y toca pasar a otra etapa.

El ejemplo: un reinicio

Lo estoy usando para pensar un reinicio de todos mis proyectos: qué queda, qué se archiva y con qué reglas sigo. Es el caso típico de lo que no entra en una conversación, porque toca todas las carpetas y cada decisión cambia las que vienen después.

El destino quedó escrito en una línea: una especificación de una página. Planificar, no ejecutar. De la primera sesión salieron unas pocas decisiones, siete tickets abiertos y una sorpresa: uno de esos tickets bloquea a todos los demás, y no era el que yo creía. Todavía no terminé. El mapa está a medias, y la gracia es justamente esa: puedo cerrar la sesión hoy y abrir otra la semana que viene sin perder nada, porque lo decidido está escrito y no en el contexto de una conversación.

Cuándo no usarlo

Si el camino ya está claro y entra en una sesión, no hace falta mapa: la propia skill dice que en ese caso conviene frenar y preguntar cómo seguir. Un mapa también tiene costo, y para un cambio de dos archivos sería un modo elegante de procrastinar.

Es, además, la mejor forma que encontré de respetar el tope de sesión que cuento en Hábitos.

El prompt

Quiero planear [describí el trabajo grande y el resultado que imaginás]. Usá la skill wayfinder: primero ayudame a fijar el destino con una entrevista (grilling), después armá el mapa con destino, decisiones tomadas, lo todavía sin especificar y lo fuera de alcance, y creá solo los tickets de decisión que se puedan formular ya. Resolvé un ticket por sesión. Planeá sin ejecutar nada y no guardes ni cambies ningún archivo sin que yo lo apruebe.

Some jobs don't fit in a session. Sometimes they're not even hard; they're big and wrapped in fog: you know more or less where you want to end up, but you can't see the road. If you tackle it anyway, the session fills up with context, hits the cap and whatever was left half decided gets lost in the handoff.

Wayfinder is another skill by Matt Pocock (repo mattpocock/skills, installed with npx skills@latest add mattpocock/skills). Its proposal is to draw the map before taking the first step.

The parts of the map

The map is a document that works as an index, not as a warehouse. It has four sections:

  • Destination. What arriving looks like: a specification, a closed decision or a change made. It's fixed first, because it defines the scope of everything else.
  • Decisions made. One line per resolved ticket, with a link to the detail. The decision lives in one place (its ticket) and the map only summarizes it.
  • Still unspecified. The fog: things you know will come up but can't formulate precisely. It doesn't get cut into tickets ahead of time. When a decision clears it up, only then does it become a ticket.
  • Out of scope. What you ruled out on purpose. It doesn't come back unless the destination changes.

Each ticket is a question that gets resolved with a decision, the size of one session. It can be research, a prototype, a conversation (the grill me goes here) or a manual task that unlocks a decision. And a simple rule: one session, one ticket.

Planning without executing

This was what cost me the most. The skill asks you to plan and let go. Each ticket produces a decision, not a deliverable, and the map is done when there's nothing left to decide. The urge to “since I'm here, I'll just do it” usually means you've reached the edge of the map and it's time to move to another stage.

The example: a restart

I'm using it to think through a restart of all my projects: what stays, what gets archived and what rules I continue under. It's the typical case of what doesn't fit in a conversation, because it touches every folder and each decision changes the ones that come after.

The destination got written in one line: a one-page specification. Plan, don't execute. The first session produced a few decisions, seven open tickets and a surprise: one of those tickets blocks all the others, and it wasn't the one I thought. I'm not done yet. The map is half finished, and that's exactly the point: I can close the session today and open another one next week without losing anything, because what's been decided is written down and not in a conversation's context.

When not to use it

If the road is already clear and fits in a session, you don't need a map: the skill itself says that in that case it's better to stop and ask how to continue. A map also has a cost, and for a two-file change it would be an elegant way to procrastinate.

It's also the best way I've found to respect the session cap I describe in Habits.

The prompt

I want to plan [describe the big job and the result you imagine]. Use the wayfinder skill: first help me fix the destination with an interview (grilling), then build the map with destination, decisions made, what's still unspecified and what's out of scope, and create only the decision tickets that can already be formulated. Resolve one ticket per session. Plan without executing anything and don't save or change any file until I approve it.