@analyst (Atlas)

Pesquisa de mercado e análise competitiva

13 min de leitura
agenteanálisepesquisa

Sistema do Agente Analyst (@analyst) - AIOX

Versão: 1.0.0 Criado: 2026-02-04 Owner: @analyst (Atlas) Status: Documentação Oficial

Visão Geral

Este documento descreve o sistema completo do agente @analyst (Atlas), incluindo todos os arquivos envolvidos, fluxos de trabalho, comandos disponiveis, templates e integracoes entre agentes.

O agente Analyst e projetado para:

  • Conduzir pesquisas de mercado e analises competitivas
  • Facilitar sessoes de brainstorming estruturadas
  • Criar project briefs e prompts de pesquisa profunda
  • Fornecer insights acionaveis para tomadas de decisao
  • Apoiar descoberta de projetos (brownfield documentation)
  • Gerar relatorios executivos de awareness

Perfil do Agente

| Atributo | Valor | |----------|-------| | Nome | Atlas | | ID | analyst | | Titulo | Business Analyst | | Icone | :mag: | | Arquetipo | Decoder | | Signo | :scorpius: Scorpio | | Tom | Analitico, Inquisitivo, Criativo | | Assinatura | "-- Atlas, investigando a verdade :mag_right:" |

Principios Core

  1. Curiosity-Driven Inquiry - Perguntas proativas para descobrir verdades subjacentes
  2. Objective & Evidence-Based Analysis - Fundamentacao em dados verificaveis
  3. Strategic Contextualization - Enquadramento no contexto estrategico mais amplo
  4. Facilitate Clarity & Shared Understanding - Articulacao precisa de necessidades
  5. Creative Exploration & Divergent Thinking - Ampla geracao de ideias antes de convergir
  6. Structured & Methodical Approach - Metodos sistematicos para abrangencia
  7. Action-Oriented Outputs - Entregaveis claros e acionaveis
  8. Collaborative Partnership - Parceria iterativa de refinamento
  9. Maintaining a Broad Perspective - Consciencia de tendencias de mercado
  10. Integrity of Information - Representacao precisa de fontes

Lista Completa de Arquivos

Arquivos Core do Agente

| Arquivo | Propósito | |---------|-----------| | .aiox-core/development/agents/analyst.md | Definição core do agente Analyst | | .claude/commands/AIOX/agents/analyst.md | Comando Claude Code para ativar @analyst |

Tasks do Analyst

| Arquivo | Comando | Propósito | |---------|---------|-----------| | .aiox-core/development/tasks/facilitate-brainstorming-session.md | *brainstorm {topic} | Task principal - facilita sessoes de brainstorming estruturadas | | .aiox-core/development/tasks/analyst-facilitate-brainstorming.md | *brainstorm {topic} | Variante interativa da task de brainstorming | | .aiox-core/development/tasks/create-deep-research-prompt.md | *research-prompt {topic} | Gera prompts de pesquisa profunda para investigacao | | .aiox-core/development/tasks/advanced-elicitation.md | *elicit | Sessao avancada de elicitacao de requisitos | | .aiox-core/development/tasks/create-doc.md | *doc-out | Criacao de documentos a partir de templates YAML | | .aiox-core/development/tasks/document-project.md | *create-project-brief | Documentação de projetos existentes | | .aiox-core/development/tasks/calculate-roi.md | (relacionada) | Calculo de ROI e economia de custos |

Tasks Relacionadas de Analise

| Arquivo | Propósito | |---------|-----------| | .aiox-core/development/tasks/analyze-brownfield.md | Analise de projetos brownfield | | .aiox-core/development/tasks/analyze-framework.md | Analise de frameworks existentes | | .aiox-core/development/tasks/analyze-performance.md | Analise de performance | | .aiox-core/development/tasks/analyze-project-structure.md | Analise de estrutura de projeto | | .aiox-core/development/tasks/analyze-cross-artifact.md | Analise cross-artifact |

