Método de Planejamento de Viagem Profunda
Fluxo de Trabalho
Faça em ordem. Pular etapas geralmente resulta em problemas concentrados em algum dia posterior.
Ramificação Prévia: Destino Indefinido
Quando o usuário apenas perguntar "Para onde ir em outubro?", não pule para a organização diária de roteiro. Use a etapa 0,5 do estilo de viagem para dar 3 destinos candidatos, e para cada um, escreva as compensações específicas: clima e riscos sazonais do local, faixa de orçamento, dificuldade de verificação de visto com base no passaporte do usuário, duração do voo/carga de escalas. Não afirme conclusões de visto diretamente; indique a fonte oficial de verificação. Após o usuário escolher o destino, prossiga para a etapa 0.
Etapa 0: Fixe Primeiro as Restrições Rígidas
Itens já pagos e reservados são a base, não variáveis. Primeiro, pergunte e escreva no topo:
- Acomodações reservadas (endereço, horário de check-in/check-out, prazo de cancelamento, preço final)
- Transporte já reservado ou bloqueado (horários de voo, horários específicos de chegada/partida)
- Número de acompanhantes, itens obrigatórios claros e itens claramente sem interesse
- Se há condições físicas que alteram as opções (altura, mobilidade, tatuagens, restrições alimentares, enjoo, crianças, idosos) — estas frequentemente determinam silenciosamente se várias opções são viáveis
Execute ${CLAUDE_SKILL_DIR}/scripts/trip_dates.py <código_do_país> <data_início> <data_fim>, não calcule mentalmente o dia da semana. Ele fornecerá, após verificação horária via rede, o dia da semana para cada data, feriados e pontes. Se o script estiver ausente, não puder ser executado ou a verificação de relógio falhar, pare o planejamento relacionado a datas: informe claramente ao usuário que as datas não foram verificadas e exija a instalação do diretório completo da habilidade (incluindo scripts/) ou um calendário verificável; nunca use cálculo mental. Ainda verifique: as datas fornecidas já passaram? Os dias da semana correspondem às menções do usuário ("visitar algo no fim de semana", mas o dia é quarta-feira)? Se não corresponder, pergunte antes de agir — fazer um guia completo com anos errados significa refazer tudo.
Defina o "ponto de origem". A rota de cada dia se expande a partir de um ponto de partida fixo: em itinerários urbanos, geralmente a estação mais próxima da acomodação; em viagens de carro, a própria acomodação (mais condições de estacionamento); em itinerários de múltiplas cidades, cada trecho tem seu próprio ponto de origem. Uma vez que o ponto de origem é definido, a fluidez está praticamente determinada.
Se o usuário ainda não reservou acomodação, primeiro vá para "decisão de acomodação" (veja references/lodging-decisions.md), pois toda a logística subsequente depende disso.
Etapa 0,5: Esclareça o Estilo de Viagem, Converta Preferências em Números
Esta etapa determina o que será preenchido em todos os limites futuros. Pular isso fará com que suas preferências padrão sejam escritas como as do usuário.
Na mesma viagem, um casal que quer comer em todos os restaurantes com estrela Michelin e um grupo de amigos que só quer fazer compras devem gerar guias completamente diferentes. Portanto, pergunte (ou deduza a partir do que o usuário já disse; se não puder deduzir, pergunte diretamente):
| O que perguntar | O que determina |
|---|---|
| Ritmo: Quantos pontos por dia? Disposto a acordar cedo? | Quantas partes por dia, quanto espaço de manobra |
| Importância da comida: É o foco da viagem ou apenas reabastecimento? | Quantas refeições formais agendar, se deve amarrar a rota a reservas de restaurante |
| Tolerância a filas: Quanto tempo está disposto a esperar por uma loja que realmente quer? | O número máximo de fila |
| Peso das compras: Vai comprar muito ou só dar uma olhada? | Flexibilidade de orçamento, franquia de bagagem, se o processo de devolução de impostos deve ser destacado |
| Postura orçamentária: Prioriza economia, experiência ou é indiferente? | Se deve gastar dinheiro para ganhar tempo |
| Preferência por certeza: Gosta de tudo reservado ou prefere espaços em branco? | Quantas reservas, quantas opções deixar como alternativas |
Converta as respostas em números específicos e escreva-os no guia, não os deixe como adjetivos. "Não gosta de filas" vira "se a fila ultrapassar X minutos, vá para a próxima"; "quer comer bem" vira "agende N refeições formais que precisam de reserva, o restante em faixa de preço normal".
Para itens sobre os quais o usuário não se manifestou, use o valor padrão mais simples e explique sua suposição, para que ele possa descartá-lo facilmente.
Etapa 1: Defina os Dias Principais e as Regras de Troca
Há sempre alguns itens no itinerário que são regidos pelo clima/estação (ver montanhas, mar, folhas de outono/cerejeiras, mirantes ao ar livre, fotografia externa). Para cada um, designe um dia principal e indique claramente com quais dias pode ser trocado.
Os dias principais devem ser priorizados em dias úteis, evitando fins de semana e feriados locais. As regras de troca devem ser frases executáveis, como "Na noite de 16/11, tome a primeira decisão; na noite de 17/11, tome a decisão final; primeiro, lide com a reemissão dos bilhetes", não "decida conforme o tempo".
Etapa 2: Organize Dia a Dia e Escreva os Níveis de Corte
Produza por dia: uma tabela de horários → ações, mais três itens:
- Ordem sem retorno — verifique no mapa, não imagine apenas lendo endereços. Complete uma área de uma vez.
- Obrigatório manter / Pode ser totalmente removido — marque claramente a cada dia. O cansaço e o tempo certamente consumirão alguns itens; decida com antecedência quem sacrificar, é melhor do que decidir na hora.
- Plano B para o clima — uma linha por dia, baseada nos riscos climáticos reais do destino (chuva, neve, calor extremo, vento forte, temporada de tufões). Não é "se chover, vá para lugares fechados", mas sim para onde exatamente.
Custos ocultos da rota: tempo de transferência, tempo para encontrar a saída, tempo para entrar em uma loja em um shopping, tempo para estacionar. Deixe um buffer não alocado por dia, cujo tamanho é definido pela preferência de ritmo do usuário — pessoas apressadas deixam menos, mas aceitam o risco de atrasos em cadeia; pessoas que viajam devagar deixam mais. Sem buffer, o primeiro atraso se propagará até a noite.
Dias de chegada e partida não devem ter itens rígidos. No dia de chegada, não agende refeições formais não canceláveis, horários de ouro apertados, nem coloque o único item obrigatório após o pouso; coloque bagagem, imigração, atrasos e recuperação de fuso horário no buffer. Em fusos horários, na primeira noite, priorize caminhadas leves, refeições e sono cedo; nos dois dias seguintes, volte gradualmente ao ritmo normal. O dia de partida segue o mesmo princípio: calcule o horário de partida para trás com base nos requisitos da companhia aérea, aeroporto e operadora de transporte; coloque apenas atividades que podem ser removidas a qualquer momento antes disso; não trate devolução de impostos, devolução de carro, armazenamento ou compras finais como "coisas que dá para fazer no caminho".
Etapa 3: Verifique Cada Loja (Esta é a etapa mais fácil de negligenciar e a mais valiosa)
Verificar se está "em funcionamento" é inútil. O que precisa ser verificado é "o dia da semana planejado, se a loja está aberta naquele dia, e se o horário planejado de chegada está dentro do horário de funcionamento".
Veja o método completo em references/verification.md. Conjunto mínimo obrigatório:
- Para cada loja, verifique o dia da semana da data planejada e o horário de funcionamento e dia de fechamento
- Verifique os feriados locais e pontes durante o período da viagem — pontes aumentam a lotação em estações, atrações, armários e aeroportos
- Verifique se há mudanças de regulamentações em vigor durante a viagem (devolução de impostos, vistos, procedimentos de entrada, regras de bilhetes)
- Verifique se o período real de floração/abertura de itens sazonais cobre suas datas; não presuma que "estando na estação, está disponível"
- Verifique se há dias especiais locais dentro do seu itinerário (festivais, datas comemorativas, início de ano letivo, grandes feiras)
Etapa 4: Especifique o Transporte por Trecho
A partir do ponto de origem, especifique a ida e a volta de cada dia. Para transporte público, escreva como "linha + estação de transferência + duração + preço". Para carro, escreva como "rota + tempo de viagem + estacionamento + custo".
Detalhes em references/transit-and-maps.md. Princípio geral: Após cada trecho, pergunte-se "Uma pessoa que não conhece o caminho consegue seguir esta instrução?" — "Pegue o metrô, é fácil" não é suficiente; "Pegue a linha X, parador, direto para a estação Y, 20 minutos, 0 transferências, o expresso não para, verifique a indicação na frente do trem antes de embarcar" é suficiente.
Critério para bilhetes: Por padrão, pague por viagem; compre passe apenas no dia/trecho em que valer a pena, e mostre o cálculo para o usuário.
Etapa 5: Mapa no Terreno
Um guia que fica apenas no documento não está completo. Veja o "Método de Três Camadas de Mapa" em references/transit-and-maps.md. O essencial é: mapas personalizados não podem ser offline nem navegar, então é necessário ter as outras duas camadas em campo.
Etapa 6: Orçamento
Divida em "despesas diretas em moeda local" e "despesas em moeda do destino" e, no final, consolide. Veja references/budget-and-customs.md.
O ponto chave é identificar o único item sem limite superior (geralmente compras), definir três faixas para ele e sugerir que o usuário defina um limite rígido e o anote no celular.
Etapa 7: Tabela de Contagem Regressiva
Reúna todas as datas fixas em uma tabela, ordenada por tempo: data de abertura de venda de ingressos, prazo de cancelamento gratuito, janela de reserva, prazo para criar conta, data de reavaliação próxima.
Preste atenção especial a dois eventos no mesmo dia — por exemplo, prazo de cancelamento e data de venda de ingressos no mesmo dia. Destaque o conflito.
Etapa 8: Autoavaliação Antes da Entrega
Revise ponto a ponto a tabela de restrições rígidas da Etapa 0 e os números de preferência da Etapa 0,5, verificando se cada dia os viola. Em seguida, aplique as sete verificações de "revisão de um guia existente" ao seu próprio rascunho: contradições internas, rotas desnecessárias, retroalimentação, lacunas de verificação, vazios, planos para dias de risco, expectativas desalinhadas.
Deixe o resultado desta autoavaliação no final da entrega. Não faça a verificação silenciosamente; o usuário precisa saber quais restrições rígidas foram atendidas e quais informações ainda estão marcadas para reavaliação antes da partida.
Regras de Decisão ao Longo de Todo o Processo
Estas regras servem para transformar "vamos ver na hora" em "na hora, siga esta instrução".
⚠ Horários de funcionamento, dias de fechamento, preços e tarifas, duração e número de transferências, regras de reserva e horários de abertura, feriados, períodos reais de previsão sazonal, acessibilidade e presença de rampas/degras — devem ter uma fonte verificada desta vez. Valores "lembrados" dos dados de treinamento são considerados desatualizados: estes campos mudam a qualquer momento, e o modelo não sabe de que ano são suas lembranças. Se não puder escrever a fonte, não escreva o número; reescreva como "revisar X dias antes da partida" e indique onde revisar. Uma lacuna honesta é mais útil do que um erro confiante.
⚠ Todos os números mencionados abaixo são placeholders, não valores recomendados. Eles devem vir das preferências do usuário obtidas na Etapa 0,5. Escrever as preferências de outra pessoa como padrão é o erro mais comum desta habilidade.
Os limites específicos para filas, opções, refeições, reservas, retroalimentação, gastar dinheiro para ganhar tempo, fechamento A/B e divisão de fontes de informação estão em references/decision-thresholds.md. Leia antes de começar a organizar o roteiro ou dar conclusões de escolha; a externalização é para aliviar o arquivo de entrada, não para afrouxar as regras.
Formato de Saída
Por padrão, produza um documento de guia em Markdown, a menos que o usuário especifique outro formato. O esqueleto de saída, modelo diário, tabela de contagem regressiva, método de geração de bagagem e cartão de emergência estão em assets/planning-templates.md; adicione ou remova conforme o foco do itinerário; não invente informações apenas para preencher o modelo.
Ajustes comuns: quando a comida é o foco, abra um banco separado de opções de restaurantes; quando as compras são o foco, abra seções separadas de comparação de preços, devolução de impostos e franquia de bagagem; viagens de carro reescrevem para trechos, estacionamento, combustível, condições da estrada e navegação offline; múltiplas cidades são divididas por cidade; com crianças ou idosos, adicione pontos de descanso próximos a cada dia e reduza o ritmo geral.
Primeiro, dê a conclusão, depois os motivos; cada sugestão deve vir com condições de execução; para incertezas, indique o momento e o local de reavaliação; ao modificar um guia existente, altere diretamente o arquivo original, não crie um documento paralelo.
Ao Revisar um Guia Existente
Quando o usuário tiver um itinerário pronto e perguntar "Tem algum problema?", procure nesta ordem, do maior para o menor benefício:
- Contradições internas — Duas atividades no mesmo dia com horários conflitantes ("14:30–15:00 andar na Rua A" e "14:40 precisa estar em B")
- Rotas desnecessárias — Há uma opção de transferência mais curta, mas escreveu a mais longa
- Retroalimentação inviável — O horário de partida escrito não permite chegar ao horário de ouro definido
- Lacunas de verificação — Não verificou o dia da semana, não verificou pontes, não verificou mudanças de regulamentação
- Vazios — Um período inexplicável de 50 minutos entre duas atividades
- Dia de risco sem plano — Especialmente dias de chegada e partida
- Expectativas desalinhadas — O usuário espera ver algo, mas a estação/horário real não corresponde
- Sobrecarga ou contradição óbvia — Por exemplo, 10 dias com 12 cidades. Aponte claramente por que não é viável, dê alternativas específicas e, em seguida, continue conforme a decisão do usuário; apenas avise, não bloqueie, não peça confirmação novamente e não insista.
Ao apontar problemas, dê alternativas; não diga apenas "aqui tem um problema". E melhore diretamente o documento original, em vez de listar os problemas para o usuário resolver.
Arquivos de Referência
Leia quando necessário, não todos de uma vez:
references/verification.md— Verificação de lojas, feriados e pontes, mudanças de regulamentação, gerenciamento de expectativas sazonais, retroalimentação de horários de ouro, uso e limites de redes sociais. Leitura obrigatória na Etapa 3.references/transit-and-maps.md— Escrita de transporte a partir do ponto de origem, cinco armadilhas do transporte público, pontos chave para viagens de carro, cálculo de passes, ferramentas de mapas locais, método de três camadas de mapa. Leitura obrigatória nas Etapas 4 e 5.references/lodging-decisions.md— Comparação de preços finais com impostos, limite para troca de acomodação, armadilhas nas descrições de instalações das plataformas, relação entre localização e logística. Leia quando o usuário perguntar "Este hotel é bom? Devo trocar?"references/budget-and-customs.md— Estrutura de orçamento, faixas de compras, limites de isenção alfandegária, dinheiro e pagamentos, franquia de bagagem. Leia na Etapa 6.references/entry-and-health.md— Verificação de visto/autorização eletrônica por nacionalidade, registro de entrada, saúde, validade do passaporte e seguro. Leia após a definição do destino, antes de comprar passagens; nunca afirme conclusões de visto diretamente.references/decision-thresholds.md— Limites para filas/reservas/retroalimentação/troca de acomodação, e divisão de fontes de informação entre redes sociais, sites oficiais, plataformas e mapas. Leia antes de começar a organizar o roteiro ou comparar opções.assets/planning-templates.md— Esqueleto de saída, modelos diários e de contagem regressiva, método de geração de bagagem, cartão de emergência com números a preencher. Leia ao começar a escrever.