O que research-os faz?
Research OS é uma Skill de Agente baseada em batimentos cardíacos para pesquisas que precisam de estado, evidências e continuação limitada.
Visão Geral
Research OS permite que agentes realizem pesquisas complexas com gerenciamento confiável de estado e rastreamento de evidências. Usando heartbeats, a skill garante que as tarefas de pesquisa sejam executadas em ciclos controlados, prevenindo loops infinitos e garantindo conclusão dentro de limites.
Funcionalidades
- Gerenciamento de Estado: Mantém estado persistente entre ciclos de pesquisa.
- Batimentos Cardíacos: Pontos de verificação para controlar a continuação.
- Rastreamento de Evidências: Registra fontes e achados.
- Limites de Escopo: Define tempo máximo ou número de iterações.
- Suporte a Múltiplas Plataformas: Funciona com Claude Code, Cursor, Codex, etc.
Como Funciona
- O agente inicia uma pesquisa com um tópico.
- A cada ciclo, um heartbeat é registrado, salvando estado e evidências.
- Se o agente atinge um limite (tempo ou iterações), a pesquisa pausa com estado preservado.
- O agente pode retomar de onde parou.
Configuração
Configure via RESEARCH_OS_MAX_ITERATIONS (número máximo de iterações) ou RESEARCH_OS_TIMEOUT (tempo máximo em segundos).
Exemplo de Uso
# Iniciar pesquisa
research_os start "Impacto de IA em educação"
# Cada iteração:
# 1. Buscar novas fontes
# 2. Extrair evidências
# 3. Salvar estado
# 4. Verificar heartbeat
Notas
- Mantenha o estado em um arquivo JSON.
- Evidências são armazenadas com metadados (data, fonte).
- Heartbeats são registrados em log para depuração.