Commit the current work — runs the quality, consistency and passport gates, branches off main if needed, stages specific files, and writes a commit whose subject states what is now true. Pushes and opens a pull request only with --pr or when the user asks; never merges — a merge happens only when the user explicitly says to merge. Use ONLY on explicit commit intent — user says "commit", "let's commit this", "open a PR", or prefixes with `/commit`. Do NOT auto-invoke on vague end-of-task phrases ("we're done", "wrap up") — those require explicit confirmation first. Never force-pushes or skips hooks.
Verify the gates, then commit. A commit is not a pull request, and a pull request is not a merge.
This skill stops after the commit. It pushes and opens a pull request only with --pr or when the
user asks, and it never merges — a merge happens only when the user explicitly says to merge
that pull request (see "Merging" below). Reviewers such as Codex and Copilot comment after a pull
request opens; merging before they report skips their review.
Run before branching. For every changed .qmd, .tex, or .R file that has quality rubrics, run:
python3 scripts/quality_score.py <changed-file-paths>./scripts/install-hooks.sh has been run, .githooks/pre-commit re-runs the same ≥80 gate on the staged .qmd/.tex/.R files, so carry an approved override into Step 4 as SKIP_QUALITY_GATE=1 git commit ... and record the override reason in the commit message. That variable skips only the quality score; the backtest still runs. Never fall back to git commit --no-verify.Spawn the verifier agent (via the Agent tool with subagent_type=verifier) to run compilation/render checks on the changed files. Report pass/fail before committing.
Runs once per commit, here or in the git hook. The gate is the full backtest suite — all eleven gates (surface-sync count claims like "18 agents, 62 skills, 37 rules, 9 hooks" and marked tables, skill integrity, model currency, links, spec conformance, staleness, repo hygiene, derived counts, ledger coverage, hook battery, portability).
First decide where it runs. Leave it to the git hook only when all three of these hold, because only then is the hook sure to run this same suite on this commit. (It leaves out the hook battery when nothing the battery tests is staged, since the battery's result cannot change then; CI always runs everything.)
git config --get core.hooksPath # must print .githooks
test -x "$(git rev-parse --show-toplevel)/.githooks/pre-commit" && echo executable # must print executable
git status --porcelain -- ':/.githooks' # must print nothingcore.hooksPath is .githooks: ./scripts/install-hooks.sh has been run..githooks/ is changed, staged or untracked. An edited hook is itself what needs testing, and it could exit 0 without running the suite. Git refuses a commit only when the hook exits nonzero.If all three hold, say so in one line and skip the run here: running it twice costs a minute or more and adds nothing. A red gate then shows up in Step 4, where the hook refuses the commit and prints that gate's output. Treat that refusal exactly like a red result below; the fix is never --no-verify.
Otherwise, run the suite here:
./scripts/backtest.shIf the diff touches a manuscript (.tex/.qmd) that has a passport in quality_reports/passports/, any source_file a passport lists, or any file a claim declares as a display (its location:, or an appears_in path:), read that passport: a load-bearing claim with status: FAIL or STALE is a must-fix — halt, name the claim, and point at /audit-reproducibility (or the stale script) before committing. A touched display triggers the check for the same reason a touched script does: editing one artifact's copy of a number desynchronizes it from that number's other displays — the supplement or deck holding the same value was not necessarily updated in the same commit. Skip silently when no passport exists.
git status
git diff --stat
git log --oneline -5Never commit directly to main. If the current branch is main, create one; if you are already on
a feature branch, commit there.
git checkout -b <short-descriptive-branch-name>Add specific files (never use git add -A):
git add <file1> <file2> ...Do NOT stage .claude/settings.local.json or any files containing secrets.
If $ARGUMENTS is provided, use it as the commit message. Otherwise, analyze the staged changes and write a message that explains why, not just what.
The subject line states what is TRUE AFTER the commit — a plain sentence about behavior that a reader could go and test. "Fixed review feedback" and "Updated the checker" narrate your afternoon and tell a reader nothing; "The parity gate refuses a fixture whose hash is unregistered" is a claim they can check against the code. Process narration — which review round it came from, who asked, how many attempts it took — belongs in the body if it belongs anywhere. The body still carries the why; the subject carries the claim.
git commit -m "$(cat <<'EOF'
<commit message here>
EOF
)"--pr or when the user asksWithout --pr, and without the user asking for a pull request, skip this step: the commit stays
local and the report says so.
Fork safety check (#175/#176): Before running gh pr create, check git remote get-url origin.
If origin is a fork (not github.com/pedrohcgs/claude-code-my-workflow), pass --repo <HOST>/<OWNER>/<NAME>,
read from that URL, explicitly to gh pr create (with the host: an OWNER/NAME pin still lets
GH_HOST pick the server) unless the user explicitly asked to open a pull request upstream
against pedrohcgs/claude-code-my-workflow — otherwise gh pr create defaults to the upstream
template repository and publishes the user's paper/coursework PR publicly there.
git push -u origin <branch-name>
gh pr create --repo <HOST>/<OWNER>/<NAME> --title "<short title>" --body "$(cat <<'EOF'
## Summary
<1-3 bullet points>
## Changed defaults
<"None", or each default a forker will notice changing: a setting, a threshold, a hook that now fires, a path that moved>
## Test plan
<checklist>
🤖 Generated with [Claude Code](https://claude.com/claude-code)
EOF
)"Report the commit (hash and subject), the branch, and — if a pull request was opened — its URL. Say plainly that nothing was merged.
A merge is never a step of this skill. Merge only when the user explicitly asks to merge a specific pull request ("merge #155"); "ship it", "done" or "commit" are not a merge instruction. Before merging, check that the pull request's CI is green and that its reviews (human, Codex, Copilot) have been read and answered.
gh pr merge <pr-number> --merge --delete-branch
git checkout main
git status --porcelain # must print nothing before the next line runs
git pullExpect the tree to be dirty here — that is what Step 3 is for. Staging specific files means
everything the session touched but did not stage, plus every untracked artifact, is still in the
tree when you arrive at this step. The dirty-tree-guard hook this template ships denies
git pull (and merge, and rebase) while tracked files have uncommitted changes, because a
pull that resolves on top of uncommitted work cannot be reviewed afterwards — you can no longer
tell which hunk came from the remote. Untracked files do not count: git itself refuses a pull
that would overwrite one. The hook reads the tree before the command runs, so chaining a stash
into the same command line does not help: it sees the tree as it was.
Clear the tree deliberately, then pull, each line as its own command:
git stash push -u -m "post-merge: unstaged leftovers" # -u, or untracked files stay behind
git pull
git stash popgit pull --autostash is refused like any other pull while tracked files are dirty.
ALLOW_DIRTY_MERGE=1 is the hatch for a dirty state you have looked at and can justify out loud.
It is not the routine remedy, and reaching for it because the block is inconvenient is the
behavior the check exists to prevent.
main. If the user insists on skipping, record their override reason in the commit message.main; branch off it first.settings.local.json and sensitive files from staging.--merge (not --squash or --rebase) unless they say otherwise.$ARGUMENTS is provided, use it exactly.| Flag | Effect |
|---|---|
--pr | After the commit, push the branch and open a pull request (Step 5). Never merges. |
pedrohcgs/claude-code-my-workflow
fe70774
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.