Spotter

Onde: botão circular no canto inferior direito do Coach

Visão geral

O Spotter é o assistente de autoria do Coach. Ele transforma o treino que você escreve em uma proposta de sessão para o dia aberto no Construtor, ou sugere uma sessão a partir de um objetivo e das referências revisadas pelo head coach.

O painel tem duas abas. Montar prepara a proposta de sessão. Conversar é uma conversa livre sobre o programa aberto: o Spotter lê a semana, os dias, a Biblioteca e as fichas do método, responde e sugere.

O Spotter não salva nem publica. Você confere a proposta, decide se ela entra no rascunho e usa o fluxo normal do Construtor para salvar o dia.

Quando usar

• Quando você já escreveu o treino e quer passá-lo para o Construtor.
• Quando quer partir de um objetivo, uma duração e um público para preparar uma proposta.
• Quando o nome de um movimento é ambíguo e você quer escolher a opção certa da Biblioteca.
• Quando quer conferir as quantidades de uma sessão existente ou propor uma alteração localizada.
• Quando quer perguntar sobre o programa — o volume da semana, um dia, os movimentos da Biblioteca ou o método do box — antes de decidir o que montar. Use a aba Conversar.

Analisar e alterar uma sessão existente (experimental)

Esta integração começa pela sessão selecionada. O restante do dia dá contexto, mas não pode ser alterado pelo pedido. Ela depende da versão publicada do Coach e da API; não está disponível apenas por este documento existir.

1. Abra o dia no Construtor, selecione a sessão ou um bloco dela e termine os campos obrigatórios.
2. Abra o Spotter e use Analisar sessão. Essa leitura calcula quantidades do rascunho sem chamar um modelo.
3. Para uma mudança, escreva um pedido explícito, como “No bloco 2, altere o limite para 12 minutos”, e peça a proposta. Essa etapa pode usar o serviço de IA configurado.
4. Confira cada campo no antes e depois. Marque a confirmação somente depois de revisar todas as mudanças.
5. Aplique ao rascunho. Para persistir, continue usando Salvar no Construtor: o Spotter não salva nem publica.

Nesta primeira versão, as alterações permitidas são notas da sessão, notas do bloco e limite de tempo de AMRAP ou For Time padrão. Ela não altera movimentos, cargas, séries, repetições, estrutura, EMOM, Tabata ou HIIT. Um pedido com partes não suportadas deve ser recusado inteiro, não aplicado parcialmente.

As quantidades ficam separadas por movimento, unidade e público. Num AMRAP, a quantidade escrita é por passagem, não uma previsão de quantas voltas o atleta fará. Volume máximo, complexos e dados insuficientes podem aparecer sem total calculável. Percentuais de carga não viram quilogramas estimados.

Quando habilitada, a revisão Jev compara fidelidade do pedido, tempo e notas. Ela pode indicar informação insuficiente. Não aprova metodologia, não certifica segurança física e não autoriza aplicação. Tags e rubricas metodológicas propostas continuam fora das recomendações até aprovação humana.

Se você mudar o dia, a organização, a seleção ou o rascunho, gere uma nova proposta. Não existe aplicação forçada sobre uma versão diferente. Desfazer só funciona enquanto nenhuma edição posterior ocorreu. Fechar o painel descarta a análise, mas não reverte uma alteração já aplicada ao rascunho. O modo de demonstração local não simula uma análise como se fosse resposta real da API.

📸 Screenshot pendente

assets/23-spotter-sessao.png — análise, antes/depois e confirmação da sessão selecionada.

Pré-requisitos

• Sua conta precisa ter permissão para autorar treinos.
• O Spotter precisa estar habilitado no ambiente. Se não estiver, o botão não aparece.
• Para pedir ou adicionar uma sessão, abra o destino no Construtor: programa, semana e dia.

Passo a passo (por região)

Abrir e escolher o modo

📸 Screenshot pendente

assets/23-spotter-painel.png — botão circular e painel com o destino e os modos Transcrever e Sugerir.

1. Abra o dia que receberá a sessão no Construtor.
2. Clique no botão circular do Spotter, no canto inferior direito.
3. Confira o Destino no alto do painel.
4. Escolha Transcrever para passar um treino já escrito ou Sugerir para partir de um objetivo.

