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
Medium
Suggest reviewing before use
Read this contract when the execution plan reaches one of its steps. Execute
only the current step and the continuation it names. Step numbers refer to
skills/herdr-foreman/SKILL.md.
Read the open tasks waiting for a seat, oldest first:
CP=.tessl/plugins/jbaruch/coding-policy; [ -d "$CP" ] || CP="$HOME/$CP"; [ -d "$CP" ] || 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) CP=. ;; *) echo "coding-policy plugin not found: run tessl install jbaruch/coding-policy" >&2; exit 1 ;; esac
bash "$CP/skills/herdr-foreman/foreman.sh" foreman-queueIt prints {"schema_version": 1, "queue": [...]}. Each entry names task,
waiting_for (a list of developer, reviewer or tester),
dispatched_seats, since, developer and fix_round. A non-zero exit names
an unusable state file on stderr; restore it before planning. Tasks with an
active worker are omitted. A partitioned verifier stays listed with its
dispatched slices; check them against the validated partition. The order is a
default; choose another when the round needs it.
Choose the responsibilities needed next under skills/herdr-foreman/references/specialists.md.
Supply its requirements file for specialized work. Schedule consultation and
verification as the task needs them. plan bars a developer reserved to
another task and a worker with an active enrollment, and names each bar in its
rationale; do not pass --exclude for either. apply re-reads the
reservations before sending. Reusing a reserved developer elsewhere requires
closing its task first.
The composition triggers decide part of that roster. Classify this round
against the repo's declaration first. For a pre-implementation round, pass
--planned naming the surfaces the work will touch. A round that writes no
repository content — an investigation, an architecture or advisory consultation
— declares writes_repository: false in that file instead
(skills/herdr-foreman/references/specialists.md). That explicit read-only plan requires no repo
trigger declaration. An existing declaration must still be valid. A round with
work already written classifies that work:
CP=.tessl/plugins/jbaruch/coding-policy; [ -d "$CP" ] || CP="$HOME/$CP"; [ -d "$CP" ] || 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) CP=. ;; *) echo "coding-policy plugin not found: run tessl install jbaruch/coding-policy" >&2; exit 1 ;; esac
bash "$CP/skills/herdr-foreman/foreman.sh" detect-triggers \
--repo <repo-path> --base <recorded-base> [--head <pushed-head>] \
--roles <role[,role...]> [--requirements <requirements.json>] \
[--planned <planned.json>] [--decisions <decisions.json>] \
[--bootstrap-declaration <reviewed-triggers.json>]Exit 0 means every fired trigger is staffed or answered. On exit 1, read the
stderr object. A writing repo with no declaration uses the one-time reviewed
bootstrap contract in skills/herdr-foreman/references/specialists.md;
and an unaddressed_trigger is staffed in the roles below or answered by a
recorded decision with its reason. Re-run the command with the updated
declaration, roles, requirements and decisions after every such change, and
plan only once it exits 0.
A round that will split its review surface validates the partition first, then
plans it with --partition:
CP=.tessl/plugins/jbaruch/coding-policy; [ -d "$CP" ] || CP="$HOME/$CP"; [ -d "$CP" ] || 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) CP=. ;; *) echo "coding-policy plugin not found: run tessl install jbaruch/coding-policy" >&2; exit 1 ;; esac
bash "$CP/skills/herdr-foreman/foreman.sh" validate-partition \
--repo <repo-path> --base <recorded-base> [--head <pushed-head>] \
--partition <partition.json>Exit 1 names every unowned path, every overlap and every slice owning nothing,
in one run. Fix the partition and re-run; plan only once it exits 0. Save its
stdout — plan --partition takes that result, never the document
validate-partition read. Validate at the pushed head: the result's proof
records the repo, base and head it was proven against, and Step 12's gate
cannot check a working-tree proof. Format, ownership
payload and the seating it produces:
skills/herdr-foreman/references/review-partition.mdCP=.tessl/plugins/jbaruch/coding-policy; [ -d "$CP" ] || CP="$HOME/$CP"; [ -d "$CP" ] || 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) CP=. ;; *) echo "coding-policy plugin not found: run tessl install jbaruch/coding-policy" >&2; exit 1 ;; esac
bash "$CP/skills/herdr-foreman/foreman.sh" plan \
--roles <role[,role...]> [--requirements <requirements.json>] \
[--exclude <role>=<agent>[,<agent>...]]... [--partition <validated.json>] \
[--judge-mode adjudication|diagnosis] \
[--round <role>=<round-type>] [--round-context <evidence.json>] \
--task <task-id> [--fix-round <N>] [--correction-plan <id> --work <work.json>]Emits the role plan without worker contact. Under config schema 7,
worker_kinds records the ranked template and assignments records one fresh,
plan-bound live identity per seat; a later plan creates different identities.
A partitioned role is seated once
per slice as <role>#<slice>, and Step 10 dispatches each seat with its own
brief. A judge seat declares its mode:
adjudication rules on a contested verdict, diagnosis on the investigator's
assessment at an exhausted allowance. Pass the same --judge-mode to apply.
On exit 1, resolve the diagnostic before continuing. Apply the Step 5 constraints in skills/herdr-foreman/references/round-setup.md:
exclude contributors from verification, reserve the developer through early fixes,
preserve task identity and fix count, and reuse recorded correction bounds.
Tier contracts:
Operator-opted minimum-adequate worker routing follows Minimum Adequate Routing in the reference below. Refresh selected-candidate facts, not unrelated fleet maintenance; preserve task authority, independence, explicit pins and judgment floors.
skills/herdr-foreman/references/model-tiers.md
skills/herdr-foreman/references/dispatch-recovery.mdSave the plan and rationale. Proceed immediately to Step 6.
For reviewer/tester briefs, run from a checkout holding the recorded commits:
CP=.tessl/plugins/jbaruch/coding-policy; [ -d "$CP" ] || CP="$HOME/$CP"; [ -d "$CP" ] || 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) CP=. ;; *) echo "coding-policy plugin not found: run tessl install jbaruch/coding-policy" >&2; exit 1 ;; esac
bash "$CP/skills/herdr-foreman/review-package.sh" \
<recorded-base-sha> <pushed-head-sha> <round-reports-dir>/review-<base7>..<head7>.diffApply the Step 6 base, range, and rebuild requirements in
skills/herdr-foreman/references/round-setup.md. Success prints the absolute review-package path;
set it as REVIEW_PACKAGE. On non-zero, fix the diagnostic and retry before
composing verification briefs. Other roles need no package.
Proceed immediately to Step 7.
.tessl-plugin
hooks
rules
skills
adopt-fork-pr
herdr-foreman
classify
foreman
references
specialists
templates
tests
herdr-standup
migrate-to-plugin
onboard-repo
release
references
tests