A forma de um projeto

Abra um projeto típico e a lista de pastas pode parecer um monte de ruído. Não é — a maioria dos projetos segue um padrão reconhecível. Aqui está um app web simplificado:

my-app/
├── package.json          # dependencies + run commands (above)
├── package-lock.json     # the lockfile — exact versions
├── .env                  # local secrets/config — NOT shared
├── .gitignore            # files Git should ignore (like .env)
├── README.md             # what this project is, how to run it
├── public/               # static files served as-is (images, icons)
└── src/                  # your actual code lives here
    ├── components/        # reusable frontend pieces (a button, a card)
    ├── pages/ (or app/)   # the screens/routes users navigate to
    ├── lib/               # shared helpers and backend logic
    └── styles/            # CSS

Você não precisa decorar isso — só precisa reconhecer, para que quando a IA disser "vou adicionar isso em src/lib," você saiba mais ou menos onde fica isso e por quê. Algumas convenções fundamentais:

• src/ guarda o código que você escreve. A bagunça no nível superior é, na maior parte, configuração.
• Arquivos de configuração na raiz (o package.json, os dotfiles) configuram as ferramentas, não o comportamento do seu app.
• .gitignore lista os arquivos que não devem ser salvos no controle de versão — seu .env pertence aqui, o que é exatamente como os segredos ficam fora de um repositório compartilhado.