Se nenhum dia estiver aberto, o painel mostra Abrir o Construtor. Abra o destino antes de enviar.

Pedir e esclarecer

1. Escreva o pedido com as informações que já decidiu: movimentos, volume, carga, relógio, duração, público e observações.
2. Clique em Enviar ou use Ctrl+Enter — no Mac, ⌘Enter.
3. Se o Spotter perguntar qual movimento você quis dizer, escolha uma das opções exibidas.
4. Continue a conversa para ajustar a proposta. Use Nova conversa quando quiser começar outro pedido.

Dica

em Sugerir, informe objetivo, duração, público e equipamentos. Quanto mais explícito o pedido, menos decisões ficam como suposição.

Revisar e adicionar

📸 Screenshot pendente

assets/23-spotter-proposta.png — proposta pronta com blocos, suposições, fontes e ações.

1. Leia o título, os blocos, o relógio, as quantidades e as cargas.
2. Confira Suposições e Fontes, quando aparecerem.
3. Clique em Adicionar ao rascunho somente quando a proposta estiver correta.
4. Revise a sessão dentro do Construtor e salve o dia pelo fluxo normal.

Depois de adicionar, você pode clicar em Desfazer enquanto o rascunho continuar exatamente no estado depois da inserção. Descartar encerra aquela proposta sem alterar o dia.

Revisão complementar do pedido (experimental)

Quando habilitada pelo ambiente, a proposta mostra Revisão do pedido: movimentos, séries e repetições, cargas, descansos e restrições do pedido. Cada dimensão pode indicar Sem divergência identificada, Possível divergência — confira ou Informação insuficiente. Esse resultado vem de uma avaliação separada da geração: é uma indicação para conferir, não prova de que o treino está correto.

Revisão indisponível significa que essa comparação falhou; a proposta continua disponível. Essa etapa não analisa o treino já aberto, não aprova metodologia/segurança e não modifica ou bloqueia o rascunho. A decisão de adicionar, salvar e publicar continua sua. No modo de teste silencioso, o ambiente só mede resultados e custo, sem mostrar a revisão no painel.

📐 Regra de negócio

o Spotter prepara e explica; quem decide é você. Gerar uma proposta não escreve nada no dia. Adicionar mexe apenas no rascunho aberto. Salvar e publicar continuam sendo ações separadas.

Conversar

📸 Screenshot pendente

assets/23-spotter-conversar.png — aba Conversar com uma pergunta, a linha “Lendo” e a resposta com Levar ao Montar.

1. Abra um dia do programa no Construtor e clique no botão do Spotter.
2. Clique na aba Conversar. A linha Lendo mostra o programa, a semana e o dia de que o Spotter parte.
3. Escreva a pergunta, ou clique numa das sugestões: Como está o volume desta semana?, Que variações de terra temos na Biblioteca? ou Revise o dia de hoje.
4. Acompanhe a resposta. Enquanto consulta o Rig, o Spotter diz o que está lendo — Lendo a semana, Lendo o dia, Buscando na Biblioteca ou Lendo as fichas do método — e escreve a resposta aos poucos.
5. Continue perguntando na mesma conversa. Use Nova conversa para começar outra.
6. Para montar o que ele sugeriu, clique em Levar ao Montar: o texto vai para o pedido da aba Montar, em Transcrever. Revise o pedido e clique em Enviar quando quiser a proposta.

A conversa continua quando você troca de dia no Construtor: a linha Lendo acompanha o dia aberto, e a próxima pergunta parte dele.

📐 Regra de negócio

a conversa só lê. O Spotter não salva, não publica e não altera nada no Rig, e não tem acesso a resultados, marcas ou dados de atletas — pergunte sobre o programa, a Biblioteca e o método. Levar ao Montar não envia nada: só preenche o pedido para você revisar.

Dica

a resposta separa o que vem das fichas do método do box do que é conhecimento geral. Quando a decisão for de metodologia, confira a ficha citada.

Campos & validações

