Submit review
Reference for how a finished ticket reaches human review in the Gaffer factory. Submission is RUNNER-OWNED — the agent commits its work and evidences the ACs, then stops; the runner records the delivery, pushes, opens the PR, and submits for review. Invoke when you think your work is ready to hand off, to confirm what you must do (commit + evidence) and what the runner does for you (push, PR, submit).From its SKILL.md
npx -y skills add tmj-90/gaffer --skill submit-reviewAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
3.1 KB, 644 tokens by cl100k_base, as published. Nobody here has run it
Handing a ticket to review (runner-owned)
You do not submit your own work. In the Gaffer factory the runner — not the
agent — owns delivery bookkeeping: after your agent run it runs the gates
(tests/lint/hygiene/minimalism), records the delivery, pushes the branch and opens the
PR when a remote exists, and moves the ticket to in_review. This makes submission
deterministic and token-free, and guarantees a ticket is only ever submitted once its
gates are green.
What YOU do (then stop)
- Confirm every AC is evidenced. Call
get_ticket(Dispatch MCP) and check each AC has true evidence. If any is missing, record it via therecord-evidenceskill. - Confirm the gates are green in this session: tests (
run-tests), lint (run-lint), and any coverage threshold the ticket requires. Fix anything red. - Commit on the feature branch with a clear conventional message referencing the
ticket (
git add -A && git commit -m "deliver #<n>: <summary>"). An uncommitted edit is NOT a delivery — the branch must carry your commit. If you forget, the runner auto-commits your uncommitted changes as a safety net, but commit yourself. - Stop. Do not push, do not open a PR, do not call
submit_ticket_for_review. The runner does all of that. If you cannot finish (open question, missing dependency, failing environment), callmark_ticket_blockedwith a clear reason instead of leaving half-done work.
What the RUNNER does (not you)
- Runs the Definition-of-Done and hygiene/minimalism gates on your committed diff.
- Records the delivery (branch + diff summary + per-repo delivery rows).
- Pushes the branch and opens the PR (
gh pr create) when the repo has a remote. - Submits the ticket for review (moves it to
in_review).
Rules
- Never self-approve
doneor merge — only a human does, after review. - Never push, open a PR, or
submit_ticket_for_reviewyourself — that is the runner's job. - Don't consider yourself done until every AC has real evidence and the gates are green — the runner's gates will bounce a delivery that isn't.
Capture lore
This skill is one of the places durable, reusable knowledge naturally surfaces:
A delivery-time gotcha — a non-obvious build/test/landing step or environment quirk that the next agent on this repo will hit. That kind of fact is lore. Capture it via the lore-capture
protocol in your brief (CLAUDE.factory.md, step 11 "Memory contribution"):
call the Memory MCP suggest_lore once at the close of your work — reusable
conventions, gotchas, decisions, and boundaries only, never per-ticket trivia.
What ships with it
Read from the repository
Just SKILL.md. No reference files, no scripts.