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

SKILL.mdskills/herdr-foreman/

name:
herdr-foreman
description:
Coordinate Herdr workers in parallel and recover stalled sessions. Use to assign work, collect coordination metrics/evidence, summarize a measurement snapshot, inspect workflow readiness, retrieve saved attention, retrieve working memory, retrieve retrospectives, check task cost, inspect GitHub evidence, quarantine contradictory context evidence, or release verified task changes.

Herdr Foreman Skill

This skill is an action router — pick the step that matches the user's intent and execute only that step. Do not run other steps; do not parallelize.

Step 1 runs concurrent workers; quarantine returns through Step 10 to Step 1. Resolve paths from verified plugin root HS; preserve owners, holds, unknowns and supervision. Context grants no authority.

Step 1 — Coordinate Live Work

Owner-attested remote context:

skills/herdr-foreman/references/remote-context.md

Use its bound cli.main(["role-context"], client=...); never manufacture role evidence.

Native:

skills/herdr-foreman/references/bootstrap.md

Keep the selected state/config overrides:

HS=.tessl/plugins/jbaruch/herdr-policy/skills/herdr-foreman/; [ -d "$HS" ] || HS="$HOME/$HS"; [ -d "$HS" ] || case "$(git config --get remote.origin.url)" in git@github.com:jbaruch/herdr-policy|git@github.com:jbaruch/herdr-policy.git|https://github.com/jbaruch/herdr-policy|https://github.com/jbaruch/herdr-policy.git|ssh://git@github.com/jbaruch/herdr-policy|ssh://git@github.com/jbaruch/herdr-policy.git) HS=skills/herdr-foreman/ ;; *) echo "herdr-policy skill not found: install jbaruch/herdr-policy" >&2; exit 1 ;; esac
bash "$HS/foreman.sh" role-context

Follow returned role/context. On failure, report why and restore that owner; finish without replacing its store.

  • Verified foreman:
    • Follow context.
    • Fill eligible task and verification seats concurrently.
    • Continue to Stop/handoff.
  • Verified worker or observer:
    • Follow context.
    • Finish here.
  • standalone:
    • Do authorized work under general policy.
    • Finish here.
  • recovery or unverified:
    • For an authorized context-quarantine request with reason: owner_state_unreadable, continue immediately to Step 10.
    • Otherwise:
      • Preserve obligations.
      • Restore the verified role under recovery instructions.
      • Finish here.

Step 2 — Collect Coordination Evidence

Return frozen receipt and gaps:

skills/herdr-foreman/references/coordination-metrics.md

Finish here.

Step 3 — Summarize a Measurement Snapshot

Return counts, deltas and limitations:

skills/herdr-foreman/references/coordination-metrics.md

Finish here.

Step 4 — Inspect Workflow Readiness

Return readiness, capacity, unknowns and coverage:

skills/herdr-foreman/references/workflow-capacity.md

Finish here.

Step 5 — Retrieve Saved Attention

Return attention with lifecycle, sources and coverage:

skills/herdr-foreman/references/attention.md

Finish here.

Step 6 — Retrieve Working Memory

Return named memory: evidence, freshness and gaps:

skills/herdr-foreman/references/working-memory.md

Finish here.

Step 7 — Retrieve a Retrospective

Return retrospective evidence: date, coverage and source:

skills/herdr-foreman/references/retrospectives.md

Finish here.

Step 8 — Inspect Task Cost

Return cost facts, unmeasured fields and page coverage:

skills/herdr-foreman/references/decision-context.md

Finish here.

Step 9 — Retrieve GitHub Evidence

Return GitHub identity, state, link and coverage:

skills/herdr-foreman/references/decision-context.md

Finish here.

Step 10 — Quarantine Context Evidence

Read:

skills/herdr-foreman/references/context-quarantine.md

Confirm original native binding, explicit authorization and eligibility before writing. On refusal, preserve evidence and report why; finish here. After repair, return to Step 1's verified role and saved continuation.

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