article-structure

name	article-structure
description	Estruturação de artigos (blog/ensaio/técnico) com tese, narrativa e progressão de ideias. Use esta skill quando o usuário pedir para criar outline, estruturar seções, definir introdução/conclusão, calibrar tamanho, ou transformar notas/pesquisa em um artigo com argumento claro.

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.
• Permitir estrutura flexível para textos curtos, médios, longos e séries.

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.
• Formato e tamanho desejado (post único curto/médio/longo ou série).
• 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”).
• Não impor fórmula fixa de quantidade de parágrafos; adaptar à densidade real do tema.

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.

3. O conteúdo está denso demais para um único post?

• Sim → dividir em série usando assets/outline-series.md.
• Não → manter post único.

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.
• Usar guia de tamanho:
  • Curto: 600–900 palavras
  • Médio: 900–1500 palavras
  • Longo: 1500–2500+ palavras
  • Série: quando houver múltiplas ideias centrais que perderiam força em um único texto

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.
• assets/outline-series.md: outline para planejamento de séries.

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
• article-series-planning
• article-voice-preservation