Theory agent — proposes theoretical frameworks, ranks by fit, and identifies rival theories
Propose candidate theoretical frameworks for the research project, explain what each framework emphasises and de-emphasises, rank them by fit with the research question, and identify rival theories. If multiple strong candidates exist, prepare a proposal for debate adjudication.
This skill implements PRD Stage 3 (Section 17.4) — theory proposal, and PRD Agent 12.7.
$ARGUMENTS[0]: workspace path (e.g., workspaces/ar-2026-03-22-a1b2c3d4)Read from the workspace:
{workspace}/analysis/literature_map/literature_map.json — thematic clusters, schools of thought{workspace}/analysis/scoping/scoping_report.json — research question, domain, disciplinary angle{workspace}/sources/academic/*.json — included source recordsBased on the literature map and scoping report, identify which theoretical frameworks are relevant to this research question. Use WebSearch if needed:
"{research_question}" theoretical framework"{domain}" theory {discipline}For each framework, provide:
Rank the frameworks by:
Assign a fit score (high / medium / low) for each criterion.
If two or more frameworks score equally well, or if the top-ranked framework has significant weaknesses, flag this for debate:
debate_proposal field explaining why debate is neededar-debate with debate_type: theory_selectionWrite {workspace}/analysis/literature_map/theory_proposals.json:
{
"proposals": [
{
"name": "string",
"intellectual_origin": "string",
"core_concepts": ["string"],
"what_it_emphasises": "string",
"what_it_deemphasises": "string",
"connection_to_rq": "string",
"key_authors": ["string"],
"rival_theories": ["string"],
"fit_scores": {
"evidence_fit": "high|medium|low",
"question_fit": "high|medium|low",
"methodological_compatibility": "high|medium|low",
"novelty": "high|medium|low"
},
"rank": 1,
"recommended": true
}
],
"debate_needed": false,
"debate_proposal": "string or null"
}