Campo ou ação	O que é	Obrigatório	Regra
Destino	Programa, semana e dia abertos	Sim	A proposta só entra no mesmo destino em que foi pedida
Transcrever	Converte um treino já definido em sessão	Um dos modos	Usa movimentos autorizados da Biblioteca
Sugerir	Prepara uma sessão a partir de objetivo e contexto	Um dos modos	Usa apenas referências disponíveis e revisadas
Pedido	O texto enviado ao Spotter	Sim	Até 8.000 caracteres
Escolha de movimento	Confirma qual movimento você quis dizer	Quando solicitado	Só a pergunta mais recente pode ser respondida
Adicionar ao rascunho	Insere a sessão proposta no dia aberto	Não	Não salva nem publica o dia
Pergunta (Conversar)	O que você pergunta na aba Conversar	Sim	Até 8.000 caracteres; precisa de um dia aberto
Levar ao Montar	Copia a resposta para o pedido da aba Montar	Não	Não envia; você revisa e envia

Estados

• Sem dia aberto: mostra o atalho Abrir o Construtor; não envia pedidos.
• Preparando proposta: mantém o painel aberto, mostra o estado de espera e oferece Cancelar.
• Precisa de resposta: mostra a pergunta e, quando houver, as opções de movimento.
• Proposta pronta: mostra a sessão, as suposições, as fontes e a ação de adicionar.
• Rascunho mudou: pede uma nova conferência antes de adicionar sobre a versão atual.
• Outro dia aberto: preserva a proposta e orienta você a voltar ao destino original.
• Erro: mantém o pedido para nova tentativa e explica se houve limite, sessão expirada, indisponibilidade ou falta de permissão.
• Conversar · vazia: mostra a abertura e as três sugestões.
• Conversar · lendo o Rig: diz o que o Spotter está consultando e escreve a resposta aos poucos; Cancelar para de esperar e devolve a pergunta ao campo.
• Conversar · resposta pronta: mostra a resposta e Levar ao Montar.
• Conversar · resposta cortada: a resposta passou do tamanho de uma vez; peça para continuar.
• Conversar · sem resposta: explica o motivo e oferece Tentar de novo.

Dicas

Dica

feche o painel sem medo: a conversa e o texto ficam guardados enquanto você continua logado. Pressione Escape para fechar e voltar ao botão do Spotter.

Cuidado

cancelar para de esperar e devolve o texto ao campo. Isso não cancela nem desfaz uma proposta que você já adicionou ao rascunho.

Erros comuns / troubleshooting

O Spotter reconhece os nomes equivalentes aprovados para supino com barra, desenvolvimento militar com barra e terra de arranco, mantendo o nome que você tem na Biblioteca. Se houver dois registros equivalentes, eles continuam ambíguos: não são fundidos nem escolhidos automaticamente. No piloto de curadoria, um responsável autorizado pode revisar uma equivalência para sua organização. Uma equivalência aprovada preserva o movimento mesmo após uma correção de nome; se for retirada ou se seus atributos mudarem, deixa de fornecer a associação ao Spotter. A aba Identidades do Spotter, na Biblioteca, permite ao Head Coach consultar evidências, registrar propostas e confirmar decisões com justificativa. Uma proposta não ativa o vínculo.

• O botão não aparece: o Spotter não está habilitado neste ambiente ou o status não pôde ser consultado.
• O envio está bloqueado: abra um dia no Construtor e escreva um pedido.
• “Muitos pedidos em pouco tempo”: espere um minuto e tente de novo; o texto continua no painel.
• “O crédito do Spotter neste mês acabou”: o Spotter volta quando o mês virar; até lá, monte o treino no Construtor, que segue funcionando.
• A aba Conversar não envia: abra um dia no Construtor — a conversa parte do programa aberto.
• A proposta não pode ser adicionada: volte ao programa, semana e dia indicados em Destino.
• O rascunho mudou durante a resposta: confira de novo e use Conferi, adicionar somente se a proposta ainda fizer sentido ao lado das suas edições.

Como o atleta vê

O atleta não vê o Spotter nem a conversa. Ele vê apenas o treino que você revisou, salvou e publicou pelo fluxo normal do Construtor.