Repository navigation
2.5.3 - poteto-mode says where its playbooks are
poteto-mode's Playbooks section told the agent to open a playbook's steps at playbooks/<title>.md and did not say what that path is relative to. The head of the same file gives bundled skills as ../<name>/SKILL.md from this file. A Codex agent that reads a playbook in one shell call with sibling skills gives the playbook that skills/ base too, as in cat <plugin>/skills/how/SKILL.md <plugin>/skills/playbooks/investigation.md. That read fails with No such file or directory, because the playbooks are in skills/poteto-mode/playbooks/, and the agent spends a turn finding them. The sentence now reads "open its steps at playbooks/<title>.md from this file (skills/poteto-mode/playbooks/<title>.md), with the title in kebab case." Thanks to @adryanev for the report and the diagnosis in #71.
#71 counts 16 of these failures in the reporter's session logs from 2026-11-04 to 2026-11-08, across 15 sessions, all shell reads in Codex, 13 on 2.2.1 and 3 on 2.2.8. This Mac's Codex sessions show the same failure. From 2026-10-15 to 2026-11-08, 33 Codex sessions read a playbook from an installed t3-pstack 93 times. 6 of those reads used skills/playbooks/<title>.md, in 3 sessions, on 2.0.0-rc.5, rc.9, rc.15, rc.17, 2.1.0, and 2.2.0. 5 of the 6 ran on gpt-6.1-sol and 1 on gpt-6-astra. 5 of the 6 read the playbook in the same call as a sibling skill, and each was followed by a read of the right path 5 to 29 seconds later. Before each failure, Codex had handed the model the whole SKILL.md, Playbooks sentence included, a few seconds earlier, so a cut read does not explain it. Claude Code's sessions on this Mac show none, since Claude Code names a skill's base directory when it loads the skill.
The change is a substitution in tools/substitutions.json, anchored on Lauren's sentence. The fix was first written for 2.2.9 against the sentence "open its full steps at playbooks/<title>.md,". Lauren's pstack 0.15.43 (cursor/plugins 2f87c85) reworded it to "open its steps at playbooks/<title>.md, with the title in kebab case.", so that rule matched nothing and never shipped. This release anchors it on the new sentence, which is the same at the pin 0b46ec3 and at cursor/plugins main as of aaeb0ea. tools/forks.json declares poteto-mode's SKILL.md a fork, so its copy carries the substitution's text, and its own lines differ from derived upstream exactly as in 2.5.2, which are the four rules the fork declares. The playbooks name each other the same way, as in playbooks/shipping.md, and the Babysit playbook names ../references/bugbot-triage.md. No session on this Mac shows a failed read of either kind, so this release leaves them.
12 fresh Codex threads on T3 0.1.8-nightly.20261108.4367 tested the 2.2.9 draft, whose suffix is the same, against 2.2.8 as the control. Each was asked a question for the Investigation playbook, three per arm on codex/gpt-6-astra and three on codex/gpt-6.1-sol, all at reasoningEffort=xhigh. All 6 on the draft opened <checkout>/plugins/pstack/skills/poteto-mode/playbooks/investigation.md on the first try, one in the same cat as two sibling skills. All 6 on 2.2.8 did too, so the control did not reproduce the failure. At the logs' rate of 6 in 93, six runs see no failure about two times in three. So the runs show that the new words resolve to the right file, and do not measure how much the failure rate drops. These runs were not repeated on 2.5.3's wording.
Verification.
On macOS 27.0:
bun tools/generate.mjs --checkreports 14 generated files current.GIT_CONFIG_GLOBAL=/dev/null bun test tests/ --timeout 30000passes 545, skips 56, and fails 0. The installer's end-to-end test passes 18 of 18 with Claude Code 2.1.329 and Codex 0.171.0.validate-skillskeeps every local link inside the skills tree.- The dry run at
0b46ec3passes for all three components, with no undeclared fork and no substitution that matches nothing, and its report matches 2.5.2's line for line. - Deriving poteto-mode's
SKILL.mdfrom upstream at0b46ec3with the substitutions gives "open its steps atplaybooks/<title>.mdfrom this file (skills/poteto-mode/playbooks/<title>.md), with the title in kebab case." Diffed against the forked copy, it shows only the four declared fork rules, as on 2.5.2.
This release syncs nothing from Lauren's pstack, so all three components stay pinned at cursor/plugins 0b46ec3, and the notices keep that pin. Neither hooks file changes. This is a patch release, and no user has to act. On Codex, run npx -y github:chhoumann/t3-pstack update as after every release.