commit-precheck

You can validate staged files against forbidden patterns to block non-feature files from being committed. This prevents task breakdowns, progress dashboards, and implementation reports from polluting the repository history.

A pre-commit hook for repository cleanliness validates staged files before finalizing a commit. It blocks administrative documents like task breakdowns and implementation reports, ensuring only relevant code work is added.

Run the validation hook script before your git commit to check staged files. The script checks staged Git files and alerts you to unstage any items matching forbidden patterns before the commit finalizes.

Commit validation does work with specific file naming conventions by enforcing directory structures for allowed files. It blocks files matching forbidden patterns, ensuring only properly named code passes the pre-commit checks.

If you accidentally stage a task breakdown file, the commit precheck blocks the commit and alerts you to unstage it. This prevents planning documents and other non-feature files from entering the repository.