iamshadmirza/to-onepager

Transforme uma conversa em um resumo de uma página: uma afirmação, evidências fundamentadas, fácil de ler e acompanhar, destino de publicação configurado.

Entrada: caminho/colagem da transcrição, se fornecido; caso contrário, a conversa atual. setup / reconfigure → Executa a Configuração mesmo quando config.md existe.

Config: config.md ao lado deste SKILL.md (local à instalação). Modelo: config.example.md.

Tipos de página (ao vivo): research-finding | proposal. Prefira research-finding quando não estiver claro. Pergunte uma vez se ambos se encaixam. Anuncie a escolha antes de redigir.

Etapas

0. Configuração

Se config.md estiver faltando ou o usuário pediu reconfiguração:

1. Pergunte o destino: local | google-docs | confluence (exatamente um).
2. Colete os campos para aquele destino (veja config.example.md). Confluence requer confluence_folder_url.
3. Escreva config.md neste diretório da skill.
4. Informe ao usuário que isso se aplica a todas as execuções futuras; diga setup para alterar.

Conclusão: config.md válido com um destination conhecido. Execuções apenas de configuração param aqui, a menos que um resumo de uma página também tenha sido solicitado.

1. Minerar

Leia a entrada completa. Apenas anotações de trabalho (não mostre ao usuário):

• Intenção da sessão: afirmação empírica vs. aposta de decisão
• A pergunta ou problema que toda a sessão atendeu
• Suposições testadas (lidere com correções / o que mudou)
• Fatos fundamentados (com fontes) vs. afirmações sem fontes (confiança média)
• Método, limites, perguntas em aberto, próximas ações (decisões de produto/pesquisa, não runbooks locais)

Se a intenção tende a descoberta de pesquisa, capture também:

• Mecanismos explicativos com contagens (sinal dominante, padrão de falso positivo, contrafactual)
• Descobertas elevadas pelo usuário ("coloque isso em Descobertas-chave")
• Experimento? Se a sessão compara a mesma medição em N condições (caps, modos, escopos, configs, braços A/B), liste cada condição e a tabela de evidências conclusivas (scorecard, composição de lacunas, verificação de igualdade). Sinalize fill: experiment.

Se a intenção tende a proposta, capture também:

• Problema / quem sofre, aposta recomendada, porquê agora, abordagem, alternativas (com fontes quando presentes), riscos
• Próximos passos de curto prazo discutidos na sessão

Conclusão: sinais de intenção, correções, fatos fundamentados e notas específicas do ramo capturados. Nenhuma interpretação ainda.

2. Roteirizar

Escolha exatamente um tipo de página do catálogo abaixo. Anuncie: Page type: ….

Tipo de página	Use quando	Prefira o outro quando
research-finding	Evidências responderam "o que é verdade?"	A sessão é principalmente uma aposta com pouca evidência nova
proposal	A sessão estrutura uma aposta (problema, caminho, porquê, como)	A sessão é puramente medição sem nenhuma mudança recomendada

Reserve verificação e arquitetura para depois; se a sessão for apenas essas formas, pergunte qual tipo ao vivo é mais próximo ou pare.

Conclusão: um tipo de página escolhido e anunciado.

3. Destilar

Carregue o template para o tipo roteirizado (ponteiro de contexto — leia apenas aquele arquivo):

• research-finding → templates/research-finding.md
• proposal → templates/proposal.md

Preencha essa estrutura para leitura fácil: um leitor frio deve entender a afirmação em segundos e seguir um tópico por seção.

Caminho de preenchimento para descoberta de pesquisa

• Padrão: Suposições → Resultados → Descobertas-chave (estrutura padrão do template).
• Experimento (quando Minerar sinalizou fill: experiment): use a estrutura de experimento do template. Anuncie: Fill path: experiment.
  • Escada de descobertas: marcadores empilhados (um veredito por condição) mais uma linha de fundo opcional; não esmague N condições em uma única mega-frase.
  • Contexto antes das condições (opcional): após Resposta, um bloco curto que explica os lados da comparação e termos fáceis de confundir (por exemplo, tipos vs. contagens de instância) para que as tabelas não sejam mal interpretadas. Use apenas quando Pergunta não for suficiente. Prefira um título simples como Como ler isto; omita quando desnecessário. Não invente um nome de seção obrigatório.
  • Seções de condição: uma seção de nível superior por condição; cada uma é Veredito depois Análise. Intitule a seção por justiça ou resultado (por exemplo, "A/B justo: cap removido"), não apenas o botão bruto ("MaxMessages = 100"). Coloque a prova compartilhável em Análise (scorecard e/ou tabela de mesma-conclusão / composição de lacunas).
  • Replicação: aninhe sob a condição decisiva/justa (por exemplo, Verificação multi-sessão); não adicione uma seção de condição de nível superior apenas para repetições.
  • Não achate um experimento de N condições em Suposições → Resultados → Descobertas-chave.

