Rename Engineer in Box to Shiny (gt-8tmz.10)

Renamed mol-engineer-in-box to mol-shiny across all documentation
and test code. This is a Mad Max reference - the canonical 'right
way to engineer'.

Files updated:
- docs/architecture.md (15 references)
- docs/molecules.md (7 references)
- docs/bootstrap.md (1 reference)
- docs/molecular-chemistry.md (1 reference)
- docs/polecat-wisp-architecture.md (1 reference)
- internal/beads/molecule_test.go (test function rename)

🤖 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 19:56:01 -08:00
parent 11545b5e1f
commit c5934273ef
6 changed files with 29 additions and 29 deletions

View File

@@ -454,8 +454,8 @@ Molecules are stored as JSONL in `molecules.jsonl`:
```json ```json
{ {
"id": "mol-engineer-in-box", "id": "mol-shiny",
"title": "Engineer in Box: {{feature}}", "title": "Shiny: {{feature}}",
"description": "Full workflow from design to merge.", "description": "Full workflow from design to merge.",
"labels": ["template"], "labels": ["template"],
"issue_type": "epic" "issue_type": "epic"
@@ -465,7 +465,7 @@ Molecules are stored as JSONL in `molecules.jsonl`:
Steps are hierarchical children with dependencies encoded as beads edges: Steps are hierarchical children with dependencies encoded as beads edges:
``` ```
mol-engineer-in-box mol-shiny
├── .1 design "Think about architecture" ├── .1 design "Think about architecture"
├── .2 implement "Write the code" ← depends on .1 ├── .2 implement "Write the code" ← depends on .1
├── .3 review "Self-review changes" ← depends on .2 ├── .3 review "Self-review changes" ← depends on .2
@@ -485,7 +485,7 @@ Molecules compose via bonding - attaching one molecule to another:
``` ```
mol-gastown-polecat (composed) mol-gastown-polecat (composed)
├── [mol-engineer-in-box steps bonded here] ├── [mol-shiny steps bonded here]
│ ├── .1 design │ ├── .1 design
│ ├── .2 implement │ ├── .2 implement
│ ├── .3 review │ ├── .3 review
@@ -496,7 +496,7 @@ mol-gastown-polecat (composed)
**Composition via bond:** **Composition via bond:**
```bash ```bash
bd mol bond mol-engineer-in-box $PARENT_MOL bd mol bond mol-shiny $PARENT_MOL
bd create "Install binary" --parent=$PARENT_MOL --deps=.5 bd create "Install binary" --parent=$PARENT_MOL --deps=.5
``` ```
@@ -563,7 +563,7 @@ Proto Molecule (template)
**Wisp structure:** **Wisp structure:**
``` ```
gt-abc123 (Proto: engineer-in-box) gt-abc123 (Proto: shiny)
▼ bond ▼ bond
gt-abc123.exec-001 (Wisp Molecule) ← wisp=true, parent=gt-abc123 gt-abc123.exec-001 (Wisp Molecule) ← wisp=true, parent=gt-abc123
@@ -699,7 +699,7 @@ pending → in_progress → completed
When a molecule is attached to an issue: When a molecule is attached to an issue:
```bash ```bash
gt spawn --issue gt-xyz --molecule mol-engineer-in-box gt spawn --issue gt-xyz --molecule mol-shiny
``` ```
1. Molecule is validated (steps, dependencies) 1. Molecule is validated (steps, dependencies)
@@ -711,13 +711,13 @@ gt spawn --issue gt-xyz --molecule mol-engineer-in-box
**Provenance tracking:** **Provenance tracking:**
- Each instance has an `instantiated_from` edge to the source molecule - Each instance has an `instantiated_from` edge to the source molecule
- Enables querying: "show all instances of mol-engineer-in-box" - Enables querying: "show all instances of mol-shiny"
### Standard Molecules ### Standard Molecules
Gas Town includes formula files (`.beads/formulas/`) for standard molecules: Gas Town includes formula files (`.beads/formulas/`) for standard molecules:
**mol-engineer-in-box** (5 steps): **mol-shiny** (5 steps):
``` ```
design → implement → review → test → submit design → implement → review → test → submit
``` ```
@@ -747,13 +747,13 @@ bd cook <formula-id>
gt molecule list gt molecule list
# Show molecule details # Show molecule details
gt molecule show mol-engineer-in-box gt molecule show mol-shiny
# Instantiate on an issue # Instantiate on an issue
gt molecule instantiate mol-engineer-in-box --parent=gt-xyz gt molecule instantiate mol-shiny --parent=gt-xyz
# Spawn polecat with molecule # Spawn polecat with molecule
gt spawn --issue gt-xyz --molecule mol-engineer-in-box gt spawn --issue gt-xyz --molecule mol-shiny
``` ```
### Why Molecules? ### Why Molecules?
@@ -1002,7 +1002,7 @@ Each instantiation is independent. The ledger shows all runs, enabling compariso
| Customization | Edit description | Fork plugin molecule | | Customization | Edit description | Fork plugin molecule |
| Use case | Fixed workflows | Extensible workflows | | Use case | Fixed workflows | Extensible workflows |
Both patterns are valid. Use static molecules for well-defined workflows (mol-engineer-in-box, mol-polecat-work). Use pluggable molecules when dimensions should be customizable (mol-code-review, mol-witness-patrol). Both patterns are valid. Use static molecules for well-defined workflows (mol-shiny, mol-polecat-work). Use pluggable molecules when dimensions should be customizable (mol-code-review, mol-witness-patrol).
## Directory Structure ## Directory Structure
@@ -1954,7 +1954,7 @@ gt capture <polecat> "<cmd>" # Run command in polecat session
### Session Management ### Session Management
```bash ```bash
gt spawn --issue <id> --molecule mol-engineer-in-box # Spawn polecat with workflow gt spawn --issue <id> --molecule mol-shiny # Spawn polecat with workflow
gt handoff # Polecat requests shutdown (run when done) gt handoff # Polecat requests shutdown (run when done)
gt session stop <p> # Kill polecat session (Witness uses this) gt session stop <p> # Kill polecat session (Witness uses this)
``` ```

View File

@@ -221,4 +221,4 @@ echo "Bootstrap complete!"
After bootstrapping: After bootstrapping:
1. Start a Mayor session: `gt mayor attach` 1. Start a Mayor session: `gt mayor attach`
2. Check for work: `bd ready` 2. Check for work: `bd ready`
3. Spawn workers with molecules: `gt spawn --issue <id> --molecule mol-engineer-in-box` 3. Spawn workers with molecules: `gt spawn --issue <id> --molecule mol-shiny`

View File

@@ -693,7 +693,7 @@ Gas Town maintains a **library of curated protos** - the fuel stockpile:
``` ```
~/gt/molecules/ ~/gt/molecules/
├── mol-engineer-in-box/ # Full quality workflow ├── mol-shiny/ # Full quality workflow
├── mol-quick-fix/ # Fast path for small changes ├── mol-quick-fix/ # Fast path for small changes
├── mol-code-review/ # Pluggable review dimensions ├── mol-code-review/ # Pluggable review dimensions
├── mol-release/ # Release workflow ├── mol-release/ # Release workflow

View File

@@ -40,8 +40,8 @@ Molecules are standard beads issues stored in `molecules.jsonl`:
```json ```json
{ {
"id": "mol-engineer-in-box", "id": "mol-shiny",
"title": "Engineer in Box: {{feature_name}}", "title": "Shiny: {{feature_name}}",
"description": "Full workflow from design to merge.\n\nVars:\n- {{feature_name}} - What to build", "description": "Full workflow from design to merge.\n\nVars:\n- {{feature_name}} - What to build",
"labels": ["template"], "labels": ["template"],
"issue_type": "epic" "issue_type": "epic"
@@ -59,8 +59,8 @@ Molecules are standard beads issues stored in `molecules.jsonl`:
Molecules support `{{var}}` placeholders resolved at bond time: Molecules support `{{var}}` placeholders resolved at bond time:
```bash ```bash
bd mol bond mol-engineer-in-box --var feature_name="user auth" bd mol bond mol-shiny --var feature_name="user auth"
# Creates: "Engineer in Box: user auth" # Creates: "Shiny: user auth"
``` ```
Variables work in: Variables work in:
@@ -73,12 +73,12 @@ Variables work in:
Steps are hierarchical children of the molecule: Steps are hierarchical children of the molecule:
``` ```
mol-engineer-in-box (epic) mol-shiny (epic)
├── mol-engineer-in-box.1 "Design" ├── mol-shiny.1 "Design"
├── mol-engineer-in-box.2 "Implement" Needs: .1 ├── mol-shiny.2 "Implement" Needs: .1
├── mol-engineer-in-box.3 "Review" Needs: .2 ├── mol-shiny.3 "Review" Needs: .2
├── mol-engineer-in-box.4 "Test" Needs: .3 ├── mol-shiny.4 "Test" Needs: .3
└── mol-engineer-in-box.5 "Submit" Needs: .4 └── mol-shiny.5 "Submit" Needs: .4
``` ```
Dependencies are encoded in beads edges, not in step descriptions. Dependencies are encoded in beads edges, not in step descriptions.
@@ -103,7 +103,7 @@ bd mol bond <proto-id> [--wisp] [--var key=value...]
```bash ```bash
# Durable mol # Durable mol
bd mol bond mol-engineer-in-box --var feature_name="auth" bd mol bond mol-shiny --var feature_name="auth"
# Ephemeral wisp for patrol # Ephemeral wisp for patrol
bd mol bond mol-witness-patrol --wisp bd mol bond mol-witness-patrol --wisp

View File

@@ -56,7 +56,7 @@ and cleanup within a single ephemeral container.
│ │ Storage: .beads/ (git-tracked) │ │ │ │ Storage: .beads/ (git-tracked) │ │
│ │ │ │ │ │ │ │
│ │ Could be: │ │ │ │ Could be: │ │
│ │ - mol-engineer-in-box (full workflow) │ │ │ │ - mol-shiny (full workflow) │ │
│ │ - mol-quick-fix (fast path) │ │ │ │ - mol-quick-fix (fast path) │ │
│ │ - Any custom work molecule │ │ │ │ - Any custom work molecule │ │
│ │ - Direct issue (no molecule, just task) │ │ │ │ - Direct issue (no molecule, just task) │ │

View File

@@ -225,7 +225,7 @@ waitsfor: some-condition`
} }
} }
func TestParseMoleculeSteps_EngineerInBox(t *testing.T) { func TestParseMoleculeSteps_Shiny(t *testing.T) {
// The canonical example from the design doc // The canonical example from the design doc
desc := `This workflow takes a task from design to merge. desc := `This workflow takes a task from design to merge.