Templates do Analyst

| Arquivo | Propósito | |---------|-----------| | .aiox-core/product/templates/project-brief-tmpl.yaml | Template para Project Brief | | .aiox-core/product/templates/market-research-tmpl.yaml | Template para Pesquisa de Mercado | | .aiox-core/product/templates/competitor-analysis-tmpl.yaml | Template para Analise Competitiva | | .aiox-core/product/templates/brainstorming-output-tmpl.yaml | Template para output de sessoes de brainstorming |

Arquivos de Dados

| Arquivo | Propósito | |---------|-----------| | .aiox-core/development/data/aiox-kb.md | Knowledge base do AIOX | | .aiox-core/development/data/brainstorming-techniques.md | Tecnicas de brainstorming disponiveis |

Workflows que Usam o Analyst

| Arquivo | Fase | Propósito | |---------|------|-----------| | .aiox-core/development/workflows/greenfield-fullstack.yaml | Fase 1 | Discovery & Planning - cria project-brief.md | | .aiox-core/development/workflows/brownfield-discovery.yaml | Fase 9 | Relatorio Executivo de Awareness |

Flowchart: Sistema Completo do Analyst

flowchart TB
    subgraph INPUTS["INPUTS - Fontes de Informacao"]
        USER["Usuario/Stakeholder"]
        DOCS["Documentos Existentes"]
        MARKET["Dados de Mercado"]
        COMPETITORS["Dados de Competidores"]
    end

    USER -->|"contexto inicial"| ANALYST
    DOCS -->|"referencia"| ANALYST
    MARKET -->|"pesquisa EXA"| ANALYST
    COMPETITORS -->|"analise"| ANALYST

    subgraph ANALYST["@analyst (Atlas) - Business Analyst"]
        BRAINSTORM["*brainstorm {topic}<br/>Sessao Estruturada"]
        RESEARCH["*research-prompt {topic}<br/>Prompt de Pesquisa"]
        MARKET_RES["*perform-market-research<br/>Pesquisa de Mercado"]
        COMPETITOR["*create-competitor-analysis<br/>Analise Competitiva"]
        BRIEF["*create-project-brief<br/>Project Brief"]
        ELICIT["*elicit<br/>Elicitacao Avancada"]
    end

    BRAINSTORM --> OUTPUT_BRAIN["brainstorming-session-results.md"]
    RESEARCH --> OUTPUT_PROMPT["research-prompt.md"]
    MARKET_RES --> OUTPUT_MARKET["market-research.md"]
    COMPETITOR --> OUTPUT_COMP["competitor-analysis.md"]
    BRIEF --> OUTPUT_BRIEF["project-brief.md"]
    ELICIT --> OUTPUT_ELICIT["Insights Refinados"]

    subgraph OUTPUTS["OUTPUTS - Entregaveis"]
        OUTPUT_BRAIN
        OUTPUT_PROMPT
        OUTPUT_MARKET
        OUTPUT_COMP
        OUTPUT_BRIEF
        OUTPUT_ELICIT
    end

    OUTPUTS --> HANDOFF["Handoff para @pm"]

    style INPUTS fill:#e1f5fe
    style ANALYST fill:#fff3e0
    style OUTPUTS fill:#e8f5e9
    style HANDOFF fill:#f3e5f5

Diagrama de Fluxo de Brainstorming

