Tool documentation
Pre-commit Hook
Guidance for sf-validate, aligned with the same reading rhythm, navigation model, and contrast system used across the rest of the site.
Pre-commit Hook
A pre-commit hook is appropriate when you want fast local feedback before changes are pushed to CI.
Current status
This page is currently served from a generated fallback so the published documentation route remains usable. It provides the core context teams need while source markdown is being finalized.
Recommended workflow
- Install the tool in the same environment where your build or validation steps run.
- Execute it locally against representative inputs before wiring it into CI.
- Promote the exact same command shape into automation so local and pipeline behavior stay aligned.
Example
sf-validate sample-events.jsonl
Where this fits
sf-validate belongs to the build phase of the SpanForge system. It should feel consistent with the rest of the platform: clear purpose, deterministic outputs, and documentation that helps teams move from experiment to governed production.