Helix
Advance uncertain work by closing one evidence loop at a time. Cadence is a
completed Arrange → Act → Assert/Collapse transition; activity volume is not
progress.
Keep the transition laws visible
- Checkpoint before work. Require an explicitly configured surface,
reference, representation, and read/write authority. If any is missing,
return
NEEDS-HUMAN-DECISION; never invent a file, service, or transcript
fallback. A Ralph-style or goal loop's persisted prompt or plan file carries
execution and intent, not learning; treat it as the checkpoint only when the
user has configured it as the surface.
- Arrange before Act. Freeze the supplied situation or need, intended
effect and proof, authority and boundary, selected branch's contribution, one
move's maximum scope, observation source, review point, and expected plus
disconfirming readbacks. Missing framing makes Next a repair or block,
never permission to experiment.
Helix sequences a supplied move; it does not classify the causal regime or
design the probe. When installed, Read the Terrain owns that upstream work.
- Act once. Keep one move in flight. Give its executor only the outcome
boundary, branch contribution, move, observation source, review point, and
readbacks. Stop at the first readback, review point, or boundary.
- Assert before another Act. Append the immutable observation beside the
frozen readbacks, then classify it as
Expected, Disconfirming, Mixed, or
Inconclusive. Effort, confidence, and retrospective producer narration are
not evidence.
- Collapse every ended move. Sort delivered work to its store of record,
retired work to an epitaph, and everything else to deliberate disposal.
Rewrite the checkpoint with exactly one Next before another Act.
The checkpoint stores verdicts, not deliberation: outcome, surviving branches,
active arranged moves and results, open links, epitaphs, and one Next. Re-derive
candidates and ranking each cycle. A matching readback establishes only what
was observed inside its boundary; it does not prove value, correctness, or
causality.
Run the current state
Start at the first incomplete transition; never repeat a completed phase.
- Read the checkpoint whole.
- Expand: derive branches from the outcome and latest results; drop any
candidate whose possible results leave the next decision unchanged. Check
epitaph resurrection conditions, select one branch, and keep implementation
inspection behind the arranged move.
- Spike: Arrange, then Act once.
- Collapse: Assert, sort the ended move, rewrite the checkpoint, and select
one Next.
Load only the applicable section of
checkpoint and edge cases:
- configure or reconstruct a checkpoint;
- repair an orphan or unknown link;
- resolve
Mixed or Inconclusive evidence;
- retire, resurrect, retry, or dispose of work.
Return the checkpoint reference, Next, and every orphan, unknown, or
authority block.
1---2name: helix3description: Use when uncertain or inherited work risks unframed experiments or accumulating plans and needs one bounded evidence loop plus a compact checkpoint; not for routine work with clear scope and order.4---56# Helix78Advance uncertain work by closing one evidence loop at a time. Cadence is a9completed **Arrange → Act → Assert/Collapse** transition; activity volume is not10progress.1112## Keep the transition laws visible1314- **Checkpoint before work.** Require an explicitly configured surface,15 reference, representation, and read/write authority. If any is missing,16 return `NEEDS-HUMAN-DECISION`; never invent a file, service, or transcript17 fallback. A Ralph-style or goal loop's persisted prompt or plan file carries18 execution and intent, not learning; treat it as the checkpoint only when the19 user has configured it as the surface.20- **Arrange before Act.** Freeze the supplied situation or need, intended21 effect and proof, authority and boundary, selected branch's contribution, one22 move's maximum scope, observation source, review point, and expected plus23 disconfirming readbacks. Missing framing makes **Next** a repair or block,24 never permission to experiment.25 Helix sequences a supplied move; it does not classify the causal regime or26 design the probe. When installed, Read the Terrain owns that upstream work.27- **Act once.** Keep one move in flight. Give its executor only the outcome28 boundary, branch contribution, move, observation source, review point, and29 readbacks. Stop at the first readback, review point, or boundary.30- **Assert before another Act.** Append the immutable observation beside the31 frozen readbacks, then classify it as `Expected`, `Disconfirming`, `Mixed`, or32 `Inconclusive`. Effort, confidence, and retrospective producer narration are33 not evidence.34- **Collapse every ended move.** Sort delivered work to its store of record,35 retired work to an epitaph, and everything else to deliberate disposal.36 Rewrite the checkpoint with exactly one **Next** before another Act.3738The checkpoint stores verdicts, not deliberation: outcome, surviving branches,39active arranged moves and results, open links, epitaphs, and one **Next**. Re-derive40candidates and ranking each cycle. A matching readback establishes only what41was observed inside its boundary; it does not prove value, correctness, or42causality.4344## Run the current state4546Start at the first incomplete transition; never repeat a completed phase.47481. Read the checkpoint whole.492. **Expand:** derive branches from the outcome and latest results; drop any50 candidate whose possible results leave the next decision unchanged. Check51 epitaph resurrection conditions, select one branch, and keep implementation52 inspection behind the arranged move.533. **Spike:** Arrange, then Act once.544. **Collapse:** Assert, sort the ended move, rewrite the checkpoint, and select55 one **Next**.5657Load only the applicable section of58[checkpoint and edge cases](references/checkpoint-and-edge-cases.md):5960- configure or reconstruct a checkpoint;61- repair an orphan or unknown link;62- resolve `Mixed` or `Inconclusive` evidence;63- retire, resurrect, retry, or dispose of work.6465Return the checkpoint reference, **Next**, and every orphan, unknown, or66authority block.