improve-folder-architecture
Installation
SKILL.md
Improve Folder Architecture
Assess the folder tree as a navigational interface, not as a style contest. Help a cold-start developer answer:
- Where does the main product flow begin and end?
- Where should a change for a named capability live?
- What else is likely to change, and what should remain untouched?
Use the codebase-design vocabulary precisely: module, interface, depth, seam, adapter, leverage, and locality. Diagnose and propose candidates; implementation is a later phase.
Read HTML-REPORT.md before creating the report. It is the single source of truth for the scaffold, visual language, card structure, diagrams, and tone.
Use EVALUATION-LENSES.md when comparing structures or deciding whether a convention earns its place.
1. Establish scope and evidence
Identify the repository root and inspect the available evidence: