![](data:image/svg+xml;utf8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="%23D95C41" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><line x1="12.1" y1="11.9" x2="18.9" y2="8.2" /><line x1="12.1" y1="12.1" x2="20.3" y2="12.9" /><line x1="12.2" y1="12.4" x2="16.6" y2="19.1" /><line x1="11.8" y1="12.4" x2="7.3" y2="19.2" /><line x1="11.9" y1="12.1" x2="3.7" y2="13.3" /><line x1="11.8" y1="11.7" x2="7.8" y2="4.4" /></svg>)
Aulas relacionadas: Aula 05. Mantenha o contexto ativo ao longo das sessões. · Aula 06. Inicializar antes de cada sessão do agente. Arquivos de template: templates/
Projeto 03. Mantenha o Agente Trabalhando Entre Reinicializações de Sessão
O Que Você Vai Fazer
Adicione controle de escopo e gates de verificação ao agente. Implemente fragmentação de documentos (chunking), extração de metadados, exibição do progresso de indexação e fluxo de perguntas e respostas baseado em citações. Utilize feature_list.json para acompanhar o status das funcionalidades — uma funcionalidade por vez, sem marcar como "pass" sem evidências de verificação.
Você irá comparar o starter e a solution versionados: o starter possui apenas a superfície inicial de rastreamento, enquanto a solution adiciona artefatos mais rigorosos de reinicialização e handoff em torno da mesma lista de funcionalidades.
Ferramentas
- Claude Code ou Codex
- Git
- Node.js + Electron
Mecanismo do Harness
Log de progresso + handoff de sessão + continuidade entre múltiplas sessões + verificação de uma funcionalidade por vez
Utilize o Projeto Versionado
Caminho do repositório: projects/project-03/
| Diretório | O que contém | O que comparar |
|---|---|---|
starter/ | Código do Projeto 02 com indexação e grounded QA ainda incompletos. Possui um feature_list.json inicial, mas não contém os artefatos finais de reinicialização/handoff. | Verificar se o agente se desvia entre múltiplas funcionalidades ou perde estado após uma reinicialização. |
solution/ | Implementação concluída de chunking, metadados, status de indexação e QA baseado em citações, além de init.sh, session-handoff.md, claude-progress.md e clean-state-checklist.md. | Verificar se cada funcionalidade possui evidências concretas de verificação antes de ser marcada como concluída. |
Este projeto não é um exercício genérico de “múltiplas sessões”. A solução versionada corresponde a quatro funcionalidades específicas do produto: fragmentação de documentos, extração de metadados, interface de status de indexação e perguntas e respostas baseadas em contexto com citações.