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`