agent-scripts — Shared Guardrail Scripts for Agents

Practical Notes

• Quant: track how many repos adopt the pointer-style AGENTS.MD line; the goal is 1 shared source of truth, not copy/paste drift.
• Quant: run the validator on every commit and measure “skills failing lint” rate over time (it should trend down).

Why pointer-style AGENTS beats copy/paste

Copying guardrails into every repo guarantees divergence. Pointer-style rules give you:

• One canonical shared rule set.
• Fast updates across the fleet.
• Clear “local overrides” when a repo truly needs them.

How to introduce safely

1. Start with one pilot repo.
2. Add the pointer line at the top of AGENTS.MD.
3. Keep repo-specific notes below it.

Maintenance habit

When a guardrail changes, update it once here, then roll it out like any dependency update: changelog + verification run.

FAQ

Q: Is this only useful for one author’s repos? A: The pattern generalizes well: shared scripts + shared rules are valuable in any multi-repo team.

Q: Do I need Bun? A: Only for rebuilding certain compiled helpers; the guardrail text and hooks can still be used without it.

Q: What is the biggest failure mode? A: Breaking changes to shared rules without a rollout plan—treat updates like dependency upgrades.