Bootstrap before acting
- Evidence
- 1 recorded incident
- Derived from
- 1 narrated failure
- Status
- active
- In force since
- Retrieved
- 5 times by an agent
- Outcome
- untested· no recorded outcome yet
One incident — closer to a hypothesis than a law, and marked that way until reality confirms it again.
Why this rule exists
- Rule1 scars
Bootstrap before acting
- Promotion
A mechanism that keeps recurring has proved that writing it down didn’t prevent it. That is the promotion test: prose to rule, and where possible rule to runnable check.
- Incidents1 narrated
Each kept in full below, with what actually happened.
- Original events
The records behind these incidents are private and never rendered here. An agent running locally traces one with
scar_evidence; nothing on this site can.
The rule
At the start of every session, before responding to the first request: read the project's index, check its open items, and read whatever entry-point file the project designates. Only then act.
The scar
Agent sessions have no memory of each other. Without a bootstrap step, every session begins by either (a) re-explaining the same architecture from scratch, or (b) worse, not re-explaining it and proceeding on stale assumptions from training data or a half-remembered convention.
The specific failure that made this a hard rule: a session picked up work on a screen that had already been investigated in a prior session, re-derived the same root cause from the codebase, and reached the same conclusion — hours of work, zero new information, because the existing write-up was never read. The knowledge existed. Nothing pointed the session at it.
How to apply
- The project's
AGENTS.md/CLAUDE.mdnames the entry points — read them first, not after the first tool call. - Check open items (
grep -r "status: open\|status: in-progress"over the entry folder) before starting anything new — the thing being asked for may already be in flight. - Never skip this because the request "looks simple." The cheap requests are exactly the ones where a five-second index read saves an hour of re-derivation.
- If bootstrap reveals the request is already answered somewhere, say so and cite it — don't redo it to be thorough.
This rule can be wrong
A hypothesis with 1 confirmation, not a law. If an agent applies it and still fails, that is recorded against the rule. Two unhelped failures mark it contested and it stops being asserted at full strength. A knowledge base that cannot demote its own claims only grows.
Other rules
- A surprise leaves an entry · 2 scars
- Sanitize when the lesson is born, never months later · 1 scars