File and folder structure follows framework conventions
Why it matters
Misorganized directory structure forces every contributor to build a mental map from scratch. When components live in the root, API logic lives inside component files, and the src/ wrapper is applied inconsistently, adding a feature means hunting across the entire tree. ISO 25010 maintainability.analysability degrades directly: the time to locate where a change belongs rises sharply. New contributors — or future you — lose hours before writing a single line. Framework conventions exist precisely to make projects predictable.
Severity rationale
Critical because a fractured directory structure makes every subsequent change slower and riskier, compounding across the entire development lifecycle.
Remediation
Adopt your framework's conventional layout and migrate incrementally — one directory at a time, verifying the build passes after each move. For Next.js App Router:
src/
app/ ← routes and page components
components/ ← shared UI components
lib/ ← utilities, helpers, third-party wrappers
hooks/ ← custom React hooks
types/ ← TypeScript type definitions
Use your IDE's "Move file" refactor to update imports automatically. Commit each directory move separately so the diff stays reviewable.
DetectionPro
The detection method for this pattern is part of AuditBuffet Pro.
The full method (what to look for, pass and fail conditions, and how results get reported) ships inside the Code Maintainability Audit. The pattern definition, severity rationale, and remediation remain openly licensed under CC-BY-4.0.
External references
- iso-25010:2011 · maintainability.analysability — Analysability
- iso-25010:2011 · maintainability.modularity — Modularity
Taxons
History
- 2026-04-18·v1.0.0·Initial import from code-maintainability·automated