script-quality-gate

Enforce Python script quality by validating module docstrings, argparse usage, __main__ entrypoints, and logging configuration. This ensures runnable scripts adhere to project conventions and prevents codebase drift.

To pass a code quality gate, a Python CLI script must have a top-level module docstring, a parse_args function, a main function guard, proper logging setup, and correct import paths.

Yes, you can check argparse consistency and __main__ entrypoints for new Python scripts. The validation verifies CLI conventions, provides helpful --help output, and confirms the presence of a main() guard.

You need a module docstring and logging setup in your Python CLI to prevent ambiguity and codebase drift. These standards ensure scripts describe their purpose and handle execution logs correctly.

This quality gate works with both new scripts and changes to existing runnable scripts or CLI flags across Python projects. It validates structure, naming, and packaging conventions in either case.