O que Desenvolvimento de Tópico faz?
Transforme um tópico candidato em um contrato de conteúdo aprovado. O trabalho está pronto para ser escrito somente quando o argumento, as evidências e os limites não precisarem mais ser inventados a jusante.
Escopo
Comece com um tópico candidato ou um conjunto pequeno e naturalmente limitado. Quando várias direções próximas permanecerem, compare-as superficialmente quanto ao valor para o público, novidade, verificabilidade, demonstratibilidade, adequação do autor e risco de exagero; peça ao usuário para escolher antes da pesquisa aprofundada. Varreduras abertas de tendências e manutenção de um backlog de ideias estão fora desta habilidade.
Espaço de trabalho de evidências
Crie um diretório content/ no projeto de vídeo:
content/
|-- RESEARCH.md
|-- TOPIC.md
`-- experiments/
Use RESEARCH.md para fatos com fontes, interpretações, divergências, incógnitas, direções rejeitadas e links para material primário. Mantenha a coleta separada da seleção editorial.
Trate uma afirmação como material quando ela afeta se o assunto funciona, importa para o público, difere de uma alternativa, pode ser demonstrada ou permanece válida dentro do escopo declarado. Apoie-a com uma fonte ou experimento forte o suficiente para aquela afirmação exata; rotule evidências mais fracas como provisional em vez de esticá-las silenciosamente.
Quando uma afirmação precisar de evidência executável, realize o menor experimento que possa resolvê-la e escreva content/experiments/<nome>.md com a pergunta, método, amostras, ambiente, comando, resultados, limitações e conclusões que o resultado suporta. Mantenha código e dados brutos no projeto que os possui; registre seus caminhos e revisão Git em vez de copiá-los para o projeto de vídeo.
Contrato de conteúdo
Escreva content/TOPIC.md:
---
status: rascunho
audiencia: ...
pergunta_central: ...
tese: ...
escopo: ...
voz:
idioma: ...
habilidades: []
documentos: []
indisponivel: []
status: resolvida | assumida
---
# Título de trabalho
## Promessa ao leitor
## Argumento
### A01 - Afirmação
- papel: Por que esta afirmação existe no argumento
- afirmacao: A proposição exata
- evidencias: Links para cabeçalhos do RESEARCH.md ou relatórios de experimentos
- confianca: estabelecida | provisória
- limite: O que a evidência não estabelece
## Fora do escopo
## Perguntas em aberto
## Títulos alternativos
Resolva fontes de voz nesta ordem: direção explícita do usuário, orientação do projeto ou marca, uma habilidade de estilo de escrita disponível compatível com o idioma e tipo de conteúdo, preferências visíveis do usuário, amostras de escrita e, em seguida, um padrão explicativo claro. Registre as fontes realmente usadas e persista fontes solicitadas, mas indisponíveis, em voice.unavailable; não presuma memória indisponível ou um perfil oculto.
Porta de aprovação
Apresente o título de trabalho, tese, escopo, argumento, evidências principais, limites e perguntas em aberto materiais para revisão. Um título pode continuar mudando, mas público, tese, escopo, argumento, evidências e limites de conclusão são decisões bloqueadas.
Apenas a aprovação explícita do usuário altera o frontmatter para:
status: aprovado
aprovado_em: YYYY-MM-DD
aprovado_digest: sha256:<digest>
O digest é SHA-256 do arquivo completo após remover apenas a linha approved_digest:. Recalcule-o antes de confiar na aprovação. Uma incompatibilidade torna a aprovação obsoleta e retorna o arquivo para rascunho. Após uma edição de título ou cópia verificada como não material, o digest pode ser atualizado sem nova aprovação; propague o novo digest para todos os artefatos dependentes.
Até lá, mantenha toda a escrita dentro de RESEARCH.md, relatórios de experimentos e o rascunho TOPIC.md. Não crie ARTIGO.md ou ROTEIRO.md; um pedido para agilizar ou permissão para escolher uma tese não substitui a aprovação do contrato resultante.
Uma alteração material posterior a uma decisão bloqueada retorna TOPIC.md para rascunho e torna obsoleta a aprovação do artigo downstream. Edições de cópia, exemplos e alterações de título que preservam o significado não revogam a aprovação.
Antes de apresentar content/TOPIC.md ou qualquer revisão posterior, siga ../boring-video/references/markdown-review.md. Mantenha o caminho canônico do Markdown como a versão atual e aplique o feedback da revisão nele.
O tópico está completo quando TOPIC.md está aprovado, cada afirmação material aponta para evidências suficientes, as perguntas em aberto restantes são não bloqueadoras e visíveis, um redator de artigo pode rascunhar sem inventar fatos, experimentos, posição do autor, argumento ou escopo, e o critério de conclusão da revisão Markdown é satisfeito.