/research-theory
/research-theory — Constrói o arcabouço conceitual e teórico de uma pergunta de pesquisa enquadrada: teoria da mudança, construtos com definições operacionais e um diagrama de modelo conceitual — a etapa de fundamentação teórica do pipeline /research, entre /research-spec e /research-sources.
Papel: Pesquisador Principal (fundamentação teórica) Posição no pipeline: intermediária
Constrói o arcabouço conceitual e teórico fundamental para uma pergunta de pesquisa enquadrada — a fundamentação a priori à qual as etapas de busca sistemática e síntese remetem. Cada construto é ancorado na teoria primária e cada relação teorizada é enunciada em uma forma refutável.
Invocação canônica
/research-theoryCom argumentos:
/research-theory [--suite-name NAME] [--override] [--framework NAME]Entradas
O _spec/research-spec.md da suíte (o conjunto de perguntas enquadradas e falsificáveis produzido por /research-spec).
Saídas
_inputs/theory.md (o arcabouço conceitual / teórico, a teoria da mudança / modelo lógico, os construtos com suas definições operacionais e um diagrama de modelo conceitual).
Downstream
/research-sources (consumidor downstream — a busca sistemática remete seus critérios de inclusão a esses construtos).
Fases do fluxo de trabalho
O comando segue o fluxo de trabalho padrão do pipeline /research:
- Carregar o contexto — Lê
_spec/research-spec.md, as regras e qualquer estado existente da suíte. - Enquadrar o modelo conceitual — Define os construtos e suas definições operacionais; ancora cada um na teoria primária.
- Desenhar a teoria da mudança — Constrói o modelo lógico que liga os construtos aos resultados esperados; enuncia cada relação em uma forma refutável.
- Diagramar o modelo — Emite um diagrama de modelo conceitual que as etapas a jusante referenciam.
- Verificar as saídas — Confirma que cada construto está ancorado na teoria e que cada relação é refutável; resolve a ambiguidade pelo canal de consulta estruturada.
- Emitir o arcabouço —
_inputs/theory.mdmais o manifesto de transferência atualizado.
Modos de falha
| Sintoma | Causa | Recuperação |
|---|---|---|
| O construto carece de uma definição operacional | Conceito enunciado de forma abstrata | Defina o construto em termos mensuráveis; cite a teoria primária |
| A relação teorizada não é refutável | Relação enunciada como um truísmo | Reenuncie a relação como uma afirmação falsificável |
| Falta a entrada de especificação | /research-spec ainda não foi executado | Execute /research-spec primeiro para enquadrar a pergunta |
Exemplos
# Constrói o arcabouço teórico para uma pergunta enquadrada
/research-theory --suite-name retrieval-latency
# Ancora a um arcabouço teórico nomeado
/research-theory --framework "information foraging theory"Referências cruzadas
/research-spec
/research-spec — Enquadra uma pergunta de pesquisa de forma livre ou notas brutas em uma especificação de pesquisa de grau spec (hipóteses falsificáveis, escopo, critérios, métricas de sucesso) pronta para /research-theory.
/research-sources
/research-sources — Coleta sistemática de fontes: decompõe a especificação em subconsultas, dispara a descoberta em paralelo, filtra e classifica, e extrai por fonte em um livro-razão de fontes classificado.