Skill: Article Structure

Organiza um texto para que ele tenha início, meio e fim — e para que cada seção “pague o aluguel” na argumentação.

Objetivo

• •Gerar um outline completo (títulos, propósito da seção, conteúdo esperado).
• •Definir um arco narrativo coerente: problema → tensão → proposta → evidências → trade-offs → síntese.

Quando usar (gatilhos)

• •“Me ajuda a estruturar o artigo.”
• •“Tenho notas soltas, quero virar um texto bom.”
• •“Quero um artigo nem curto demais, nem longo demais.”
• •“Quero uma linha de argumentação clara.”

Exemplos de prompt

• •"Estruture um artigo a partir deste Research Brief. Quero um outline com seções, objetivos e os pontos que entram em cada uma."
• •"Tenho este rascunho e está confuso. Reorganize a linha de argumento e proponha uma estrutura mais forte."

Inputs (o que pedir ao usuário)

• •Tema + tese (ou o Research Brief, se existir).
• •Tipo de texto: tutorial, decisão técnica, ensaio opinativo, estudo de caso.
• •Tamanho/tempo de leitura desejado (ex.: 6–10 min, 12–15 min).
• •Se o texto deve conter código (e em qual linguagem).

Opcional:

• •Onde o usuário quer chegar (call-to-action): “quero que o leitor faça/pense X”.
• •Exemplos reais do usuário (incidentes, escolhas, refactors).

Princípios e regras

Crítico (não negociar)

• •A introdução precisa declarar: o problema, o custo, a promessa do texto.
• •Cada seção deve ter 1 propósito explícito: ou avança argumento, ou prova, ou delimita contexto.
• •Sempre incluir “quando não vale”/limitações quando o tema vira dogma fácil.
• •Evitar listas longas sem ligação lógica; preferir progressão (“portanto”, “porém”, “logo”).

Padrões recomendados

• •Começar com um caso concreto (ou mini-história) quando possível.
• •Usar 1 metáfora no máximo; preferir exemplos técnicos.

Decision Tree (quando houver variações)

1. •A tese é controversa?

• •Sim → introduzir contra-argumento cedo e responder com rigor.
• •Não → focar em didática e exemplos.

1. •O leitor quer “como fazer”?

• •Sim → usar estrutura de tutorial/checklist.
• •Não → usar estrutura de ensaio/argumento.

Workflow (faça em ordem)

1. •Escolher forma do artigo

• •Selecionar um dos templates em assets/.

1. •Escrever o outline

• •Para cada seção: objetivo, tópicos, exemplo, frase de transição.

1. •Calibrar tamanho

• •Unir seções redundantes; cortar o que não serve ao argumento.
• •Garantir pelo menos 1 seção de limitações/anti-padrões.

1. •Preparar rascunho “zero”

• •Escrever frases-guia por seção (1–3 por seção) para tirar o bloqueio de página em branco.

Saída esperada

• •Outline em Markdown no formato do template escolhido.
• •Sugestão de 2 opções de introdução e 2 de conclusão (curtas).

Checklist

• • Introdução define problema, custo e promessa
• • Seções têm propósito explícito
• • Há contra-argumento e/ou limitações
• • O texto tem progressão (não é lista de tópicos)
• • Tamanho está dentro do alvo

Recursos inclusos (opcional)

• •assets/outline-essay.md: outline para ensaio técnico.
• •assets/outline-decision-record.md: outline para “decisão técnica”.
• •assets/outline-tutorial.md: outline para tutorial.

Limitações e recomendações futuras

• •A estrutura não garante “voz”; usar article-review para ajustar estilo e naturalidade.

Consulte também

• •article-research
• •article-review