Land worked example and hook checks on main - #5
Open
hexcon wants to merge 5 commits into
Open
Conversation
A complete six-phase session copied as-if from a project's artifacts folder: requirement, research with a recorded decision, a critiqued three-step plan, self-contained step files per references/step-format.md, and an execution log where every step closes on a named check. README links it from Quickstart and the repo tree.
A PreToolUse guard (hooks/check_step_verified.py) blocks marking a step complete in execution-log.md unless a .verified/step-NNN marker exists in the session folder. The marker is created by chaining it onto the step's real Validation command, so it exists only when the check exited 0. Fails open on anything it does not understand. Verified with six stdin cases (block/allow/other-file/in-progress/ malformed) against python3.
Ship a worked example session in the repo
Optional hook-enforced checks for the execution verify loop
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
1 participant
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.
PR #3 merged into its stacked base
six-phase-revisioninstead ofmain(the base branch was never deleted, so GitHub did not retarget). This PR carries that content home: the worked example session, and the hook-enforced checks once #4 merges into the same branch.Merge order: #4 first, then this. The diff here updates automatically as #4 lands. The README roadmap conflict between the two stacked PRs is already resolved on the #4 branch, including a preemptive tick of the LICENSE line to match main.
After merging, delete the
six-phase-revision,worked-example-session,hook-enforced-checks, andadd-licensebranches — the roadmap is then fully shipped on main.🤖 Generated with Claude Code