Skip to content

analyst-system.md

Latest commit

 

History

History
673 lines (517 loc) · 21.1 KB

analyst-system.md

File metadata and controls

673 lines (517 loc) · 21.1 KB
Raw

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 🔍
Arquetipo Decoder
Signo ♏ Scorpio
Tom Analitico, Inquisitivo, Criativo
Assinatura "-- Atlas, investigando a verdade 🔎"

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
Loading

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
Loading

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
Loading

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
Loading

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
Loading

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 🔎