Chegou uma ideia solta — grande demais para uma sessão de agent, e envolta em névoa: o caminho daqui até o destino ainda não é visível. Wayfinding é sobre achar esse caminho, não sobre partir para cima do destino. Esta skill traça o caminho como um mapa compartilhado no issue tracker do repo, e então trabalha seus decision tickets — perguntas cuja resolução é uma decisão, não fatias de um build a executar — um por vez até a rota ficar clara.

O destino varia a cada empreitada, e nomeá-lo é o primeiro ato de traçar o mapa — ele molda cada ticket. Pode ser uma spec para entregar e iterar, uma decisão a travar antes de o planejamento começar, ou uma mudança feita no lugar, como uma migração de estrutura de dados. O mapa é agnóstico de domínio — trabalho de engenharia, conteúdo de curso, o que couber no formato.

Planeje, não execute

Wayfinder é planejamento por padrão: cada ticket resolve uma decisão, e o mapa termina quando o caminho está claro — nada restando a decidir antes que alguém vá e faça a coisa. A vontade de simplesmente executar o trabalho é, em geral, o sinal de que você chegou à borda do mapa e é hora de fazer o handoff. Uma empreitada pode sobrescrever isso nas suas Notes — trazendo a execução para dentro do próprio mapa — mas, na ausência disso, produza decisões, não entregáveis.

Refira pelo nome

Todo mapa e todo ticket é uma issue, então tem um nome — seu título. Em tudo que o humano lê — narração, o Decisions-so-far do mapa — refira-se a ele por esse nome, nunca por um id, número ou slug pelado. Uma parede de #42, #43, #44 é ilegível; nomes se leem de relance. O id e a URL não somem — um nome embrulha seu link — mas eles viajam dentro do nome, nunca no lugar dele.

O Mapa

O mapa é uma única issue no issue tracker deste repo, com a label wayfinder:map — o artefato canônico. Seus tickets são issues-filhas do mapa.

O mapa é um índice, não um armazém. Ele lista as decisões tomadas e aponta para os tickets que guardam o detalhe delas; uma decisão vive em exatamente um lugar — seu ticket — então o mapa nunca a repete, apenas resume e linka.

Onde o mapa, seus tickets-filhos, o blocking e as queries de frontier moram fisicamente é específico do tracker. O issue tracker deve ter sido fornecido a você — rode /setup-leandrocfe-skills se não. Consulte a seção "Wayfinding operations" do doc do tracker para saber como este repo os expressa. Se nenhum tracker tiver sido fornecido, use o tracker local-markdown como padrão.