1a-project-structure-gate

Audit Python project structure for layout and file organization issues.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/AgustinMadygraf/skills --skill 1a-project-structure-gate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: 1a-project-structure-gate
Source: https://github.com/AgustinMadygraf/skills/tree/main/1a-project-structure-gate
Command: npx skills add https://github.com/AgustinMadygraf/skills --skill 1a-project-structure-gate

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Auditing the mechanical structure of a Python project to detect layout and file organization issues, helping teams enforce conventions without altering code.

Core Features & Use Cases

  • Audit env, layout and Python file conventions across core directories.
  • Generate a structured report detailing missing directories, files, and policy violations.
  • Use case: verify a newly bootstrapped project or audit an existing repo to prepare for a repair pass.

Quick Start

Run the structure audit on your repository by executing the structure_gate.py script

Frequently Asked Questions about 1a-project-structure-gate

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

FAQPage Schema
How do I audit a Python project structure to enforce layout conventions?

To audit Python project structure, execute the structure_gate.py script. It evaluates your repository's layout, validating environment setup and Python file conventions across core directories to produce a governance-ready report detailing any policy violations.

What is the best way to check for missing directories and __init__.py files in a Python repo?

The best way to check for missing directories and __init__.py files is to run an automated structure audit. This skill enforces folder presence and __init__.py policy, producing a detailed report of missing files and layout issues without modifying your code.

Can I validate gitignore and gitkeep conventions in an existing legacy Python repository?

Yes, you can validate gitkeep and layout conventions in legacy repositories. This audit applies to both new and existing Python projects, enforcing folder presence and gitkeep usage to detect layout issues and prepare the codebase for a repair pass.

Does the Python project structure audit modify my source code during validation?

No, the Python project structure audit does not modify your source code. It reports findings on layout and file organization issues by enforcing folder presence and conventions, generating a governance-ready report without applying any changes to your files.

When do I need to run a project structure audit on my Python codebase?

You should run a project structure audit when verifying a newly bootstrapped project or preparing an existing repo for a repair pass. It validates environment layout and Python file conventions to ensure mechanical structure issues are detected early.