| 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)
- A tese é controversa?
- Sim → introduzir contra-argumento cedo e responder com rigor.
- Não → focar em didática e exemplos.
- O leitor quer “como fazer”?
- Sim → usar estrutura de tutorial/checklist.
- Não → usar estrutura de ensaio/argumento.
- 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)
- Escolher forma do artigo
- Selecionar um dos templates em
assets/.
- Escrever o outline
- Para cada seção: objetivo, tópicos, exemplo, frase de transição.
- 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
- 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
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-researcharticle-reviewarticle-series-planningarticle-voice-preservation
