4b-ports-contract-repair

To fix missing gateway directories in a Python ports and gateways architecture, this Skill creates the required src/interface_adapters/gateways folder structure and ensures __init__.py exists for proper imports. It applies deterministic, mechanical repairs to enforce port-contract discipline.

You can repair Python port contracts automatically by running this Skill's workflow, which limits changes to mechanical, deterministic fixes with minimal risk. This makes it suitable for automated maintenance cycles and reduces manual edits during audits.

Yes, you can use static analysis to enforce port-contract discipline in Python projects. This Skill uses AST checks to validate class naming and import constraints, ensuring your layered architecture remains compliant after applying mechanical repairs.

The best way to update documentation after fixing port contracts in Python is to re-audit the repository and populate docs/todo.md with the resulting post-fix state. This Skill automatically updates documentation to reflect the current port-contract compliance.

The limitation of mechanical port contract repairs in Python is that they are restricted to deterministic, low-risk changes like creating missing gateway folders and fixing imports. Complex architectural refactoring beyond these mechanical fixes is not supported.