Skip to content

fix(implementation): environment setup belongs to the setup reference alone#553

Open
leeovery wants to merge 1 commit into
fix/spec-entry-bugfix-invokefrom
fix/environment-check-gathers-only
Open

fix(implementation): environment setup belongs to the setup reference alone#553
leeovery wants to merge 1 commit into
fix/spec-entry-bugfix-invokefrom
fix/environment-check-gathers-only

Conversation

@leeovery

@leeovery leeovery commented Jul 26, 2026

Copy link
Copy Markdown
Owner

Summary

The entry skill asked for setup instructions and wrote the document the processing skill also writes — while its own header said "information gathering only. Do NOT execute any setup commands at this stage. The processing skill contains instructions for handling environment setup." Whichever ran first won and the other silently took its already-exists arm. A prose-test walker hit exactly that on both runs.

One file owns it now. workflow-implementation-process/references/environment-setup.md checks whether the document exists, asks when it does not, and stores the answer. By implementation time it exists and is ready to use; if it somehow does not, the same reference creates it. No special handling, no second owner.

So the entry sheds it entirely:

  • Step 4: Check Environment removed (Invoke becomes Step 4)
  • references/environment-check.md deleted
  • the handoff drops its Environment: line, which existed only to carry an answer the entry no longer gathers
  • environment-setup.md returns to exactly what it was on main

An earlier version of this PR split ownership — entry asks, process records — which only relocated the confusion. This replaces it.

The implementation-picks-first-task prose case is updated to the settled design: the entry hands off without touching the environment, and the setup step consumes the answer and records the document.

Test plan

  • npm test green: 1699 tests, 0 fail. Corpus valid, 13 cases.
  • environment-setup.md is byte-identical to main — verified.

🤖 Generated with Claude Code

@leeovery
leeovery force-pushed the fix/environment-check-gathers-only branch 2 times, most recently from 42108f0 to 4c916fa Compare July 26, 2026 13:37
… alone

The entry skill asked for setup instructions and wrote the document the
processing skill also writes, while its own header said "information
gathering only. Do NOT execute any setup commands at this stage. The
processing skill contains instructions for handling environment setup."
Whichever ran first won and the other silently took its already-exists
arm. A prose-test walker hit exactly that.

An earlier attempt at this split ownership — entry asks, process records
— which only moved the confusion. Lee's call, and the right one: one file
owns it. environment-setup.md checks whether the document exists, asks
when it does not, and stores the answer; by implementation time it exists
and is ready to use, and if it somehow does not, the same reference
creates it. No special handling, no second owner.

So the entry sheds it entirely: Step 4 (Check Environment) and
environment-check.md are gone, and the handoff drops its `Environment:`
line, which existed only to carry an answer the entry no longer gathers.
environment-setup.md returns to exactly what it was.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@leeovery
leeovery force-pushed the fix/environment-check-gathers-only branch from 4c916fa to 1976e37 Compare July 26, 2026 13:43
@leeovery leeovery changed the title fix(implementation): the entry gathers the environment answer, the process records it fix(implementation): environment setup belongs to the setup reference alone Jul 26, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant