Skip to content

Commit 01bb0a3

Browse files
illeatmyhatclaude
andcommitted
fix(platform-integrations): make codex/bob recall an imperative first action
Bob (Gemini fork) reliably ignored the passive 'at the start of a task, look through .evolve/entities/' recall directive (missed 2/2 live), while Codex obeyed. The lever is salience, not content: reframe recall as an explicit FIRST action ('before reading source or running anything') and fold the audit step into that same action ('the moment you open entities, record them ... before you move on'), so the consult-then-audit pair is one act rather than two passive notes. Validated headlessly: Bob now recalls AND audits 2/2 (was 0/2); Codex still recalls with a proper thread-id audit row (no regression). Shared else-branch only; the Claude native-memory branch is untouched. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent eb73854 commit 01bb0a3

4 files changed

Lines changed: 56 additions & 40 deletions

File tree

platform-integrations/bob/evolve-lite/EVOLVE.md

Lines changed: 14 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -7,22 +7,26 @@ decide, on your own judgment, when something is worth remembering — nothing
77
forces a save, and there is no step to "complete." Curate this store like notes
88
you'll thank yourself for later: small, accurate, high-signal.
99

10-
## Recall — at the start of a non-trivial task
11-
12-
Before substantive work (code changes, debugging, repo exploration, or
13-
environment/tooling investigation), look through `./.evolve/entities/` if it
14-
exists. Every entity carries a `trigger` line in its frontmatter describing the
15-
situation it applies to. Read the triggers, open the entity files whose trigger
16-
looks relevant to the task at hand, and let them inform what you do. If the
17-
directory is missing or nothing looks relevant, just proceed — that's normal.
10+
## Recall — your first action, before any other tool use
11+
12+
On a non-trivial task (code changes, debugging, repo exploration, or
13+
environment/tooling investigation), your FIRST action — before reading source,
14+
running commands, or anything else — is to check `./.evolve/entities/`: list
15+
that directory, read each entity's `trigger` line, and open the entity files
16+
whose trigger matches the task. The moment you open one or more entities, your
17+
next step — still part of this same first action — is to record them with the
18+
audit command under "Record what you consulted" below; do it before you move on
19+
to the task. Let what you find inform the work that follows. If the directory is
20+
missing or nothing matches, note that and proceed — that's normal.
1821

1922
Entities reflect what was true when written. If one names a file, function,
2023
command, or flag, verify it still exists before relying on it.
2124

2225
## Record what you consulted
2326

24-
After recall, log which entities you actually opened, so the value of this
25-
memory can be measured over time. Run:
27+
Whenever you opened entities in the recall step above, record them now — run
28+
this before doing anything else, so the value of this memory can be measured
29+
over time:
2630

2731
```bash
2832
python3 ~/.bob/evolve-lite/audit_recall.py <id> [<id> ...]

platform-integrations/claw-code/plugins/evolve-lite/EVOLVE.md

Lines changed: 14 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -7,22 +7,26 @@ decide, on your own judgment, when something is worth remembering — nothing
77
forces a save, and there is no step to "complete." Curate this store like notes
88
you'll thank yourself for later: small, accurate, high-signal.
99

10-
## Recall — at the start of a non-trivial task
11-
12-
Before substantive work (code changes, debugging, repo exploration, or
13-
environment/tooling investigation), look through `./.evolve/entities/` if it
14-
exists. Every entity carries a `trigger` line in its frontmatter describing the
15-
situation it applies to. Read the triggers, open the entity files whose trigger
16-
looks relevant to the task at hand, and let them inform what you do. If the
17-
directory is missing or nothing looks relevant, just proceed — that's normal.
10+
## Recall — your first action, before any other tool use
11+
12+
On a non-trivial task (code changes, debugging, repo exploration, or
13+
environment/tooling investigation), your FIRST action — before reading source,
14+
running commands, or anything else — is to check `./.evolve/entities/`: list
15+
that directory, read each entity's `trigger` line, and open the entity files
16+
whose trigger matches the task. The moment you open one or more entities, your
17+
next step — still part of this same first action — is to record them with the
18+
audit command under "Record what you consulted" below; do it before you move on
19+
to the task. Let what you find inform the work that follows. If the directory is
20+
missing or nothing matches, note that and proceed — that's normal.
1821

1922
Entities reflect what was true when written. If one names a file, function,
2023
command, or flag, verify it still exists before relying on it.
2124

2225
## Record what you consulted
2326

24-
After recall, log which entities you actually opened, so the value of this
25-
memory can be measured over time. Run:
27+
Whenever you opened entities in the recall step above, record them now — run
28+
this before doing anything else, so the value of this memory can be measured
29+
over time:
2630

2731
```bash
2832
python3 ~/.claw/evolve-lite/audit_recall.py <id> [<id> ...]

