[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7APD61FZ7CM400NTJM0GSEH":3,"skill-same:01M7APD61FZ7CM400NTJM0GSEH":52},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":14,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":31,"updatedAt":32,"install":33,"resources":45},"01M7APD61FZ7CM400NTJM0GSEH","wayfinder",null,"Planeje uma grande fatia de trabalho — mais do que uma sessão de agente comporta — como um mapa compartilhado de decision tickets no seu issue tracker, e resolva-os um de cada vez até que o caminho até o destino esteja desimpedido.","matheusdmlopes\u002Fskills-ptbr","matheusdmlopes","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F115191427?v=4","01M7APAA2NZDDT90C9Q4SK3QJE","Matheus De Marco Lopes","01M7APAA3GZ0Z81YMV996S8YF1",0,"MIT","https:\u002F\u002Fgithub.com\u002Fmatheusdmlopes\u002Fskills-ptbr\u002Fblob\u002Fmain\u002Fskills\u002Fengineering\u002Fwayfinder\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: wayfinder\ndescription: Planeje uma grande fatia de trabalho — mais do que uma sessão de agente comporta — como um mapa compartilhado de decision tickets no seu issue tracker, e resolva-os um de cada vez até que o caminho até o destino esteja desimpedido.\ndisable-model-invocation: true\n---\n\nUma ideia vaga chegou — grande demais para uma sessão de agente, e envolta em névoa: o caminho daqui até o **destino** ainda não está visível. O wayfinding consiste em encontrar esse caminho, não em avançar cegamente até o destino. Esta skill traça o caminho como um **mapa compartilhado** no issue tracker do repositório, 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é que a rota esteja clara.\n\nO destino varia por iniciativa, e nomeá-lo é o primeiro ato do mapeamento — ele molda cada ticket. Pode ser uma spec para repassar e iterar, uma decisão a fixar antes do início do planejamento, ou uma alteração feita no local, como uma migração de estrutura de dados. O mapa é agnóstico de domínio — trabalho de engenharia, conteúdo de curso, o que quer que se encaixe no formato.\n\n## Planeje, não execute\n\nO Wayfinder é **planejamento** por padrão: cada ticket resolve uma decisão, e o mapa está concluído quando o caminho estiver desimpedido — nada mais a decidir antes que alguém vá e faça a coisa. O impulso de simplesmente fazer o trabalho costuma ser o sinal de que você atingiu a borda do mapa e é hora de passar o bastão (handoff). Uma iniciativa pode sobrescrever isso em suas **Notas** — levando a execução para dentro do próprio mapa —, mas, na ausência disso, produza decisões, não entregáveis.\n\n## Referencie pelo nome\n\nTodo mapa e ticket é uma issue, portanto possui um **nome** — seu título. Em tudo o que o humano lê — narração, Decisões até o momento no mapa — refira-se a ele por esse nome, nunca por um id, número ou slug puro. Uma parede de `#42, #43, #44` é ilegível; nomes são lidos num relance. O id e a URL não desaparecem — um nome envolve seu link —, mas eles viajam _dentro_ do nome, nunca o substituem.\n\n## O Mapa\n\nO mapa é uma única issue no issue tracker deste repo, rotulada como `wayfinder:map` — o artefato canônico. Seus tickets são issues filhas do mapa.\n\nO mapa é um **índice**, não um armazenamento. Ele lista as decisões tomadas e aponta para os tickets que guardam seus detalhes; uma decisão vive em exatamente um lugar — seu ticket —, de modo que o mapa nunca a reitera, apenas resume sua essência e cria o link.\n\n**Onde o mapa, suas issues filhas, o bloqueio e as consultas de fronteira residem fisicamente depende do tracker.** O issue tracker deve ter sido fornecido a você — execute `\u002Fsetup-matt-pocock-skills` se não foi. Consulte a seção \"Operações de wayfinding\" da documentação do tracker para saber como _este_ repositório os expressa. Se nenhum tracker tiver sido fornecido, use como padrão o tracker de markdown local.\n\n### O corpo do mapa\n\nO mapa inteiro em baixa resolução, carregado uma vez por sessão. Tickets abertos **não** são listados — eles são issues filhas abertas, encontradas por consulta.\n\n```markdown\n## Destino\n\n\u003Ccomo se parece o alcance do fim deste mapa — a spec, decisão ou alteração até a qual esta iniciativa está encontrando o caminho. Uma ou duas linhas; cada sessão se orienta por ele antes de escolher um ticket.>\n\n## Notas\n\n\u003Cdomínio; skills que cada sessão deve consultar; preferências estabelecidas para esta iniciativa>\n\n## Decisões até o momento\n\n\u003C!-- o índice — uma linha por ticket fechado: o suficiente para julgar a relevância, e depois amplie o link para os detalhes que o ticket contém -->\n\n- [\u003Ctítulo do ticket fechado>](link) — \u003Cresumo de uma linha da resposta>\n\n## Não especificado ainda\n\n\u003C!-- veja \"Névoa de guerra\": névoa dentro do escopo que você ainda não consegue transformar em ticket; é promovida conforme a fronteira avança -->\n\n## Fora de escopo\n\n\u003C!-- veja \"Fora de escopo\": trabalho determinado além do destino; fechado, nunca promovido -->\n```\n\n### Tickets\n\nCada ticket é uma **issue filha** do mapa; o id da issue no tracker é sua identidade. Seu corpo é a pergunta, dimensionada para uma sessão de agente de 100K tokens:\n\n```markdown\n## Pergunta\n\n\u003Ca decisão ou investigação que este ticket resolve>\n```\n\nCada ticket carrega uma label `wayfinder:\u003Ctype>` — uma entre `research`, `prototype`, `grilling`, `task` (veja [Tipos de ticket](#tipos-de-ticket)).\n\nUma sessão **reivindica** (claim) um ticket atribuindo-o ao dev que está conduzindo o mapa, **primeiro**, antes de qualquer trabalho, para que sessões concorrentes o ignorem. Esse responsável (assignee) _é_ a reivindicação: um ticket aberto e não atribuído está não reivindicado.\n\nO bloqueio usa a relação de dependência **nativa** do tracker — essencial porque renderiza a fronteira _visualmente_ na própria UI do tracker, de modo que o humano veja o que pode ser assumido sem abrir o mapa. Apenas um tracker que não tenha bloqueio nativo recorre a uma convenção no corpo. Um ticket está **desbloqueado** quando todos os tickets que o bloqueiam estiverem fechados; a **fronteira** são as filhas abertas, desbloqueadas e não reivindicadas — a borda do conhecido.\n\nA resposta não faz parte do corpo — ela é registrada na resolução (veja [Trabalhar através do mapa](#trabalhar-atraves-do-mapa)). Ativos criados durante a resolução de um ticket são linkados a partir da issue, não colados nela.\n\n## Tipos de ticket\n\nTodo ticket é **HITL** — human in the loop, trabalhado _com_ um humano que fala por si mesmo — ou **AFK**, conduzido pelo agente sozinho. Um ticket HITL só é resolvido por meio dessa troca ao vivo; o agente nunca assume o lado do humano (um agente de sabatina que responde às suas próprias perguntas quebrou essa regra).\n\n- **Research** (AFK): Leitura de documentação, APIs de terceiros ou recursos locais, como bases de conhecimento, para expor um fato do qual uma decisão depende. Resolvido por um subagente `\u002Fresearch`. Use quando for necessário conhecimento fora do diretório de trabalho atual.\n- **Prototype** (HITL): Eleve a fidelidade da discussão criando um artefato barato, rascunhado e concreto para reagir — um esboço, uma versão preliminar, um stub ou código de UI\u002Flógica via a skill \u002Fprototype. Linka o protótipo como um ativo. Use quando \"como isso deve parecer\" ou \"como isso deve se comportar\" for a pergunta principal.\n- **Grilling** (HITL): Conversa. O caso padrão. Sempre invoque as skills \u002Fgrilling e \u002Fdomain-modeling.\n- **Task** (HITL ou AFK): Trabalho manual que deve acontecer antes que uma _decisão_ possa ser tomada — nada para decidir, prototipar ou pesquisar, mas a discussão está bloqueada até que isso seja feito. Cadastrar-se em um serviço para que sua API possa ser avaliada, provisionar acesso, mover dados para que seu formato possa ser visto. Este é o único tipo que _faz_ em vez de decidir — e ele conquista seu lugar desbloqueando uma decisão, não entregando o destino. O agente o conduz sozinho onde puder (AFK); caso contrário, entrega ao humano um checklist preciso (HITL). Resolvido quando o trabalho é concluído; a resposta registra o que foi feito e quaisquer fatos resultantes (localização de credenciais, novas URLs, contagens de linhas) dos quais tickets posteriores dependam.\n\n## Névoa de guerra\n\nO mapa é _deliberadamente_ incompleto: não mapeie o que você ainda não consegue ver. Além dos tickets ativos reside a **névoa de guerra** — a visão tênue de decisões e investigações que você percebe que estão por vir, mas ainda não consegue fixar, porque dependem de perguntas ainda abertas. Resolver um ticket dissipa a névoa à frente dele, promovendo o que agora é especificável em novos tickets — um de cada vez, até que o caminho para o destino esteja desimpedido e nenhum ticket reste.\n\nA seção **Não especificado ainda** do mapa é onde essa visão tênue é registrada: a pergunta sob suspeita, a área a revisitar mais tarde. É a fronteira não descoberta _em direção_ ao destino — tudo aqui está no escopo, apenas não nítido o suficiente para virar ticket. Escreva tão livremente ou tão detalhadamente quanto a visão permitir; ela funciona também como uma sinalização para colaboradores lendo sobre o rumo da iniciativa.\n\n**Névoa ou ticket?** O teste é se você consegue formular a pergunta com precisão agora — _não_ se consegue respondê-la agora.\n\n- **Ticket quando** a pergunta já for nítida — mesmo que esteja bloqueada e você não possa agir sobre ela ainda.\n- **Não especificado ainda quando** você ainda não conseguir formulá-la com tanta nitidez. Não pré-fatie a névoa em pedaços do tamanho de tickets: ela é mais rústica do que um ticket, e um trecho de névoa pode ser promovido para vários tickets, ou nenhum, assim que a fronteira o alcançar.\n\n**Não especificado ainda** exclui o que já foi decidido (Decisões até o momento), o que já é um ticket ativo e o que está fora de escopo (a próxima seção).\n\n## Fora de escopo\n\nA névoa só se acumula _em direção_ ao destino. O destino fixa o escopo, de modo que o trabalho além dele está **fora de escopo** — não é névoa e não pertence a **Não especificado ainda**. Ele ganha sua própria seção **Fora de escopo** no mapa: trabalho que você conscientemente descartou _desta_ iniciativa. É o escopo, não a nitidez, que o coloca aqui.\n\nO trabalho fora de escopo nunca é promovido — a fronteira para no destino —, portanto só retorna se o destino for redesenhado, e então como uma nova iniciativa, não uma retomada.\n\nDescartar algo do escopo é um ato de delimitação de escopo, não um passo na rota. Quando um ticket já existente se revelar situado além do destino — incluído erroneamente no mapeamento inicial ou exposto por uma resolução —, **feche-o** (um ticket fechado está inequivocamente fora da fronteira) e deixe uma linha na seção **Fora de escopo**: a essência mais o porquê de estar fora de escopo, linkando o ticket fechado. Ele permanece fora de **Decisões até o momento**, que registra a rota efetivamente percorrida — uma divisa de escopo não é um passo nela.\n\n## Invocação\n\nDois modos. De qualquer forma, **nunca resolva mais de um ticket por sessão** — com exceção dos tickets de pesquisa.\n\n### Traçar o mapa\n\nO usuário invoca com uma ideia vaga.\n\n1. **Nomeie o destino.** Execute uma sessão de `\u002Fgrilling` e `\u002Fdomain-modeling` para fixar até onde este mapa está encontrando o caminho — a spec, decisão ou alteração. O destino fixa o escopo, portanto é resolvido primeiro.\n2. **Mapeie a fronteira.** Sabatine novamente, desta vez **em largura (breadth-first)**: espalhe-se por todo o espaço em vez de se aprofundar em qualquer linha única, trazendo à tona as decisões em aberto e os primeiros passos viáveis agora. **Se isso não revelar nenhuma névoa** — o caminho até o destino já estiver claro, toda a jornada for pequena o suficiente para uma sessão —, você não precisa de um mapa. Pare e pergunte ao usuário como ele gostaria de prosseguir.\n3. **Crie o mapa** (label `wayfinder:map`): Destino e Notas preenchidos, Decisões até o momento vazias, a névoa esboçada em **Não especificado ainda**.\n4. **Crie os tickets que você pode especificar agora** como issues filhas do mapa — e então conecte as arestas de bloqueio em uma **segunda passada** (as issues precisam de ids antes de poderem referenciar umas às outras). A conexão as organiza na fronteira e nos bloqueados; tudo o que você ainda não puder especificar permanece na névoa — a seção **Não especificado ainda**.\n5. **Dispare os subagentes de pesquisa.** Para cada ticket `research` criado, inicie um subagente `\u002Fresearch` para resolvê-lo em paralelo, capturando suas descobertas em um branch descartável `research\u002F\u003Cname>` com um ponteiro de contexto a partir do ticket.\n6. Pare — traçar o mapa é o trabalho de uma sessão; não resolve nada manualmente.\n\n### Trabalhar através do mapa\n\nO usuário invoca com um mapa (URL ou número). Um ticket é **opcional** — sem um, você escolhe a próxima decisão, não o usuário.\n\n1. Carregue o **mapa** — a visão em baixa resolução, não o corpo de todos os tickets.\n2. Escolha o ticket. Se o usuário nomeou um, use-o. Caso contrário, pegue o primeiro ticket da fronteira em ordem. **Reivindique-o**: atribua-o a si mesmo antes de qualquer trabalho.\n3. Resolva-o — **aprofunde conforme necessário (zoom as needed)**: busque o corpo completo de qualquer ticket relacionado ou fechado sob demanda; invoque as skills que o bloco `## Notas` nomeia. Em caso de dúvida, use `\u002Fgrilling` e `\u002Fdomain-modeling`.\n4. Registre a resolução: publique a resposta como um **comentário de resolução**, **feche** a issue e **anexe um ponteiro de contexto** às Decisões até o momento do mapa.\n5. Adicione tickets recém-surgidos (criar e depois conectar); promova qualquer névoa que a resposta tenha tornado especificável, limpando cada trecho promovido de **Não especificado ainda** para que ele viva apenas como seu novo ticket. Se a resposta revelar que um ticket — este ou outro — fica além do destino, **descarte-o do escopo** em vez de resolvê-lo na rota. Se a decisão invalidar outras partes do mapa, atualize ou exclua esses tickets.\n\nO usuário pode executar tickets desbloqueados em paralelo, portanto espere que outras sessões estejam editando o tracker simultaneamente.\n","Uma ideia vaga chegou — grande demais para uma sessão de agente, e envolta em névoa: o caminho daqui até o **destino** ainda não está visível. O wayfinding consiste em encontrar esse caminho, não em avançar cegamente até o destino. Esta skill traça o caminho como um **mapa compartilhado** no issue tracker do repositório, 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é que a rota esteja clara.\n\nO destino varia por iniciativa, e nomeá-lo é o primeiro ato do mapeamento — ele molda cada ticket. Pode ser uma spec para repassar e iterar, uma decisão a fixar antes do início do planejamento, ou uma alteração feita no local, como uma migração de estrutura de dados. O mapa é agnóstico de domínio — trabalho de engenharia, conteúdo de curso, o que quer que se encaixe no formato.\n\n## Planeje, não execute\n\nO Wayfinder é **planejamento** por padrão: cada ticket resolve uma decisão, e o mapa está concluído quando o caminho estiver desimpedido — nada mais a decidir antes que alguém vá e faça a coisa. O impulso de simplesmente fazer o trabalho costuma ser o sinal de que você atingiu a borda do mapa e é hora de passar o bastão (handoff). Uma iniciativa pode sobrescrever isso em suas **Notas** — levando a execução para dentro do próprio mapa —, mas, na ausência disso, produza decisões, não entregáveis.\n\n## Referencie pelo nome\n\nTodo mapa e ticket é uma issue, portanto possui um **nome** — seu título. Em tudo o que o humano lê — narração, Decisões até o momento no mapa — refira-se a ele por esse nome, nunca por um id, número ou slug puro. Uma parede de `#42, #43, #44` é ilegível; nomes são lidos num relance. O id e a URL não desaparecem — um nome envolve seu link —, mas eles viajam _dentro_ do nome, nunca o substituem.\n\n## O Mapa\n\nO mapa é uma única issue no issue tracker deste repo, rotulada como `wayfinder:map` — o artefato canônico. Seus tickets são issues filhas do mapa.\n\nO mapa é um **índice**, não um armazenamento. Ele lista as decisões tomadas e aponta para os tickets que guardam seus detalhes; uma decisão vive em exatamente um lugar — seu ticket —, de modo que o mapa nunca a reitera, apenas resume sua essência e cria o link.\n\n**Onde o mapa, suas issues filhas, o bloqueio e as consultas de fronteira residem fisicamente depende do tracker.** O issue tracker deve ter sido fornecido a você — execute `\u002Fsetup-matt-pocock-skills` se não foi. Consulte a seção \"Operações de wayfinding\" da documentação do tracker para saber como _este_ repositório os expressa. Se nenhum tracker tiver sido fornecido, use como padrão o tracker de markdown local.\n\n### O corpo do mapa\n\nO mapa inteiro em baixa resolução, carregado uma vez por sessão. Tickets abertos **não** são listados — eles são issues filhas abertas, encontradas por consulta.\n\n```markdown\n## Destino\n\n\u003Ccomo se parece o alcance do fim deste mapa — a spec, decisão ou alteração até a qual esta iniciativa está encontrando o caminho. Uma ou duas linhas; cada sessão se orienta por ele antes de escolher um ticket.>\n\n## Notas\n\n\u003Cdomínio; skills que cada sessão deve consultar; preferências estabelecidas para esta iniciativa>\n\n## Decisões até o momento\n\n\u003C!-- o índice — uma linha por ticket fechado: o suficiente para julgar a relevância, e depois amplie o link para os detalhes que o ticket contém -->\n\n- [\u003Ctítulo do ticket fechado>](link) — \u003Cresumo de uma linha da resposta>\n\n## Não especificado ainda\n\n\u003C!-- veja \"Névoa de guerra\": névoa dentro do escopo que você ainda não consegue transformar em ticket; é promovida conforme a fronteira avança -->\n\n## Fora de escopo\n\n\u003C!-- veja \"Fora de escopo\": trabalho determinado além do destino; fechado, nunca promovido -->\n```\n\n### Tickets\n\nCada ticket é uma **issue filha** do mapa; o id da issue no tracker é sua identidade. Seu corpo é a pergunta, dimensionada para uma sessão de agente de 100K tokens:\n\n```markdown\n## Pergunta\n\n\u003Ca decisão ou investigação que este ticket resolve>\n```\n\nCada ticket carrega uma label `wayfinder:\u003Ctype>` — uma entre `research`, `prototype`, `grilling`, `task` (veja [Tipos de ticket](#tipos-de-ticket)).\n\nUma sessão **reivindica** (claim) um ticket atribuindo-o ao dev que está conduzindo o mapa, **primeiro**, antes de qualquer trabalho, para que sessões concorrentes o ignorem. Esse responsável (assignee) _é_ a reivindicação: um ticket aberto e não atribuído está não reivindicado.\n\nO bloqueio usa a relação de dependência **nativa** do tracker — essencial porque renderiza a fronteira _visualmente_ na própria UI do tracker, de modo que o humano veja o que pode ser assumido sem abrir o mapa. Apenas um tracker que não tenha bloqueio nativo recorre a uma convenção no corpo. Um ticket está **desbloqueado** quando todos os tickets que o bloqueiam estiverem fechados; a **fronteira** são as filhas abertas, desbloqueadas e não reivindicadas — a borda do conhecido.\n\nA resposta não faz parte do corpo — ela é registrada na resolução (veja [Trabalhar através do mapa](#trabalhar-atraves-do-mapa)). Ativos criados durante a resolução de um ticket são linkados a partir da issue, não colados nela.\n\n## Tipos de ticket\n\nTodo ticket é **HITL** — human in the loop, trabalhado _com_ um humano que fala por si mesmo — ou **AFK**, conduzido pelo agente sozinho. Um ticket HITL só é resolvido por meio dessa troca ao vivo; o agente nunca assume o lado do humano (um agente de sabatina que responde às suas próprias perguntas quebrou essa regra).\n\n- **Research** (AFK): Leitura de documentação, APIs de terceiros ou recursos locais, como bases de conhecimento, para expor um fato do qual uma decisão depende. Resolvido por um subagente `\u002Fresearch`. Use quando for necessário conhecimento fora do diretório de trabalho atual.\n- **Prototype** (HITL): Eleve a fidelidade da discussão criando um artefato barato, rascunhado e concreto para reagir — um esboço, uma versão preliminar, um stub ou código de UI\u002Flógica via a skill \u002Fprototype. Linka o protótipo como um ativo. Use quando \"como isso deve parecer\" ou \"como isso deve se comportar\" for a pergunta principal.\n- **Grilling** (HITL): Conversa. O caso padrão. Sempre invoque as skills \u002Fgrilling e \u002Fdomain-modeling.\n- **Task** (HITL ou AFK): Trabalho manual que deve acontecer antes que uma _decisão_ possa ser tomada — nada para decidir, prototipar ou pesquisar, mas a discussão está bloqueada até que isso seja feito. Cadastrar-se em um serviço para que sua API possa ser avaliada, provisionar acesso, mover dados para que seu formato possa ser visto. Este é o único tipo que _faz_ em vez de decidir — e ele conquista seu lugar desbloqueando uma decisão, não entregando o destino. O agente o conduz sozinho onde puder (AFK); caso contrário, entrega ao humano um checklist preciso (HITL). Resolvido quando o trabalho é concluído; a resposta registra o que foi feito e quaisquer fatos resultantes (localização de credenciais, novas URLs, contagens de linhas) dos quais tickets posteriores dependam.\n\n## Névoa de guerra\n\nO mapa é _deliberadamente_ incompleto: não mapeie o que você ainda não consegue ver. Além dos tickets ativos reside a **névoa de guerra** — a visão tênue de decisões e investigações que você percebe que estão por vir, mas ainda não consegue fixar, porque dependem de perguntas ainda abertas. Resolver um ticket dissipa a névoa à frente dele, promovendo o que agora é especificável em novos tickets — um de cada vez, até que o caminho para o destino esteja desimpedido e nenhum ticket reste.\n\nA seção **Não especificado ainda** do mapa é onde essa visão tênue é registrada: a pergunta sob suspeita, a área a revisitar mais tarde. É a fronteira não descoberta _em direção_ ao destino — tudo aqui está no escopo, apenas não nítido o suficiente para virar ticket. Escreva tão livremente ou tão detalhadamente quanto a visão permitir; ela funciona também como uma sinalização para colaboradores lendo sobre o rumo da iniciativa.\n\n**Névoa ou ticket?** O teste é se você consegue formular a pergunta com precisão agora — _não_ se consegue respondê-la agora.\n\n- **Ticket quando** a pergunta já for nítida — mesmo que esteja bloqueada e você não possa agir sobre ela ainda.\n- **Não especificado ainda quando** você ainda não conseguir formulá-la com tanta nitidez. Não pré-fatie a névoa em pedaços do tamanho de tickets: ela é mais rústica do que um ticket, e um trecho de névoa pode ser promovido para vários tickets, ou nenhum, assim que a fronteira o alcançar.\n\n**Não especificado ainda** exclui o que já foi decidido (Decisões até o momento), o que já é um ticket ativo e o que está fora de escopo (a próxima seção).\n\n## Fora de escopo\n\nA névoa só se acumula _em direção_ ao destino. O destino fixa o escopo, de modo que o trabalho além dele está **fora de escopo** — não é névoa e não pertence a **Não especificado ainda**. Ele ganha sua própria seção **Fora de escopo** no mapa: trabalho que você conscientemente descartou _desta_ iniciativa. É o escopo, não a nitidez, que o coloca aqui.\n\nO trabalho fora de escopo nunca é promovido — a fronteira para no destino —, portanto só retorna se o destino for redesenhado, e então como uma nova iniciativa, não uma retomada.\n\nDescartar algo do escopo é um ato de delimitação de escopo, não um passo na rota. Quando um ticket já existente se revelar situado além do destino — incluído erroneamente no mapeamento inicial ou exposto por uma resolução —, **feche-o** (um ticket fechado está inequivocamente fora da fronteira) e deixe uma linha na seção **Fora de escopo**: a essência mais o porquê de estar fora de escopo, linkando o ticket fechado. Ele permanece fora de **Decisões até o momento**, que registra a rota efetivamente percorrida — uma divisa de escopo não é um passo nela.\n\n## Invocação\n\nDois modos. De qualquer forma, **nunca resolva mais de um ticket por sessão** — com exceção dos tickets de pesquisa.\n\n### Traçar o mapa\n\nO usuário invoca com uma ideia vaga.\n\n1. **Nomeie o destino.** Execute uma sessão de `\u002Fgrilling` e `\u002Fdomain-modeling` para fixar até onde este mapa está encontrando o caminho — a spec, decisão ou alteração. O destino fixa o escopo, portanto é resolvido primeiro.\n2. **Mapeie a fronteira.** Sabatine novamente, desta vez **em largura (breadth-first)**: espalhe-se por todo o espaço em vez de se aprofundar em qualquer linha única, trazendo à tona as decisões em aberto e os primeiros passos viáveis agora. **Se isso não revelar nenhuma névoa** — o caminho até o destino já estiver claro, toda a jornada for pequena o suficiente para uma sessão —, você não precisa de um mapa. Pare e pergunte ao usuário como ele gostaria de prosseguir.\n3. **Crie o mapa** (label `wayfinder:map`): Destino e Notas preenchidos, Decisões até o momento vazias, a névoa esboçada em **Não especificado ainda**.\n4. **Crie os tickets que você pode especificar agora** como issues filhas do mapa — e então conecte as arestas de bloqueio em uma **segunda passada** (as issues precisam de ids antes de poderem referenciar umas às outras). A conexão as organiza na fronteira e nos bloqueados; tudo o que você ainda não puder especificar permanece na névoa — a seção **Não especificado ainda**.\n5. **Dispare os subagentes de pesquisa.** Para cada ticket `research` criado, inicie um subagente `\u002Fresearch` para resolvê-lo em paralelo, capturando suas descobertas em um branch descartável `research\u002F\u003Cname>` com um ponteiro de contexto a partir do ticket.\n6. Pare — traçar o mapa é o trabalho de uma sessão; não resolve nada manualmente.\n\n### Trabalhar através do mapa\n\nO usuário invoca com um mapa (URL ou número). Um ticket é **opcional** — sem um, você escolhe a próxima decisão, não o usuário.\n\n1. Carregue o **mapa** — a visão em baixa resolução, não o corpo de todos os tickets.\n2. Escolha o ticket. Se o usuário nomeou um, use-o. Caso contrário, pegue o primeiro ticket da fronteira em ordem. **Reivindique-o**: atribua-o a si mesmo antes de qualquer trabalho.\n3. Resolva-o — **aprofunde conforme necessário (zoom as needed)**: busque o corpo completo de qualquer ticket relacionado ou fechado sob demanda; invoque as skills que o bloco `## Notas` nomeia. Em caso de dúvida, use `\u002Fgrilling` e `\u002Fdomain-modeling`.\n4. Registre a resolução: publique a resposta como um **comentário de resolução**, **feche** a issue e **anexe um ponteiro de contexto** às Decisões até o momento do mapa.\n5. Adicione tickets recém-surgidos (criar e depois conectar); promova qualquer névoa que a resposta tenha tornado especificável, limpando cada trecho promovido de **Não especificado ainda** para que ele viva apenas como seu novo ticket. Se a resposta revelar que um ticket — este ou outro — fica além do destino, **descarte-o do escopo** em vez de resolvê-lo na rota. Se a decisão invalidar outras partes do mapa, atualize ou exclua esses tickets.\n\nO usuário pode executar tickets desbloqueados em paralelo, portanto espere que outras sessões estejam editando o tracker simultaneamente.\n",{"name":5,"description":7,"disable-model-invocation":24},true,"main","856f969876d3661ac06e93e82beda8904677c957","skills\u002Fengineering\u002Fwayfinder","https:\u002F\u002Fgithub.com\u002Fmatheusdmlopes\u002Fskills-ptbr","https:\u002F\u002Fgithub.com\u002Fmatheusdmlopes","matheusdemarcolopes.com.br","Developer","2026-08-16 10:59:19",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":24},[35,38,41],{"tool":36,"command":37},"npx","npx skills add matheusdmlopes\u002Fskills-ptbr --skill wayfinder",{"tool":39,"command":40},"bunx","bunx skills add matheusdmlopes\u002Fskills-ptbr --skill wayfinder",{"tool":42,"command":43},"pnpm","pnpm dlx skills add matheusdmlopes\u002Fskills-ptbr --skill wayfinder","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmatheusdmlopes\u002Fskills-ptbr\u002Fblob\u002Fmain\u002Fskills\u002Fengineering\u002Fwayfinder\u002FSKILL.md",[46],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"agents\u002Fopenai.yaml","REFERENCE","参考文档",156,"https:\u002F\u002Fgithub.com\u002Fmatheusdmlopes\u002Fskills-ptbr\u002Fblob\u002Fmain\u002Fskills\u002Fengineering\u002Fwayfinder\u002Fagents\u002Fopenai.yaml",[53,60,67,74,81,88],{"skillNo":54,"name":55,"nameZh":6,"description":56,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":19},"01M7APGYCEMRP2Z8R926B42PB9","writing-for-agents","Redação de documentos para agentes. Use ao criar ou editar skills, ou ao modificar AGENTS.md ou CLAUDE.md.","https:\u002F\u002Fgithub.com\u002Fmatheusdmlopes\u002Fskills-ptbr\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fwriting-for-agents\u002FSKILL.md",[],[],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":19},"01M7APGVKK4MRXM4Z61E75VNH2","wait-what","Pare. A última mensagem não ficou clara — reformule a explicação.","https:\u002F\u002Fgithub.com\u002Fmatheusdmlopes\u002Fskills-ptbr\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fwait-what\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":19},"01M7APGR9YYE8YW1ZX7NRACGME","to-questionnaire","Transforme uma decisão que você não consegue responder totalmente em um questionário para outra pessoa preencher.","https:\u002F\u002Fgithub.com\u002Fmatheusdmlopes\u002Fskills-ptbr\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fto-questionnaire\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":19},"01M7APGMHE0796QV2S13AP98AP","teach","Ensine ao usuário uma nova habilidade ou conceito, dentro deste workspace.","https:\u002F\u002Fgithub.com\u002Fmatheusdmlopes\u002Fskills-ptbr\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fteach\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":19},"01M7APGJKKE94TRFCEXB8VE8VW","handoff","Compacte a conversa atual em um documento de handoff para outro agente assumir.","https:\u002F\u002Fgithub.com\u002Fmatheusdmlopes\u002Fskills-ptbr\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fhandoff\u002FSKILL.md",[],[],{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":19},"01M7APGFMVWCEAH0SV5SHZGZE7","grilling","Sabatine o usuário implacavelmente sobre um plano, decisão ou ideia. Use quando o usuário quiser estressar seu raciocínio ou usar qualquer frase de ativação com 'grill'.","https:\u002F\u002Fgithub.com\u002Fmatheusdmlopes\u002Fskills-ptbr\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fgrilling\u002FSKILL.md",[],[]]