constraint-preflight

The constraint-preflight skill provides a pre-flight verification process for scheduling constraint development. It addresses a common problem in constraint-based scheduling systems where constraints are created, tested, and exported but fail to be registered in the ConstraintManager, resulting in constraints not being applied during schedule generation. This skill ensures that all constraints are properly implemented, exported, and registered before committing changes, preventing the "implemented but not registered" issue that can disrupt schedule accuracy.

Key features of this skill include verification of constraint registration within the ConstraintManager, checking the hierarchy of soft constraint weights, and ensuring consistency across different manager methods such as create_default() and create_resilience_aware(). It validates that constraints in the prescriptive layer are correctly influencing schedule generation, while also providing clarity on how these changes interact with the descriptive layer represented by existing assignments. The skill integrates with existing testing workflows, complementing unit tests by confirming that constraints are not only logically correct but also actively used by the scheduler.

This skill is primarily used by developers and engineers working on scheduling systems who add or modify constraints. It is valuable before committing changes to version control, particularly in environments where schedules are critical and must adhere to strict rules. Typical use cases include creating new constraints, updating existing ones, verifying proper registration after exports, and running pre-commit checks to prevent oversights that could compromise schedule generation. It is suitable for teams using Python-based scheduling frameworks and those who need robust validation processes for constraint management.