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:

  1. Where does the main product flow begin and end?
  2. Where should a change for a named capability live?
  3. 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:

Installs
2
Repository
siesdart/skills
First Seen
Jul 30, 2026
improve-folder-architecture — siesdart/skills