3b-ports-contract-repair

Name: 3b-ports-contract-repair
Availability: InStock
Author: agustinmadygraf

Audit and repair port/contract usage in Python gateway and use_cases layers.

Updated Mar 22, 2026

Search Tags:#architecture #python #audit #gateways #ports-contract #use_cases

Ready to run

npx skills add https://github.com/AgustinMadygraf/skills --skill 3b-ports-contract-repair

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: 3b-ports-contract-repair
Source: https://github.com/AgustinMadygraf/skills/tree/main/3b-ports-contract-repair
Command: npx skills add https://github.com/AgustinMadygraf/skills --skill 3b-ports-contract-repair

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Automates the repair of port/contract usage within Python projects to align with layer boundaries and project architecture.

Core Features & Use Cases

Audits gateway and use_cases layers to identify contract naming issues and missing gateway contracts.
Applies mechanical fixes to create missing package structure and initialize gateway modules.
Generates a TODO report to guide manual follow-ups and governance migration.

Quick Start

Run the script to audit and repair port contracts in your repository.

Frequently Asked Questions about 3b-ports-contract-repair

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I repair port contracts in a Python project architecture?▼

Repair port contracts by running an audit script that scans the gateways and use_cases layers in your Python repository to identify naming issues and applies mechanical fixes to scaffold missing package structure.

What are port contracts in Python architecture and when do they need repairing?▼

Port contracts define boundaries between gateways and use_cases layers. They need repairing when contract naming issues or missing gateway modules disrupt the structural alignment of your repository layout under src and docs.

Can I automatically scaffold missing gateway modules in my Python repository?▼

Yes, you can automatically scaffold missing gateway modules by applying mechanical fixes that create missing package structure and initialize gateway modules within your Python repository layout.

Does the port contract audit work with my existing src and docs layout?▼

Yes, the port contract audit operates directly on a repository layout located under src and docs, scanning the gateways and use_cases layers to enforce contract naming and detect missing contracts.

What is the best way to generate a TODO report for architecture governance migration?▼

Generate a TODO report for architecture governance migration by running the script's todo-generation capabilities, which scan port contract usage and output manual follow-up tasks to guide structural alignment.

Why does my port contract audit report missing gateway contracts in use_cases?▼

Your port contract audit reports missing gateway contracts in use_cases because the script detects structural misalignment between layers, enforcing contract naming rules and flagging missing gateway modules for repair.