Validators

Skill and instruction files drift in small ways that are cheap to catch the moment they are written.

What is validated, and where the rules live

After each write or edit, pi/validate-tool-use.ts validates the file in-process (pi/support/validators.ts, a port of hooks/validators/). It appends suggestions for SKILL.md (at most three red-line advisories per edit), instruction files (AGENTS.md, CLAUDE.md, GEMINI.md, rules/), and docs/specs/ artifacts. It needs no Python. The Python validators in hooks/ remain for validate_all.py and the parity test.