platform-integrations/codex/plugins/evolve-lite/EVOLVE.md

Lines changed: 14 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -7,22 +7,26 @@ decide, on your own judgment, when something is worth remembering — nothing
77
forces a save, and there is no step to "complete." Curate this store like notes
88
you'll thank yourself for later: small, accurate, high-signal.
99

10-
## Recall — at the start of a non-trivial task
11-
12-
Before substantive work (code changes, debugging, repo exploration, or
13-
environment/tooling investigation), look through `./.evolve/entities/` if it
14-
exists. Every entity carries a `trigger` line in its frontmatter describing the
15-
situation it applies to. Read the triggers, open the entity files whose trigger
16-
looks relevant to the task at hand, and let them inform what you do. If the
17-
directory is missing or nothing looks relevant, just proceed — that's normal.
10+
## Recall — your first action, before any other tool use
11+
12+
On a non-trivial task (code changes, debugging, repo exploration, or
13+
environment/tooling investigation), your FIRST action — before reading source,
14+
running commands, or anything else — is to check `./.evolve/entities/`: list
15+
that directory, read each entity's `trigger` line, and open the entity files
16+
whose trigger matches the task. The moment you open one or more entities, your
17+
next step — still part of this same first action — is to record them with the
18+
audit command under "Record what you consulted" below; do it before you move on
19+
to the task. Let what you find inform the work that follows. If the directory is
20+
missing or nothing matches, note that and proceed — that's normal.
1821

1922
Entities reflect what was true when written. If one names a file, function,
2023
command, or flag, verify it still exists before relying on it.
2124

2225
## Record what you consulted
2326

24-
After recall, log which entities you actually opened, so the value of this
25-
memory can be measured over time. Run:
27+
Whenever you opened entities in the recall step above, record them now — run
28+
this before doing anything else, so the value of this memory can be measured
29+
over time:
2630

2731
```bash
2832
python3 ~/.codex/evolve-lite/audit_recall.py <id> [<id> ...]

plugin-source/EVOLVE.md.j2

Lines changed: 14 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -41,22 +41,26 @@ decide, on your own judgment, when something is worth remembering — nothing
4141
forces a save, and there is no step to "complete." Curate this store like notes
4242
you'll thank yourself for later: small, accurate, high-signal.
4343

44-
## Recall — at the start of a non-trivial task
45-
46-
Before substantive work (code changes, debugging, repo exploration, or
47-
environment/tooling investigation), look through `./.evolve/entities/` if it
48-
exists. Every entity carries a `trigger` line in its frontmatter describing the
49-
situation it applies to. Read the triggers, open the entity files whose trigger
50-
looks relevant to the task at hand, and let them inform what you do. If the
51-
directory is missing or nothing looks relevant, just proceed — that's normal.
44+
## Recall — your first action, before any other tool use
45+
46+
On a non-trivial task (code changes, debugging, repo exploration, or
47+
environment/tooling investigation), your FIRST action — before reading source,
48+
running commands, or anything else — is to check `./.evolve/entities/`: list
49+
that directory, read each entity's `trigger` line, and open the entity files
50+
whose trigger matches the task. The moment you open one or more entities, your
51+
next step — still part of this same first action — is to record them with the
52+
audit command under "Record what you consulted" below; do it before you move on
53+
to the task. Let what you find inform the work that follows. If the directory is
54+
missing or nothing matches, note that and proceed — that's normal.
5255

5356
Entities reflect what was true when written. If one names a file, function,
5457
command, or flag, verify it still exists before relying on it.
5558

5659
## Record what you consulted
5760

58-
After recall, log which entities you actually opened, so the value of this
59-
memory can be measured over time. Run:
61+
Whenever you opened entities in the recall step above, record them now — run
62+
this before doing anything else, so the value of this memory can be measured
63+
over time:
6064

6165
```bash
6266
python3 {{ audit_script }} <id> [<id> ...]

0 commit comments

Comments
 (0)