Legibilidade (todas as páginas)

• Comece pela coisa concreta: título e Descoberta abrem com o número, veredito ou aposta. O contexto vem depois; não abre a página. Para experimentos, Descoberta pode carregar a aposta como uma escada de marcadores; o título pode nomear a comparação se Descoberta contiver os números.
• Explique após o exemplo: em Resultados, Descobertas-chave, Análise e Como, declare o resultado medido ou caminho escolhido primeiro, depois uma linha curta de contexto se necessário.
• Um trabalho por seção: cada título faz um trabalho. Se uma seção argumenta duas coisas, divida ou corte.
• Resposta que um leitor frio pode usar sem se preocupar com o tipo de página: Descoberta (TLDR) / Confiança / E daí
• Título é a afirmação (inclua um número medido quando a transcrição tiver um; experimentos podem colocar o número em Descoberta)
• Recomendação: apenas ações discutidas na sessão. Se a sessão apenas respondeu a uma pergunta (pesquisa fechada, sem aposta de produto), escreva Nenhuma (ou "pesquisa completa; sem acompanhamento") — não invente próximos passos, TODOs de documento, tarefas de revisor ou um plano de "~1 semana".
• Cabeçalho: Responsável, Aprofundar
• Seção de revisão presente

Responsável: resolva para uma pessoa real. Para destinos Confluence, use menções Atlassian ao publicar (publish.md). Caso contrário, nome de exibição. Pergunte se desconhecido; TBD apenas se adiado.

Conclusão: estrutura roteirizada preenchida (padrão ou experimento); moldura completa; Responsável resolvido ou TBD explícito; título e Descoberta lideram com a afirmação concreta.

4. Fundamentar

Falhe e edite até que todas as verificações passem. Esta etapa é a fonte única da verdade para qualidade (templates não reafirmam estas regras).

Todas as páginas

• Cada célula/marcador factual remonta à transcrição
• Sem magnitudes não medidas
• Resposta de leitor frio funciona sem ler o tipo de página; Descoberta é o TLDR e lidera com a afirmação concreta (Descoberta de experimento pode ser uma escada de marcadores)
• Título lidera com a afirmação (não um tópico ou cabeçalho suave); experimentos podem nomear a comparação no título se Descoberta contiver a aposta/números
• Corpo corresponde ao tipo de página roteirizado (sem estrutura híbrida)
• Um trabalho por seção; nenhuma seção que explica e recomenda
• Moldura completa (Responsável, Aprofundar)
• Aprofundar / recomendações permanecem livres de confusão de runbook local
• Confiança corresponde à evidência; título corresponde a números medidos quando presentes (ou Descoberta, para escadas de experimento)
• Orçamento de uma página: cerca de 600 palavras de prosa; se ultrapassar, corte as ideias menos importantes (não reduza o tipo ou amontoE em um apêndice). Exceção: tabelas de evidências conclusivas de experimento (scorecard, composição de lacunas, verificação de igualdade) não são cortadas para atingir o orçamento; encurte marcadores ao redor delas.
• Aprovação simples em Resposta + Recomendação: voz ativa, palavras curtas, corte palavras e jargões desnecessários
• Sem pontes modeladas: corte frases como "no cenário atual," "revolucionário," "veja por que isso importa," ou uma pergunta de fechamento adicionada apenas para engajamento
• Sem recapitulação suave: Recomendação não reformula Descoberta
• Sem acompanhamentos inventados: próximos passos apenas se a transcrição os discutiu; caso contrário, Recomendação é Nenhuma / pesquisa completa
• Cada seção adiciona algo novo; delete preenchimento que apenas reafirma uma seção anterior