Relatórios para Stakeholders e Investidores

O que é: Relatórios externos.

Visão Geral

Define a configuração mínima útil de Relatórios para Stakeholders e Investidores para o negócio em questão e, em seguida, a constrói apenas quando solicitada. O resultado padrão é uma recomendação curta, não uma planilha. Artefatos - CSV, SQL DDL, JSON Schema, mapeamento Notion - são produzidos sob demanda, a partir de uma única lista de campos para que não haja divergências.

Camada: Camada 9: Analisar. Adequado para: Estágio de Escalabilidade. Código da tabela: n/a.

Quando Usar Esta Habilidade

• relatório de investidor
• pacote de relatórios para o conselho
• atualização para stakeholders
• modelo de relatório mensal

Use também quando o usuário disser "relatórios externos" ou descrever o mesmo processo ocorrendo em uma planilha, um documento ou por e-mail.

Não use para: cálculo de folha de pagamento, declaração de impostos ou aconselhamento jurídico. Esta habilidade produz apenas modelos vazios - nunca armazena ou processa dados reais de funcionários ou clientes.

Como Funciona

Siga o contrato de execução compartilhado. As regras específicas do módulo abaixo definem apenas campos de domínio, decisões, cálculos e restrições de segurança.

Passo 1 - Identificar a intenção

Leia a solicitação e escolha a intenção antes de perguntar qualquer coisa.

• "configurar" ou "construir" ou "criar" -> o usuário quer artefatos; vá para o Passo 2.
• "nosso processo é ..." ou "está em uma planilha" -> o usuário quer mover um processo existente; capture-o e, em seguida, vá para o Passo 2.
• "isso está certo" ou "revisar" ou "auditar" -> o usuário quer uma verificação, não uma construção; responda com base no que eles compartilham.
• "como eu faço ..." -> pergunta de aconselhamento; responda diretamente e ofereça a construção apenas se for útil.

Pergunte apenas se este é o fato faltante de maior valor; caso contrário, prossiga sem uma pergunta inicial:

P: Quem precisa da próxima atualização para stakeholders?

Passo 2 - Pergunte apenas o que está faltando

Ignore tudo o que o usuário já respondeu em qualquer mensagem anterior. Pergunte o restante, um de cada vez, e pare assim que as respostas restantes não alterarem o resultado.

• Público - Quem lê? / Investidores, conselho ou ambos? / Com que frequência?
• Conteúdo - Quais números importam? / Inclui narrativa? / Algum detalhe confidencial?
• Dados - Fontes? / Quem verifica? / Como é aprovado?
• Processo atual - Como é produzido agora? / Quanto tempo leva? / O que fica de fora?
• Resultado - O que você precisa? / Uma estrutura de relatório ou os dados por trás dela?

Nunca invente uma resposta. Se o usuário não souber, registre como desconhecido e continue.

Passo 3 - Mantenha o contexto interno

Mantenha as respostas nesta forma. Isso permanece interno - não é mostrado ao usuário, a menos que ele pergunte, e nunca carrega um valor que o usuário não forneceu.

module: stakeholder-investor-reports
intent: null            # setup | advice | review | fix | build | convert | export
scale: null             # Starter | Growth | Scale, only if the answer changes it
areas:
  "Audience": null
  "Content": null
  "Data": null
  "Current process": null
  "Outcome": null
requested_outputs: []   # csv | sql | json | notion | xlsx - requested formats only
confirmed_facts: []     # only what the user actually said
open_questions: []      # the unanswered ones, in the order worth asking

Passo 4 - Recomende o menor fluxo de trabalho

Se um artefato foi solicitado, construa-o após resolver os fatos essenciais faltantes. Caso contrário, forneça uma recomendação curta e ofereça o artefato relevante.

Abordagem recomendada: Concorde com as seções uma vez, depois reutilize-as a cada período e mantenha uma verificação de quem validou cada número antes que ele seja enviado.

Por que esta: Relatórios para investidores falham devido a divergências de versão e números não verificados. Uma lista de seções fixa e um verificador nomeado resolvem ambos.

Fluxo de trabalho: Dados coletados → Verificados → Seção redigida → Aprovada → Enviada com um marcador de versão

Passo 5 - Construa apenas sob demanda

Assim que o usuário solicitar, derive os campos do contexto confirmado e emita os artefatos solicitados. Para texto legível por máquina, mantenha a prosa fora dos dados; para arquivos, forneça um link utilizável. Relate falhas de validação de material ou limitações separadamente.

Uma saída selecionada do Notion é renderizada por notion-manual-import, portanto, direcione a etapa do Notion para lá. Quando o usuário selecionar Notion, passe essa etapa para @notion-manual-import: ele contém o CSV, o mapeamento de propriedades, as etapas de importação e a lista de verificação de validação, e renderiza a Referência de Campo abaixo em vez de definir uma tabela própria. Não repita o mapeamento aqui e não improvise as etapas de importação. Saídas manuais de CSV e mapeamento não precisam de

…