CtrlK
BlogDocsLog inGet started
Tessl Logo
PluginPublic

jbaruch/herdr-policy

Herdr team coordination policy for AI coding agents

Quality

93%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Overview
Quality
Evals
Security
Files

coding-policy-integration.mdskills/herdr-foreman/references/

Coding Policy Integration

Sync and Checkouts

  • Applies only to a verified Herdr team round under skills/herdr-foreman/references/team-scope.md.
  • The foreman provisions each writer's worktree and records its fetched base.
  • Before repository inspection, workers run git fetch origin from the assigned task checkout and verify the fresh remote default under generic sync-before-work.
  • Provisioning never waives that floor. Preserve the original registered task base and assigned head; incompatible freshness or missing checkout authority becomes a blocked report before inspection, not an unrequested rebase or reset.
  • The generic pinned-ref exception requires its actual user instruction and stated starting ref.
  • The operator resolves listed shared-checkout items by push, commit, pull request or delete.
  • The foreman carries out none of those resolutions.
  • Foreman teardown is limited to the merged task's worktree under skills/herdr-foreman/references/foreman-workflow.md Step 15 and its binding post-merge order.
  • Workers retain diagnostics and handoff obligations on their own changed files.
  • Narrow exception for the explicitly admitted schema-2 task executor.
  • Applies only under its verified current service generation and the admission boundaries in skills/herdr-foreman/references/task-workflow.md.
  • Preconditions are binding: read skills/herdr-foreman/references/task-workflow.md Ownership and current inputs and Process lifetime and cleanup before relying on it.
  • Its isolated writer/base verification and fixed post-acceptance cleanup follow that contract instead of the legacy round's Writers and Checkouts and Step 15 paperwork.
  • Native provenance, actual merged-head verification, preservation of unrelated work and generic release gates remain binding.
  • Every other team round retains the legacy provisions above.

Review and Release

  • Advisory findings are acknowledged in the existing task report or round log; they create no follow-up or delivery prerequisite.
  • The release worker reports blocking findings to the foreman and performs no source repair.
  • Team weighing and pinned-judge verification follow skills/herdr-foreman/references/release-integration.md.
  • Generic release gates and floors remain binding after team authority verification.

Accepted Scope Exclusion

  • Narrow exception for a Judge-Accepted Defect Carve-Out in a team fix loop that did not converge.
  • Applies only to the excluded defect in the shipped team scope.
  • Preconditions (all required):
    1. The current exhaustion has a recorded REMEDY: stop diagnosis.
    2. The excluded defect has a tracked issue.
    3. The shipped scope excludes that work and carries no other blocking finding.
    4. CI, external review and independent reviewer/tester passes hold on the shipped tip.
  • The operator may override the stop by explicitly authorizing a plan over it.
  • Every other blocking finding follows the generic review rule.

Script Output

  • Narrow exception for skills/herdr-foreman/review-package.sh artifact-path stdout under generic script delegation.
  • Applies only to this script's completed review package.
  • Input is recorded BASE HEAD [OUTFILE] in the target checkout. With no OUTFILE, use the owner's FOREMAN_REPORTS_DIR; the script header owns exit details.
  • Preconditions (all required):
    1. Success emits only the absolute completed package path and a newline.
    2. The package contains the resolved commit range, commit list, diff stat and patch.
    3. Failure emits no path, exits nonzero and gives an actionable stderr diagnostic.
    4. tests/herdr-foreman/tests/test_review_package.py verifies the contract.
  • Every other skill script retains the generic JSON-output requirement.

skills

herdr-foreman

antigravity.example.json

bootstrap-repository.py

compose-briefs.sh

config.example.json

foreman-tier-check.py

foreman.sh

label-workspaces.sh

measurements.py

native-hook.sh

observer-view.py

policy-paths.py

prepare-briefs.py

provision-worktree.sh

prune-report-caches.py

resolve-gates.sh

resolve-policy-paths.sh

review-package.sh

roster.sh

round-preflight.sh

SKILL.md

start-judge-worker.sh

state-schema.md

sweep-worktrees.sh

verify-authority.sh

wait-report.sh

workflow-review.py

README.md

tile.json