skills.rest
AgustinMadygraf
AgustinMadygrafCOMMUNITY
Explore all skills by this author →
GitHub

3b-ports-contract-repair

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
One-click install
npx skills add https://github.com/AgustinMadygraf/skills --skill 3b-ports-contract-repair
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
AgustinMadygrafAgustinMadygraf

4a-ports-contract-audit

Audit naming, placement, and dependencies of ports and contracts in src directories and output a report and docs/todo.md.

Community
Intermediate
haJ1thaJ1t

agent-prompt-builder

Construct self-contained prompts for AI agents to execute multi-step tasks.

Community
Advanced
dd-xiaozhidd-xiaozhi
2

fitness-run

Execute structural fitness functions to validate layer boundaries and OpenAPI contracts.

Community
Advanced
AgustinMadygrafAgustinMadygraf

3a-ports-contract-audit

Audit Python port and contract classes for layer boundary compliance.

Community
Intermediate