Agents Upstream

Sistema de análise de pesquisa com agentes especializados de IA para Product Discovery.

🚀 Instalação Rápida

npx agents-upstream

Isso criará toda a estrutura de pastas, templates e agentes de IA no diretório atual.

📦 O que está incluído?

• 9 Agentes Especializados de IA para análise de problema e solução
• 17+ Templates profissionais para análise estratégica
• Sistema de workflow automatizado com validação de qualidade
• Documentação completa com exemplos e melhores práticas

🎯 O que o sistema faz?

Transforma semanas de análise estratégica em horas, mantendo supervisão e validação humana:

• Analisa entrevistas e dados de pesquisa de usuários
• Identifica automaticamente problemas-chave, oportunidades e insights estratégicos
• Gera análises completas de pain points até recomendações de solução
• Produz relatórios prontos para executivos e roadmaps de implementação

📋 Requisitos

• Node.js 14.0.0 ou superior
• Cursor AI ou editor compatível com Cursor Rules

🔧 Como usar

1. Instalar

npx agents-upstream

2. Preparar materiais

• Coloque arquivos de entrevista em 0-documentation/0b-Interviews/
• Atualize 0-documentation/0a-projectdocs/context.md com objetivos do negócio

3. Iniciar workflow

No Cursor AI, digite:

start workflow

O sistema progride automaticamente pelos Agentes 0-5 (análise de problema) e depois Agentes 6-8 (desenvolvimento de solução).

📂 Estrutura criada

├── 0-documentation/          # Contexto do projeto e materiais fonte
│   ├── 0a-projectdocs/       # Documentação de contexto
│   └── 0b-Interviews/        # Arquivos de entrevista
├── _output-structure/        # Templates e guias de formatação
│   ├── problem-space/        # Templates de análise de problema
│   └── solution-space/       # Templates de desenvolvimento de solução
└── .cursor/                  # Agentes de IA e regras de workflow
    └── rules/
        ├── problem-space/    # Agentes 0-5
        └── solution-space/   # Agentes 6-8

🤖 Agentes Incluídos

Problem Space (Agentes 0-5)

• Agent 0: Product & Service Design Specialist
• Agent 1: Qualitative Research Specialist
• Agent 2: Pain Point Analysis Specialist
• Agent 3: As-Is Journey Mapper
• Agent 4: Journey Consolidation Specialist
• Agent 5: Strategic Report Generator

Solution Space (Agentes 6-8)

• Agent 6: Strategic Analysis Specialist
• Agent 7: Process Optimization Specialist
• Agent 8: Communication Specialist

📊 Entregáveis

Pacote de Análise de Problema

• Declaração estratégica de problema
• Análise de pain points
• Mapeamento de jornada do estado atual
• Relatório abrangente de problema

Pacote de Ideação de Solução

• Oportunidades estratégicas com ROI
• Roadmap de implementação
• Avaliação de automação
• Apresentação executiva
• Plano de gestão de mudança

🎓 Documentação

Após a instalação, consulte o README.md completo no diretório do projeto para:

• Guia detalhado de uso
• Descrições de agentes
• Instruções de templates
• Controle de qualidade
• Resolução de problemas

🔒 Privacidade e Telemetria

O Agents Upstream coleta telemetria anônima de uso para nos ajudar a melhorar o produto.

O que coletamos

• ✅ Eventos de instalação e escolhas de menu
• ✅ Erros e falhas do CLI
• ✅ Plataforma e versão do Node.js
• ✅ Timestamps de uso

O que NÃO coletamos

• ❌ Conteúdo de arquivos ou entrevistas
• ❌ Caminhos de arquivos ou informações pessoais
• ❌ Nomes de projetos ou dados sensíveis
• ❌ Qualquer informação identificável

Gerenciar telemetria

# Desabilitar telemetria
npx agents-upstream telemetry disable

# Habilitar telemetria
npx agents-upstream telemetry enable

# Ver status atual
npx agents-upstream telemetry status

Respeitamos sua privacidade. Telemetria é opcional e pode ser desabilitada a qualquer momento.

📝 Licença

MIT

🤝 Contribuindo

Contribuições são bem-vindas! Este é um sistema em evolução projetado para melhoria contínua.

📧 Suporte

Para problemas e perguntas, consulte a documentação incluída após a instalação.

Permite que equipes de produto pensem estrategicamente sem sacrificar velocidade.