Folder Structure

Folder structure for frontend and backend module placement. Use when creating files, deciding where a module belongs, or reviewing misplaced responsibilities across views, components, services, routes, data, or gateway. Don't use for coding style inside a file (use code-standards), React patterns (use react), or test conventions (use tests).

pedronauck 9998a55 3 files · 2.9 KB Updated

File contents

Folder Structure

Place each module by its primary responsibility. Shape rules inside a file live in code-standards; React composition rules live in react.

Reference — general placement

  • Keep frontend code under frontend/src and backend code under backend/src.
  • Name files and folders in English.
  • Put each module in the folder that matches its primary responsibility.
  • Extract shared logic into an inward-facing module rather than duplicating across layers.
  • Prefer a named responsibility folder over catch-alls like utils, helpers, or misc.

Branches

Match the task, then read the listed file in full before placing or moving code:

When… Read in full
Creating or reviewing anything under frontend/src references/frontend.md
Creating or reviewing anything under backend/src references/backend.md

Reference — review gate

Before finishing, confirm every general placement rule holds and the branch file for each touched tree was applied in full.

pedronauck/imersao-aovivo/tree/main/.agents/skills/folder-structure commit 9998a55534

Frequently asked questions

npx skillmds@latest add pedronauck/folder-structure