● Reckoneerhow it works
Reckoneer / Stage 1
Stage 1IntakeOperator

Run Intake

The Run Intake form is the starting gun for every Reckoneer run. Nothing automated happens until the operator fills it in and submits.

The form collects: the target store's .myshopify.com domain, the Admin API access token for that store, the competitor URL to analyze, and the adaptation mode (Mirror, Adapt, or Inspire).

On submission, Reckoneer validates the credentials against the Shopify API, creates a Run record in the database, writes a CAPTURE-SPEC.md to the docs folder, and advances the run to Stage 2. The operator can then watch the pipeline progress through subsequent stages.

Terms
Run

A single end-to-end execution of the Reckoneer pipeline for one store against one competitor URL. Each run has its own record, status, and set of output documents.

AnalogyLike a single print job sent to a printer. You can send many jobs — each is tracked separately, has its own settings, and produces its own output.
OriginRun: from Old English 'rinnan' (to flow, to move quickly). In software: a single execution of a defined process from start to finish.
Adaptation mode

A runtime parameter set at intake that controls how closely the output theme mirrors the competitor: Mirror (close copy of layout and structure), Adapt (similar structure, adapted for the client's brand), or Inspire (competitor as inspiration only, original design produced).

AnalogyLike a cover song instruction to a musician. 'Mirror' means play it note-for-note. 'Adapt' means play the same song but in your style. 'Inspire' means write a new song inspired by that one.
OriginAdapt: from Latin 'adaptare' (to fit to). Mode: from Latin 'modus' (measure, manner). Together: the manner in which fitting takes place.
CAPTURE-SPEC.md

A markdown document written to the docs folder at the end of intake. Contains the competitor URL, adaptation mode, and any operator notes. Read by Stage 2 (Capture) to know what to analyze.

AnalogyA work order handed to the next crew. Intake fills out the form; the capture crew reads it to know exactly what job they're doing.
OriginSpec: short for specification, from Latin 'specificare' (to mention particularly). A document that defines what is required.