General-purpose coding policy for Baruch's AI agents
74
93%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
Low
Low-risk findings worth noting
Read every review in full first. Read every review_bodies[].body and inline_comment_bodies[].body in Step 5's snapshot, including human, other-bot and historical reviews, before judging any item (see rules/reviewer-feedback-reading.md). The bot-specific reviews fields route verdicts, never limit reading
Then act by severity (see rules/review-severity.md): blocking findings — fix now; advisory findings — acknowledge in the existing team task report or round log, or note them directly in standalone review replies.
Fold an advisory only when an already-required blocking correction touches the same surface and adds no push or verification round
An advisory creates no obligation for an issue, follow-up, push or delivery prerequisite
Never run an advisory-only re-review round
CI failures: Fix every one
Review suggestions: Apply what's right. Push back on anything that misreads scope — cite concrete evidence (file:line, log line, spec quote) when declining
Reply to addressed blocking findings. Ordinary advisory replies may accompany the existing review work, but are outside merge prerequisites. Use these opening literals:
Fixed in <sha> (literal phrase; Done / Accepted and fixed do not satisfy)Declining — <reason with cited evidence> (em dash —, not hyphen or period)Acknowledged — advisory noted; in a team round, Acknowledged — recorded in <task report or round-log ref>. Use the existing record; never simulate a team report or create a new follow-up obligationAcknowledged — deferred to #<follow-up issue> (judge ruling <digest>) under skills/release/references/REVIEW_DETAILS.md; its ruling and issue obligations are unchangedMarginal blocking policy finding: a nominated policy finding may go to a weighing instead of a fix (rules/review-severity.md Judge-Weighed Finding Carve-Out)
fixskills/release/references/team-ruling-interface.md.skills/release/references/REVIEW_DETAILS.mdRuled policy review: list or dismiss with the script below
--task through the optional interface.rules/external-repo-contributions.md--ruling it lists the blocking findings to name in the question--ruling it posts the ruled findings to the follow-up issue, then dismisses the review, only when its predicate holds.unmet naming each failed condition; 2 usage or API errorskills/release/dismiss-ruled-review.sh header, not restated here (rules/script-as-black-box.md)KS=.tessl/plugins/jbaruch/coding-policy/skills/release/; [ -d "$KS" ] || KS="$HOME/$KS"; [ -d "$KS" ] || case "$(git config --get remote.origin.url)" in git@github.com:jbaruch/coding-policy|git@github.com:jbaruch/coding-policy.git|https://github.com/jbaruch/coding-policy|https://github.com/jbaruch/coding-policy.git|ssh://git@github.com/jbaruch/coding-policy|ssh://git@github.com/jbaruch/coding-policy.git) KS=skills/release/ ;; *) echo "coding-policy skill not found: run tessl install jbaruch/coding-policy" >&2; exit 1 ;; esac
bash "$KS/dismiss-ruled-review.sh" <owner> <repo> <pr-number> --ruling <ruling-file> --followup-issue <issue-number>KS=.tessl/plugins/jbaruch/coding-policy/skills/release/; [ -d "$KS" ] || KS="$HOME/$KS"; [ -d "$KS" ] || case "$(git config --get remote.origin.url)" in git@github.com:jbaruch/coding-policy|git@github.com:jbaruch/coding-policy.git|https://github.com/jbaruch/coding-policy|https://github.com/jbaruch/coding-policy.git|ssh://git@github.com/jbaruch/coding-policy|ssh://git@github.com/jbaruch/coding-policy.git) KS=skills/release/ ;; *) echo "coding-policy skill not found: run tessl install jbaruch/coding-policy" >&2; exit 1 ;; esac
bash "$KS/dismiss-ruled-review.sh" <owner> <repo> <pr-number> --ruling <judge-report> --followup-issue <issue-number> --task <task-id>Push fixes to the same branch
Both reviewers run automatically after each required push; return to Step 5.
The policy reviewer re-runs automatically on every push (coding-policy via review-codex.yml pull_request: synchronize; consumers via review-trigger.yml re-dispatching the fleet App). No manual re-request.
Repeat Step 5 until neither reviewer carries a blocking finding — APPROVED, COMMENTED with its body read and only advisories, or a policy RULED after a ruled dismissal — with addressed blocking findings replied to. Proceed immediately to Step 7.
.tessl-plugin
rules
skills
migrate-to-plugin
onboard-repo
release
hooks
references