docs: Propagate Rig/Cook/Run lifecycle terminology

Updated the following docs to reference the Rig/Cook/Run lifecycle:
- propulsion-principle.md: Added lifecycle overview, updated steam metaphor table
- sling-design.md: Added see-also reference to molecular-chemistry.md
- molecules.md: Added lifecycle summary diagram, formula context
- architecture.md: Added Rig/Cook/Run overview, added Formula to concepts table

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Steve Yegge
2025-12-25 12:29:54 -08:00
parent c0ecd31699
commit 68aa592145
4 changed files with 62 additions and 40 deletions

View File

@@ -3,6 +3,7 @@
This document covers the molecule system in depth.
For an overview, see [architecture.md](architecture.md#molecules-composable-workflow-templates).
For the full lifecycle (Rig → Cook → Run), see [molecular-chemistry.md](molecular-chemistry.md).
## Core Concepts
@@ -264,30 +265,29 @@ bd mol bond mol-code-review --var scope="src/"
## Lifecycle Summary
Gas Town work follows the **Rig → Cook → Run** lifecycle:
```
┌─────────────┐
│ Proto │ Template in molecules.jsonl
│ (frozen) │ labels: ["template"]
└──────┬──────┘
▼ bd mol bond [--wisp]
┌─────────────┐
│ Mol/Wisp Active execution
│ (flowing) Mol: .beads/ | Wisp: .beads-wisp/
└──────┬──────┘
┌────┴────┐
▼ ▼
burn squash
│ │
▼ ▼
(gone) Digest
(permanent)
RIG (source) COOK (artifact) RUN (execution)
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Formula │──────►│ Proto │──────►│ Mol/Wisp │
│ (.yaml) │ cook │ (cooked/frozen)│ pour/ │ (flowing) │
│ │ │ │ wisp │
└─────────────────┘ └─────────────────┘ └────────┬────────┘
┌────┴────┐
▼ ▼
burn squash
▼ ▼
(gone) Digest
(permanent)
```
**Steam engine metaphor:**
- Proto = Fuel (potential energy)
- Mol/Wisp = Steam (kinetic energy)
- Digest = Distillate (crystallized work)
- Burn = Steam dissipates
- Squash = Steam condenses
**Full lifecycle:**
- **Formula** (.formula.yaml) = Recipe (source code for workflows)
- **Proto** = Fuel (cooked template, ready to instantiate)
- **Mol/Wisp** = Steam (active execution)
- **Digest** = Distillate (crystallized work)
See [molecular-chemistry.md](molecular-chemistry.md) for the complete specification.