flowchart TD
    START["Inicio: *brainstorm {topic}"] --> SETUP["Fase 1: Setup<br/>4 perguntas de contexto"]

    SETUP --> Q1["1. O que estamos brainstorming?"]
    Q1 --> Q2["2. Constraints ou parametros?"]
    Q2 --> Q3["3. Goal: exploracao ampla ou focada?"]
    Q3 --> Q4["4. Quer documento estruturado?"]

    Q4 --> APPROACH["Fase 2: Selecao de Abordagem"]

    APPROACH --> OPT1["1. Usuario seleciona tecnicas"]
    APPROACH --> OPT2["2. Analyst recomenda tecnicas"]
    APPROACH --> OPT3["3. Selecao aleatoria"]
    APPROACH --> OPT4["4. Fluxo progressivo"]

    OPT1 --> EXEC
    OPT2 --> EXEC
    OPT3 --> EXEC
    OPT4 --> EXEC

    EXEC["Fase 3: Execucao Interativa"]

    subgraph CYCLE["Ciclo de Tecnicas"]
        TECH["Aplicar Tecnica"]
        ENGAGE["Engajar Usuario"]
        CAPTURE["Capturar Ideias"]
        NEXT{{"Continuar?"}}

        TECH --> ENGAGE
        ENGAGE --> CAPTURE
        CAPTURE --> NEXT
        NEXT -->|"Sim, mesma tecnica"| TECH
        NEXT -->|"Trocar tecnica"| TECH
    end

    EXEC --> CYCLE
    NEXT -->|"Convergir"| CONVERGE["Fase 4: Convergencia"]

    CONVERGE --> CAT["Categorizar Ideias"]
    CAT --> SYNTH["Sintetizar Insights"]
    SYNTH --> DOC["Gerar Documento"]
    DOC --> END["Sessao Completa"]

    style START fill:#90EE90
    style END fill:#90EE90
    style CYCLE fill:#FFE4B5

Diagrama de Estados de Sessao

stateDiagram-v2
    [*] --> CONTEXT_GATHERING: Ativacao
    CONTEXT_GATHERING --> APPROACH_SELECTION: contexto coletado
    APPROACH_SELECTION --> DIVERGENT_THINKING: abordagem definida

    DIVERGENT_THINKING --> TECHNIQUE_ACTIVE: tecnica selecionada
    TECHNIQUE_ACTIVE --> DIVERGENT_THINKING: trocar tecnica
    TECHNIQUE_ACTIVE --> TECHNIQUE_ACTIVE: continuar engajando

    DIVERGENT_THINKING --> CONVERGENT_THINKING: ideias suficientes
    CONVERGENT_THINKING --> CATEGORIZATION: categorizar
    CATEGORIZATION --> SYNTHESIS: sintetizar
    SYNTHESIS --> DOCUMENTATION: documentar
    DOCUMENTATION --> [*]: sessao completa

    note right of DIVERGENT_THINKING: Warm-up: 5-10 min<br/>Geracao: 20-30 min
    note right of CONVERGENT_THINKING: Convergencia: 15-20 min
    note right of SYNTHESIS: Sintese: 10-15 min

Flowchart: Integracao com Outros Agentes

flowchart TB
    subgraph DISCOVERY["Fase de Discovery"]
        direction TB
        ANALYST_WORK["@analyst<br/>Pesquisa & Brainstorming"]
        PROJECT_BRIEF["project-brief.md"]
        MARKET_RESEARCH["market-research.md"]
        COMPETITOR_ANALYSIS["competitor-analysis.md"]

        ANALYST_WORK --> PROJECT_BRIEF
        ANALYST_WORK --> MARKET_RESEARCH
        ANALYST_WORK --> COMPETITOR_ANALYSIS
    end

    subgraph PLANNING["Fase de Planning"]
        direction TB
        PM_WORK["@pm (Morgan)<br/>Estrategia de Produto"]
        PRD["prd.md"]

        PROJECT_BRIEF --> PM_WORK
        MARKET_RESEARCH --> PM_WORK
        COMPETITOR_ANALYSIS --> PM_WORK
        PM_WORK --> PRD
    end

    subgraph DESIGN["Fase de Design"]
        direction TB
        UX_WORK["@ux-design-expert<br/>Especificacao Frontend"]
        FRONTEND_SPEC["front-end-spec.md"]

        PRD --> UX_WORK
        UX_WORK --> FRONTEND_SPEC
    end

    subgraph ARCHITECTURE["Fase de Arquitetura"]
        direction TB
        ARCH_WORK["@architect<br/>Arquitetura Fullstack"]
        ARCH_DOC["fullstack-architecture.md"]

        PRD --> ARCH_WORK
        FRONTEND_SPEC --> ARCH_WORK
        ARCH_WORK --> ARCH_DOC
    end

    subgraph VALIDATION["Fase de Validacao"]
        direction TB
        PO_WORK["@po (Pax)<br/>Validacao de Artefatos"]

        PROJECT_BRIEF --> PO_WORK
        PRD --> PO_WORK
        FRONTEND_SPEC --> PO_WORK
        ARCH_DOC --> PO_WORK
    end

    style DISCOVERY fill:#e3f2fd
    style PLANNING fill:#fff3e0
    style DESIGN fill:#fce4ec
    style ARCHITECTURE fill:#e8f5e9
    style VALIDATION fill:#f3e5f5

