Mapa da trilha
Conteúdo detalhado
2.1~35 min
🧰 Pré-requisitos e contas
O mise en place: o que instalar, as contas (Supabase, Telegram, OpenAI/Gemini, WHOOP) e o ~/.env com todas as chaves no lugar antes de codar.
Progresso0 de 7 · 0%
O que é: As ferramentas-base na máquina: Python 3, git e a CLI do agente (Claude Code).
Por que aprender: Sem o ambiente pronto, nenhum comando dos próximos passos roda.
Conceitos-chave: Python 3 · git · venv.
O que é: Criar um projeto grátis no Supabase, que entrega Postgres + storage prontos.
Por que aprender: É o banco onde todos os seus dados de saúde vão morar.
Conceitos-chave: Projeto · URL · service-role key.
O que é: Falar com o @BotFather pra criar o bot e receber o token de acesso.
Por que aprender: O Telegram é a interface do coach; sem token, não há bot.
Conceitos-chave: BotFather · token · chat_id.
O que é: As API keys do modelo de linguagem e do gerador de embeddings.
Por que aprender: É o "cérebro" e a memória semântica do agente.
Conceitos-chave: API key · embeddings · cota.
O que é: Criar um app no developer portal do WHOOP pra ter client id e secret.
Por que aprender: É o que libera puxar recovery e HRV automaticamente (é opcional).
Conceitos-chave: Client id · secret · OAuth.
O que é: Um arquivo único, fora do repo, que reúne todos os segredos.
Por que aprender: Centraliza as chaves e mantém elas longe do git.
Conceitos-chave: ~/.env · gitignore · segredos.
O que é: A lista que confirma que cada conta e cada chave já existe.
Por que aprender: Pega o que falta agora, antes de você travar no meio do passo.
Conceitos-chave: Contas · chaves · ambiente.
2.2~35 min
🗄️ O banco (Supabase)
As 14 tabelas, o pgvector pra memória, o bucket de storage e o RLS que tranca tudo. Você roda as migrations e confere a conexão.
Progresso0 de 7 · 0%
O que é: Aplicar os arquivos SQL que criam todas as tabelas de uma vez.
Por que aprender: É como o banco sai do zero para o schema completo.
Conceitos-chave: SQL · migration · idempotente.
O que é: As 14 tabelas que guardam wearable, sangue, DNA, dieta e memória.
Por que aprender: Saber onde cada dado mora ajuda a consultar e a debugar.
Conceitos-chave: Schema · relações · chaves.
O que é: A extensão do Postgres que guarda embeddings e busca por similaridade.
Por que aprender: É o que dá memória semântica ao coach.
Conceitos-chave: Extension · vetor · similaridade.
O que é: O bucket onde fotos de comida e PDFs de exame ficam guardados.
Por que aprender: O agente precisa de um lugar para os arquivos brutos.
Conceitos-chave: Bucket · upload · URL assinada.
O que é: Regras que trancam cada linha para só o dono dela conseguir ler.
Por que aprender: Dado de saúde é sensível; o RLS é a tranca por padrão.
Conceitos-chave: Policy · dono · privado.
O que é: Rodar um ping no banco para confirmar que tudo conecta de ponta a ponta.
Por que aprender: Confirma credenciais e rede antes de seguir construindo.
Conceitos-chave: Conexão · service-role · ping.
O que é: Inserir alguns dados de exemplo e o seu perfil inicial.
Por que aprender: Dá ao coach algo para ler já no primeiro dia — com cuidado de privacidade.
Conceitos-chave: Seed · perfil · cuidado.
2.3~35 min
🤖 O agente e o bot
O agent.yaml, o CLAUDE.md com o seu perfil, os slash commands, subir o bot, e como state.py e mem.py dão contexto e memória a cada turno.
Progresso0 de 7 · 0%
O que é: O arquivo que define modelo, ferramentas e parâmetros do agente.
Por que aprender: É o painel de controle de como o agente roda.
Conceitos-chave: Config · modelo · tools.
O que é: O texto com as suas metas, restrições e o estilo do coach.
Por que aprender: É onde a personalização realmente mora.
Conceitos-chave: Perfil · metas · estilo.
O que é: Atalhos no Telegram que disparam rotinas específicas do coach.
Por que aprender: Tornam ações comuns rápidas e consistentes.
Conceitos-chave: Comando · rotina · atalho.
O que é: Rodar o processo que conecta o agente ao Telegram e fica ouvindo.
Por que aprender: É o momento em que o coach fica vivo e responde.
Conceitos-chave: Polling · processo · log.
O que é: O código que monta o retrato compacto do estado atual a cada turno.
Por que aprender: É o que mantém o coach ancorado no contexto de hoje.
Conceitos-chave: Snapshot · contexto · turno.
O que é: A busca por embeddings que traz de volta as memórias relevantes.
Por que aprender: Faz o coach lembrar dos seus padrões antigos.
Conceitos-chave: Recall · embedding · top-k.
O que é: O mapa de pastas e arquivos do agente (scripts, config, módulos).
Por que aprender: Saber a estrutura acelera qualquer mudança que você for fazer.
Conceitos-chave: Pastas · scripts · módulos.
2.4~35 min
⌚ Wearable e agendamento
WHOOP ponta a ponta: OAuth, a autorização única, o whoop-sync.py, os dois gotchas clássicos, e como agendar o sync e o check-in da manhã.
Progresso0 de 7 · 0%
O que é: O fluxo que troca o seu login por um token de acesso ao WHOOP.
Por que aprender: É o portão para puxar os seus dados de recuperação.
Conceitos-chave: OAuth · token · refresh.
O que é: O passo manual que você faz só uma vez no navegador.
Por que aprender: Depois dele, o sync passa a rodar sozinho.
Conceitos-chave: Consent · callback · code.
O que é: O script que baixa recovery, sono e HRV para dentro do banco.
Por que aprender: É o que enche o banco com os dados do dia.
Conceitos-chave: Sync · upsert · API.
O que é: Os dois tropeços comuns: token expirado e fuso horário trocado.
Por que aprender: Saber deles antes evita horas de debug.
Conceitos-chave: Refresh · UTC · timezone.
O que é: Um cron que roda o whoop-sync.py todo dia bem cedo.
Por que aprender: Garante dados frescos antes do check-in da manhã.
Conceitos-chave: Cron · agendamento · log.
O que é: O job que dispara a mensagem de bom-dia do coach com o seu recovery.
Por que aprender: É o gatilho do loop diário de recuperação.
Conceitos-chave: Cron · check-in · push.
O que é: Como adaptar o mesmo padrão de sync para Oura, Garmin ou Apple Health.
Por que aprender: O blueprint não fica preso ao WHOOP.
Conceitos-chave: Adaptar · API · upsert.