name: hypothesis-development description: Generate grounded hypothesis table, grounding trace, and model map for quant manuscripts
hypothesis-development
Purpose
Generate typed, grounded hypotheses for quantitative manuscripts with explicit traces to literature gaps, contribution claims, and model constructs.
Inputs
- gap_summary
- contribution_claims
- model_constructs
- analysis_findings
Outputs
- hypothesis_table
- hypothesis_grounding_trace
- hypothesis_model_map
Required Policies
- citation-verification
- theory-claims-discipline
- hypothesis-grounding
- quant-rigor
Profile Keys Read
- method.family
- method.subtype
- journal.emphasis
- writing.tone
Constraints
- None
Process Steps
- Resolve active profile overlays and confirm method.family is quant
- Adjust hypothesis type options based on method.subtype (e.g., panel designs support temporal hypotheses, cross-sectional designs prioritize synchronic relationships)
- Parse gap_summary into numbered literature gaps (G1, G2 ...)
- Parse contribution_claims into typed claims (C1, C2 ...)
- Parse model_constructs into DVs, IVs, moderators, mediators
- Generate candidate hypotheses anchored to gap + claim pairs
- Assign each hypothesis a type (direct-effect, moderation, mediation, curvilinear)
- State direction and theoretical justification for each hypothesis
- Build hypothesis_grounding_trace linking H# to gap to claim
- Build hypothesis_model_map linking H# to constructs and model layer
- Apply hypothesis-grounding policy checks; flag violations
- If analysis_findings provided, add confirmation/disconfirmation status to each H
- Produce hypothesis_table with all fields
Failure Handling
- If method.family is not quant, warn and recommend theory-positioning or qualitative-coder skill instead
- If gap_summary is missing, request literature synthesis output and pause
- If contribution_claims is missing, infer from context with explicit warning
- If model_constructs are missing, produce hypotheses with construct placeholders
- If hypothesis-grounding check fails, mark affected H as provisional and add TODO