Coding policy for Viktor Gamov's AI agents: language-agnostic quality rules, autonomous shipping discipline, and stack defaults for JVM, Swift, TypeScript, and Python
98
94%
Does it follow best practices?
Impact
99%
1.45xAverage score across 10 eval scenarios
Low
Low-risk findings worth noting
The full Herdr team contract. rules/agent-team-operation.md loads in every session and carries only the mode switch and the worker essentials; the lead reads this file before planning a round, and it binds every team round in full.
rules/agent-team-operation.md Two Modes, which every session loadsskills/herdr-teamlead/references/specialists.mdteamlead detect-triggers classifies the round against that declaration before the roles are planned--retain-specialist for one advisor, investigator or architect assignmentskills/herdr-teamlead/references/specialists.md for profiles and assessment workflowjudge seat runs on the most capable model available and holds no other responsibilitystop is refused before the round runs, unless the operator authorized a plan over that remedyASSESSMENT: the investigator report it ruled on, and the record binds that pathDIAGNOSIS:, REMEDY: continue | restructure | stop, BOUND:, ASSESSMENT:, EVIDENCE: and UNVERIFIED:continue or restructure remedy's BOUND supplies the attempt budget the operator formerly suppliedBOUND counts developer attempts and justifies the number against the evidence the diagnosis citesBOUND above the ceiling teamlead diagnose enforces is refused, never silently honouredstop remedy ships what is clean and records the remainder as a tracked accepted defectstop remedy records a user-attention obligation the catch-up surfacesstop remedyrules/review-severity.md Judge-Accepted Defect Carve-Out; every other release gate holdsteamlead diagnose under the original task and base before acting on its remedystop remedy ends implementation on its task; no unspent allowance survives itcontinue → restructure → stop, or repeats one rung oncePROGRESS: line naming what the prior remedy changedstop is terminal and never repeats; a task takes at most five diagnosesgh command, never posts to GitHub, never dispatches a subagent — its only output is its report fileRULING: uphold A | uphold B | amend — <line> | insufficient — <facts needed> | blocked — <question> with numbered reasons, an ACTION: naming the minimal step, and an UNVERIFIED: lineinsufficient names the disputed facts the cited evidence cannot settleinsufficient ruling the lead dispatches an investigator to establish those facts with citationsinsufficient is not a completed ruling; a checkpoint never cites itPROGRESS:RULING: and ACTION: belong to adjudication alone; a diagnosis carries neitherblocked is the judge declining to ruleblocked is for a question only the operator can answer; a fact the tree can settle is insufficientblocked ruling stops the round and sends the named question to the operatorconfig.json, measured, and planned like every other seatclaude worker authenticate as one Claude subscription and draw on one weekly windowwindow_group names the usage window an agent shares with other agentswindow_groupjudge block names the seat's agent, and the model and effort its worker is launched withtop_models includedcoordination round, selected like a worker's tiertiers table maps round types to model, effort, and cost dataskills/herdr-teamlead/teamlead/tiers.py plus the ids in config.json's optional top_models blocktop_models ids extend the built-in set for their kind, never replace itskills/herdr-teamlead/teamlead/tiers.pyunknown; no model name establishes free capacityskills/herdr-teamlead/references/model-tiers.md--retain-context with the task identifier and fix-round number--no-clear records a hand-cleared pane, never retained contextcontinue or restructure, with its boundawaiting_diagnosis when implementation awaits the judge's remedyrules/agent-team-operation.md Workers)rules/agent-team-operation.md Workers, which every session loadscd <worktree> && prefixrules/agent-worktree-isolation.mdrules/agent-team-operation.md Workers, which every session loadsworking or blocked agentskills/herdr-teamlead/wait-report.sh, never a hand-rolled loopblocked verdict across two reads and the pane before acting on itnot_sent-equivalent and may be retriedskills/herdr-teamlead/references/dispatch-recovery.mdskills/herdr-teamlead/references/attention.mdskills/herdr-teamlead/wait-report.sh's --worktree contractskills/herdr-teamlead/references/assignment-reasoning.mdskills/herdr-teamlead/teamlead/tiers.pyskills/herdr-teamlead/state-schema.mdskills/herdr-teamlead/references/working-memory.mdskills/herdr-teamlead/references/attention.mdskills/herdr-teamlead/references/supervision.mdskills/herdr-teamlead/references/retrospectives.mdskills/herdr-teamlead/references/assignment-reasoning.mdskills/herdr-teamlead/teamlead/partition.py decides both refusals, through teamlead validate-partitionskills/release/poll-pr-reviews.sh, never the pre-merge watchrules/ci-safety.md Always Watch CIrules/review-severity.mdrules/external-repo-contributions.md.tessl-plugin
hooks
rules
skills
herdr-standup
herdr-teamlead
references
teamlead
templates
tests
onboard-repo
release
tests