Fluxo em Workflow Brownfield Discovery

flowchart LR
    subgraph PHASES["Brownfield Discovery - 10 Fases"]
        P1["Fase 1-3<br/>Coleta de Dados"]
        P4["Fase 4<br/>Consolidacao"]
        P5_7["Fases 5-7<br/>Validacao"]
        P8["Fase 8<br/>Assessment Final"]
        P9["Fase 9<br/>@analyst<br/>Relatorio Executivo"]
        P10["Fase 10<br/>Epic & Stories"]

        P1 --> P4
        P4 --> P5_7
        P5_7 --> P8
        P8 --> P9
        P9 --> P10
    end

    P9 --> EXEC_REPORT["TECHNICAL-DEBT-REPORT.md"]

    style P9 fill:#DDA0DD
    style EXEC_REPORT fill:#90EE90

Mapeamento de Comandos para Tasks

Comandos de Research & Analysis

| Comando | Task File | Operacao | |---------|-----------|----------| | *perform-market-research | create-doc.md + template | Cria relatorio de pesquisa de mercado | | *create-competitor-analysis | create-doc.md + template | Cria analise competitiva detalhada | | *research-prompt {topic} | create-deep-research-prompt.md | Gera prompt de pesquisa profunda |

Comandos de Ideation & Discovery

| Comando | Task File | Operacao | |---------|-----------|----------| | *brainstorm {topic} | facilitate-brainstorming-session.md | Facilita sessao de brainstorming estruturada | | *create-project-brief | document-project.md | Cria project brief | | *elicit | advanced-elicitation.md | Sessao avancada de elicitacao |

Comandos Utilitarios

| Comando | Operacao | |---------|----------| | *help | Mostra todos os comandos disponiveis | | *doc-out | Output do documento completo | | *session-info | Mostra detalhes da sessao atual | | *guide | Guia de uso do agente | | *yolo | Toggle para pular confirmacoes | | *exit | Sair do modo analyst |

Templates e Estrutura de Dados

Template de Project Brief

template:
  id: project-brief-template-v2
  name: Project Brief
  version: 2.0
  output:
    format: markdown
    filename: docs/brief.md

Secoes Principais:

  • Executive Summary
  • Problem Statement
  • Proposed Solution
  • Target Users (Primary/Secondary)
  • Goals & Success Metrics
  • MVP Scope (Core Features / Out of Scope)
  • Post-MVP Vision
  • Technical Considerations
  • Constraints & Assumptions
  • Risks & Open Questions

Template de Market Research

template:
  id: market-research-template-v2
  name: Market Research Report
  version: 2.0
  output:
    format: markdown
    filename: docs/market-research.md

