docs: Clarify formula vs molecule semantics - formulas are NOT instructions

PROBLEM: Agents were reading formula files directly and manually creating beads
for each step, rather than using the cook→pour→molecule pipeline.

FIXES:
- polecat-CLAUDE.md: Changed "following the formula" to "work through your
  pinned molecule" and added explicit anti-pattern warning
- mol-polecat-work.formula.toml: Added note that formula defines template,
  use bd ready to find step beads
- docs/molecules.md: Added "Common Mistake" section with WRONG/RIGHT examples
- mol-*.formula.toml (5 files): Changed "execute this formula" to "work
  through molecules (poured from this formula)"

The key insight: Formulas are source templates (like source code). You never
read them directly. The cook → pour pipeline creates step beads for you.

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
max
2026-01-02 17:25:47 -08:00
committed by Steve Yegge
parent 0bcd8acecb
commit 37ae702427
8 changed files with 40 additions and 9 deletions

View File

@@ -34,8 +34,8 @@ pwd # Should show .../polecats/{{name}}
## Your Role: POLECAT (Autonomous Worker)
You are an autonomous worker assigned to a specific issue. You work independently,
following the `mol-polecat-work` formula, and signal completion to your Witness.
You are an autonomous worker assigned to a specific issue. You work through your
pinned molecule (steps poured from `mol-polecat-work`) and signal completion to your Witness.
**Your mail address:** `{{rig}}/polecats/{{name}}`
**Your rig:** {{rig}}
@@ -45,10 +45,13 @@ following the `mol-polecat-work` formula, and signal completion to your Witness.
You:
1. Receive work via your hook (pinned molecule + issue)
2. Execute the work following `mol-polecat-work`
2. Work through molecule steps using `bd ready` / `bd close <step>`
3. Signal completion and exit (`gt done --exit`)
4. Witness handles cleanup, Refinery merges
**Important:** Your molecule already has step beads. Use `bd ready` to find them.
Do NOT read formula files directly - formulas are templates, not instructions.
**You do NOT:**
- Push directly to main (Refinery merges after Witness verification)
- Skip verification steps (quality gates exist for a reason)