E3a · Rode o exemplo
10 minClone o INTELECTO, entre em exemplo-jarvis e rode os testes e o smoke.py.
Pronto quando: os 9 testes passam e o smoke mostra a linha DB com o nome.
Aula 4 · 20 min
Construir sem programar: você escolhe, o agente constrói, o teste confirma
Você não escreve código. Escolhe os ingredientes numa página, como numa mercearia, exporta uma lista e pede ao Claude Code ou ao Codex para construir, seguindo o plano de obra do INTELECTO. Depois prova com os testes e com uma conversa no terminal, antes de ligar no Telegram.
Começar a aula
Nesta aula você vai
- 1A mercearia e o briefing meu-assistente.md
- 2Por que a lista sozinha não basta: o plano de obra
- 3O pedido de construção em uma frase
- 4Provar com os testes e com a conversa no terminal
Objetivo: gerar o briefing na mercearia, pedir ao agente de programação a construção com testes e provar o núcleo com os testes e uma conversa.
01O caminho em cinco passos
Clique em cada bloco. O trabalho pesado é do agente.
Clique em cada bloco do diagrama para ver o que ele faz.
Comece pequeno: poucos ingredientes, testes passando, depois cresça. Dá para voltar à mercearia e acrescentar.
02Cada passo, com o que conferir
Clique em cada etapa.
1. Escolher pouco
Para um primeiro Jarvis, o vídeo de instalação escolheu oito: arquivo de personalidade, bot do Telegram, WhatsApp, memória com busca em SQLite, cofre de segredos cifrado, lista de comandos proibidos, agendamento e skills.
Você pode começar com menos: personalidade, Telegram, memória e cofre.
Pronto quando
O carrinho tem de 4 a 8 itens e você sabe dizer para que serve cada um.
2. Exportar e juntar
Exporte como briefing para o Claude Code e baixe o meu-assistente.md. Clone o repositório do INTELECTO e ponha o briefing dentro da pasta.
Descoberta dos testes: a lista sozinha não basta. O que faz a construção dar certo é o ponteiro para o doc/intelecto.md.
Na pasta
intelecto/ com doc/intelecto.md, reference-repos/ e o seu meu-assistente.md.
3. Pedir com testes
Primeiro peça o plano: o agente lê tudo e devolve arquivos, ordem e perguntas (Docker ou instalação direta? OpenRouter ou Ollama? qual modelo?). Responda em português.
Com o plano aprovado, peça a construção com testes. Aprove cada comando que ele quiser rodar só quando entender o que é.
Se ele errar
Descreva o problema em português e peça para corrigir. Esse ciclo é normal e esperado.
4. Provar
Rode os testes. Depois converse no terminal: "lembre que meu nome é ...", e em seguida "qual meu nome?".
A última linha do exemplo mostra o nome gravado no banco: prova de que não é texto fixo, a memória e o loop funcionam juntos.
Pronto quando
Todos os testes passam e o nome aparece na linha DB.
03Os comandos e o pedido
Rode no terminal, na pasta de projetos.
Terminal · baixar o INTELECTO
git clone https://github.com/inematds/intelecto.git cd intelecto # copie para cá o meu-assistente.md que a mercearia baixou
Pedido 1 · o plano primeiro
Leia o meu-assistente.md e o plano em doc/intelecto.md. Antes de escrever código, me devolva o plano: arquivos, ordem e as decisões que dependem de mim. Use a minha identidade (SOUL, AGENTS, USER e MEMORY que estão em workspace/).
Pedido 2 · construir com testes
Plano aprovado. Construa o meu assistente em Python, com testes, seguindo os contratos do doc/intelecto.md. O bot do Telegram responde só ao meu usuário. Segredos nunca no código. Ao terminar, rode os testes e me mostre o resultado.
Terminal · provar o exemplo do repositório
cd exemplo-jarvis python3 -m unittest discover -s . -p 'test_*.py' -v python3 smoke.py
Exemplo do repositório
USER : lembre que meu nome é Nei JARVIS: Seu nome é Nei. USER : qual meu nome? JARVIS: Seu nome é Nei. DB : ['Meu nome é Nei']
A linha DB prova que o nome foi gravado no SQLite, não veio de texto fixo.
- Memória: salvar → buscar → esquecer.
- Um round completo do loop: o modelo de teste pede uma ferramenta, o loop executa e responde.
- Lista de bloqueio barra o comando perigoso e libera o seguro.
- Configuração vai e volta sem perder nada.
- O contexto contém o SOUL e o USER.
04Prática: construir e provar
Exercício E3 da sequência 2, no caminho que o repositório realmente usa.
E3b · O seu briefing
15 minNa mercearia, marque de 4 a 8 ingredientes e exporte o meu-assistente.md para a pasta do INTELECTO.
Pronto quando: o arquivo está na pasta e cada ingrediente tem o motivo anotado no seu meu-jarvis.md.
E3c · O seu Jarvis construído
1 hCopie a sua pasta workspace/ da aula 2 para o projeto, faça os pedidos 1 e 2 e acompanhe o agente.
Pronto quando: os testes passam e, na conversa no terminal, ele responde com o nome e o jeito que você definiu.
No exercício original o passo é ./start.sh. No repositório de hoje o caminho é este: briefing + plano + agente constrói. O assistente de configuração é uma das peças que o plano manda construir.
05A instalação em vídeo
Da mercearia ao assistente respondendo, com o caminho inteiro na tela.
INTELECTO: instale o seu Jarvis · 5 min 55 sPágina do vídeo com roteiro →
06Teste o que aprendeu
A explicação aparece depois da sua resposta.
Pergunta 1 de 3
Por que entregar ao agente o meu-assistente.md junto com o doc/intelecto.md?competência
Correto
A validação do exemplo descobriu isso: o briefing sozinho é um roteador, não uma receita. Os contratos do plano tornam cada peça implementável.Não é essa
A validação do exemplo descobriu isso: o briefing sozinho é um roteador, não uma receita. Os contratos do plano tornam cada peça implementável.Rever: Cada passo, com o que conferirPergunta 2 de 3
O agente terminou e disse "pronto". Qual a prova de que funciona?
Correto
Você não precisa entender cada linha; precisa do teste. A linha DB do smoke mostra que o fato foi gravado de verdade.Não é essa
Você não precisa entender cada linha; precisa do teste. A linha DB do smoke mostra que o fato foi gravado de verdade.Rever: Os comandos e o pedidoPergunta 3 de 3
Qual é o jeito certo de começar?
Correto
Comece pequeno. A mercearia aceita voltar e acrescentar; o que não dá é depurar 40 peças ao mesmo tempo.Não é essa
Comece pequeno. A mercearia aceita voltar e acrescentar; o que não dá é depurar 40 peças ao mesmo tempo.Rever: O caminho em cinco passosTeste concluído
Você acertou {a} de {n}. Acertando todas, a aula é marcada como concluída.Escolha uma alternativa. A explicação aparece depois da sua tentativa.