feat(framework): read action files before running, across all skills#389
Merged
Conversation
Reorder brainstorm finalize so the persist offer (file/ticket/session) runs before the next-move pointer, and slim the persist step. The truncatable closing beat becomes the guidance, never the durable artifact, which weak-adherence hosts were dropping. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01WKWd6AVpdYSCmRZWQWAnRt
Add a uniform routing line to every router skill's SKILL.md and the skill-generate template: before running an action, read its file in actions/, not only the table or assets. Hosts that do not follow the SKILL router into the action files (codex, copilot) were improvising steps from SKILL.md alone and skipping action-only detail such as the brainstorm persist offer. Verified on codex and Claude: multi-action flows and the majority of skills now open their action files; Claude still reads assets, no regression. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01WKWd6AVpdYSCmRZWQWAnRt
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01WKWd6AVpdYSCmRZWQWAnRt
blafourcade
added a commit
that referenced
this pull request
Jul 6, 2026
…389) * fix(refine): finalize persists before pointing to the next move Reorder brainstorm finalize so the persist offer (file/ticket/session) runs before the next-move pointer, and slim the persist step. The truncatable closing beat becomes the guidance, never the durable artifact, which weak-adherence hosts were dropping. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01WKWd6AVpdYSCmRZWQWAnRt * feat(framework): read the action file before running it Add a uniform routing line to every router skill's SKILL.md and the skill-generate template: before running an action, read its file in actions/, not only the table or assets. Hosts that do not follow the SKILL router into the action files (codex, copilot) were improvising steps from SKILL.md alone and skipping action-only detail such as the brainstorm persist offer. Verified on codex and Claude: multi-action flows and the majority of skills now open their action files; Claude still reads assets, no regression. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01WKWd6AVpdYSCmRZWQWAnRt * docs(framework): record the PR template in vcs memory Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01WKWd6AVpdYSCmRZWQWAnRt --------- Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
This was referenced Jul 6, 2026
Merged
Merged
Merged
Merged
Merged
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Every router skill now tells the host to read an action's file before running it, and the brainstorm finalize step is reordered so it persists before pointing to the next move.
Why
On hosts that don't follow the
SKILL.mdrouter into theactions/files (codex, copilot), skills were improvising steps fromSKILL.mdalone. The clearest symptom: brainstormfinalizenever offered to persist (file/ticket/session) because that detail lives only inactions/04-finalize.md, which those hosts never opened. Two fixes:SKILL.mdand the skill-generate template:finalizereordered so the persist offer runs before the next-move pointer, making the truncatable closing beat the guidance, never the durable artifact.Testing (headless, codex + Claude)
planandbrainstormread their action files and their assets (plan-template, phase-template) — thenot only the table or assetswording does not make Claude skip assets. No regression.Known limits (out of scope here)
aidd-orchestrator/00-async-devuses nestedactions/setup/+actions/run/dirs; the generic line was not applied there.Future skills
The line is baked into
skill-generate's template, so newly generated skills carry it automatically.