# Scientific specification

Project: [name]
Version and date: [identifier]
Researcher approval: [pending / approved, with date]

## Research question and estimands
- Question and intended interpretation:
- Target population and analysis sample:
- Quantities to estimate, comparisons, units, and time periods:
- Assumptions needed for that interpretation:

## Inputs and sample rules
- Approved inputs, versions, dictionary, and access location:
- Inclusion, exclusion, and missing-data rules:
- Required variables, derivations, units, and supported ranges:

## Estimator and reported outputs
- Estimation procedure, statistical model, and relevant settings:
- How fitted results become the requested estimands, including any averaging or standardization:
- Uncertainty calculation and any decision rule:
- Required tables, figures, and saved full-precision results:

## Checks
- Input and execution checks:
- Known-truth scenarios and performance measures, where applicable:
- Independent comparisons and numerical tolerances, where applicable:

## Unresolved decisions
[List questions for the researcher. Do not silently supply missing choices.]

Have the agent maintain the current approved specification here, rewriting it
when decisions change. Record each approved scientific change and its reason
in METHODOLOGY.md, newest entry first. Preserve earlier specification versions
in version control and retain frozen protocols used for particular runs.