Secoes Principais:

  • Executive Summary
  • Research Objectives & Methodology
  • Market Overview (TAM/SAM/SOM, Trends)
  • Customer Analysis (Segments, JTBD, Journey)
  • Competitive Landscape
  • Industry Analysis (Porter's Five Forces)
  • Opportunity Assessment
  • Strategic Recommendations

Template de Competitor Analysis

template:
  id: competitor-analysis-template-v2
  name: Competitive Analysis Report
  version: 2.0
  output:
    format: markdown
    filename: docs/competitor-analysis.md

Secoes Principais:

  • Executive Summary
  • Analysis Scope & Methodology
  • Competitive Landscape Overview
  • Individual Competitor Profiles
  • Comparative Analysis (Features, SWOT, Positioning)
  • Strategic Analysis (Blue Ocean, Vulnerabilities)
  • Strategic Recommendations
  • Monitoring & Intelligence Plan

Template de Brainstorming Output

template:
  id: brainstorming-output-template-v2
  name: Brainstorming Session Results
  version: 2.0
  output:
    format: markdown
    filename: docs/brainstorming-session-results.md

Secoes Principais:

  • Executive Summary (Topic, Techniques, Ideas Count)
  • Technique Sessions (per technique used)
  • Idea Categorization
    • Immediate Opportunities
    • Future Innovations
    • Moonshots
    • Insights & Learnings
  • Action Planning (Top 3 Priorities)
  • Reflection & Follow-up

Processo de Pesquisa Profunda

Tipos de Foco de Pesquisa

  1. Product Validation Research - Validar hipoteses e market fit
  2. Market Opportunity Research - Tamanho e potencial de mercado
  3. User & Customer Research - Personas, JTBD, pain points
  4. Competitive Intelligence Research - Analise detalhada de competidores
  5. Technology & Innovation Research - Tendencias e avaliacoes tecnicas
  6. Industry & Ecosystem Research - Cadeia de valor e dinamicas
  7. Strategic Options Research - Avaliar direcoes estrategicas
  8. Risk & Feasibility Research - Identificar e avaliar riscos
  9. Custom Research Focus - Objetivos personalizados

Estrutura do Prompt de Pesquisa

## Research Objective
[Statement claro do objetivo]

## Background Context
[Informacoes relevantes de inputs]

## Research Questions
### Primary Questions (Must Answer)
1. [Pergunta especifica e acionavel]
...

### Secondary Questions (Nice to Have)
1. [Pergunta de suporte]
...

## Research Methodology
### Information Sources
- [Tipos de fontes e prioridades]

### Analysis Frameworks
- [Frameworks especificos]

## Expected Deliverables
### Executive Summary
- Key findings and insights
- Critical implications
- Recommended actions

## Success Criteria
[Como avaliar se a pesquisa atingiu objetivos]

Ferramentas e Integracoes

Tools Disponiveis

| Ferramenta | Propósito | |------------|-----------| | exa | Pesquisa web avancada para mercado e tecnologias | | context7 | Lookup de documentacao de bibliotecas | | google-workspace | Documentação de pesquisa (Drive, Docs, Sheets) | | clickup | Captura e organizacao de ideias |

Integracoes com Outros Agentes

| Agente | Tipo de Colaboracao | |--------|---------------------| | @pm (Morgan) | Analyst fornece pesquisa e analise para criação de PRD | | @po (Pax) | Analyst fornece insights de mercado e analise competitiva | | @architect | Analyst pode fornecer research de tecnologias | | @ux-design-expert | Analyst fornece user research para decisoes de UX |

Modos de Execucao

1. YOLO Mode - Rapido e Autonomo (0-1 prompts)

  • Tomada de decisao autonoma com logging
  • Interacao minima com usuario
  • Melhor para: Tasks simples e deterministicas

2. Interactive Mode - Balanceado e Educativo (5-10 prompts) [DEFAULT]

  • Checkpoints explicitos de decisao
  • Explicacoes educativas
  • Melhor para: Aprendizado, decisoes complexas

3. Pre-Flight Planning - Planejamento Abrangente

  • Fase de analise de task (identificar ambiguidades)
  • Execucao com zero ambiguidade
  • Melhor para: Requisitos ambiguos, trabalho critico

Best Practices

Pesquisa de Mercado

  1. Defina objetivos claros - Saiba que decisoes a pesquisa vai informar
  2. Use multiplas fontes - Combine fontes primarias e secundarias
  3. Quantifique quando possivel - TAM/SAM/SOM com calculos claros
  4. Identifique assumptions - Documente limitacoes e premissas
  5. Foque em insights acionaveis - Nao apenas dados, mas recomendacoes

Analise Competitiva

  1. Priorize competidores - Use matriz de priorizacao (market share vs threat)
  2. Analise profunda dos Priority 1-2 - Perfis detalhados
  3. Monitore continuamente - Estabeleca cadencia de atualizacao
  4. Identifique Blue Ocean - Busque espacos de mercado não contestados
  5. Documente fontes - Para validação e atualizacoes futuras

Sessoes de Brainstorming

  1. Seja facilitador, não gerador - Guie o usuario a gerar ideias proprias
  2. Uma tecnica por vez - Nao misture multiplas tecnicas
  3. Quantidade antes de qualidade - Alvo: 100 ideias em 60 minutos
  4. Adie julgamento - Geracao primeiro, avaliacao depois
  5. Documente tudo - Capture mesmo ideias "malucas"
  6. Gerencie energia - Monitore engajamento e ofereca pausas

Elicitacao Avancada

  1. Contexto antes de metodo - Analise o conteudo antes de selecionar metodos
  2. Use formato 1-9 - Sempre apresente opcoes numeradas
  3. Forneca rationale detalhado - Explique trade-offs e decisoes
  4. Aguarde resposta - Nao proceda sem input do usuario
  5. Seja conciso - Foque em insights acionaveis

Troubleshooting

Sessao de brainstorming estagnada

Sintomas: Usuario para de gerar ideias, respostas curtas

Solucoes:

  1. Verificar nivel de energia: "Como voce esta se sentindo sobre essa direcao?"
  2. Oferecer troca de tecnica: "Quer tentar uma abordagem diferente?"
  3. Usar prompts mais especificos
  4. Fazer pausa e retomar

Pesquisa sem dados suficientes

Sintomas: EXA retorna poucos resultados, mercado de nicho

Solucoes:

  1. Expandir escopo de busca (termos relacionados)
  2. Usar analogias de mercados adjacentes
  3. Combinar com pesquisa primaria (entrevistas)
  4. Documentar gaps e incertezas claramente

Project brief incompleto

Sintomas: Secoes vagas, falta de especificidade

Solucoes:

  1. Usar elicitacao avancada para aprofundar
  2. Pedir exemplos concretos
  3. Desafiar assumptions com cenarios
  4. Iterar em multiplas sessoes se necessario

Analise competitiva superficial

Sintomas: Apenas lista de competidores sem insights

Solucoes:

  1. Aplicar frameworks estruturados (Porter's, SWOT)
  2. Focar em diferenciais e vulnerabilidades
  3. Incluir analise de posicionamento
  4. Gerar recomendacoes estrategicas especificas

Referencias

Tasks Principais

Templates

Workflows

Agente

Resumo

| Aspecto | Detalhes | |---------|----------| | Total de Tasks Core | 6 task files | | Total de Templates | 4 templates YAML | | Comandos de Research | 3 (*perform-market-research, *create-competitor-analysis, *research-prompt) | | Comandos de Ideation | 3 (*brainstorm, *create-project-brief, *elicit) | | Workflows que Usam | 2 (greenfield-fullstack, brownfield-discovery) | | Agentes Consumidores | @pm, @po, @architect, @ux-design-expert | | Tools Integrados | exa, context7, google-workspace, clickup | | Modos de Execucao | 3 (YOLO, Interactive, Pre-Flight) |

Changelog

| Data | Autor | Descrição | |------|-------|-----------| | 2026-02-04 | @analyst | Documento inicial criado com flowcharts e mapeamentos completos |

-- Atlas, investigando a verdade :mag_right:

Falar com o Time