diff options
| author | Craig Jennings <c@cjennings.net> | 2026-06-14 22:07:00 -0500 |
|---|---|---|
| committer | Craig Jennings <c@cjennings.net> | 2026-06-14 22:07:00 -0500 |
| commit | e0f914d510c081db45cafaf4fe5c8f7b65e46fec (patch) | |
| tree | 8ad851aea65e0e5fc1b6adbc70355b435a4dde0d /.ai/workflows | |
| parent | 16e64fb5f81bd8c3eaa2dc4c00a796ddbec01441 (diff) | |
| download | rulesets-e0f914d510c081db45cafaf4fe5c8f7b65e46fec.tar.gz rulesets-e0f914d510c081db45cafaf4fe5c8f7b65e46fec.zip | |
docs(ai): require an epoch on the tail of helper-agent ids
A helper agent's session-context file is .ai/session-context.d/<id>.org. A bare, reused id like "codex" makes the next run resolve to the previous run's leftover anchor, which it then mistakes for a crash to recover or clobbers. That bit on 2026-06-13: a codex run left codex.org for the next session to clean up.
The fix is a convention, not a resolver change. The spawner appends an epoch on the tail (host.project.runtime.<epoch>) so each run gets a fresh anchor. The epoch can't be minted inside session-context-path, since that resolver runs many times per session and must return the same path each call. I documented it in protocols.org, the wrap-up recommended-shape note, and the resolver header.
Diffstat (limited to '.ai/workflows')
| -rw-r--r-- | .ai/workflows/wrap-it-up.org | 2 |
1 files changed, 1 insertions, 1 deletions
diff --git a/.ai/workflows/wrap-it-up.org b/.ai/workflows/wrap-it-up.org index 2d79795..139d612 100644 --- a/.ai/workflows/wrap-it-up.org +++ b/.ai/workflows/wrap-it-up.org @@ -84,7 +84,7 @@ idseg="${AI_AGENT_ID:+${AI_AGENT_ID}-}" mv "$sc" ".ai/sessions/${now}-${idseg}DESCRIPTION.org" #+end_src -Replace =DESCRIPTION= with your picked slug. (=AI_AGENT_ID= should be filename-safe; the recommended =host.project.runtime.shortid= shape already is.) +Replace =DESCRIPTION= with your picked slug. (=AI_AGENT_ID= should be filename-safe and unique per run; the recommended =host.project.runtime.<epoch>= shape is both. The epoch on the tail keeps a re-run of the same logical agent from resolving to a prior run's leftover anchor. See protocols.org "Agent-scoped path".) ** Step 3: todo.org cleanup (hygiene + archive completed work) |
