2강. 프로젝트 시작 전 정리: 폴더·이름·README의 최소 기준

?1. 이번 강의에서 해결할 문제

코드, 실험 파일과 빌드 결과가 한 폴더에 섞이고 며칠 뒤 실행 명령을 잊습니다. 작업 시작 전에 최소 구조와 README를 만듭니다.

✓2. 학습 목표

✓이 강의를 마치면

• 프로젝트 루트와 생성 폴더를 구분합니다.
• 검색 가능한 일관된 이름을 정합니다.
• 필요한 도구와 실행·테스트 방법을 README에 기록합니다.

◇3. 핵심 개념

좋은 최소 구조는 기술마다 달라도 다음 질문에 답합니다.

• 소스는 어디에 있는가?
• 실행 명령은 무엇인가?
• 생성 파일과 비밀 파일은 무엇인가?
• 가장 작은 정상 확인은 무엇인가?

한 거대한 GameManager나 utils 파일처럼 모든 책임을 한곳에 모으지 않고 변경 이유가 같은 파일끼리 묶습니다.

✎4. 단계별 실습

PowerShell · 실행 위치: D:\Dev

$projectRoot = 'D:\Dev\productivity-lab'
New-Item -ItemType Directory -Force $projectRoot
New-Item -ItemType Directory -Force "$projectRoot\src", "$projectRoot\tests", "$projectRoot\docs", "$projectRoot\scripts"
Set-Location -LiteralPath $projectRoot
Get-ChildItem

예상 결과: src, tests, docs, scripts 네 폴더가 보입니다. D:가 없다면 자신의 짧은 개발 루트를 사용합니다. 관리자 권한은 필요하지 않습니다.

Markdown · 파일 경로: README.md

README.md

# Productivity Lab

작은 점수 계산 기능으로 개발 워크플로를 연습합니다.

## 필요한 도구
- Node.js: 프로젝트가 지원하는 LTS 범위

## 실행
```powershell
node .\src\app.js
```

## 기본 확인
```powershell
node --test
```

→5. 도구와 설정이 동작하는 이유

프로젝트 루트가 실행 명령과 상대 경로의 기준이 됩니다. README에 복사 가능한 명령을 두면 기억이나 IDE 버튼 이름에 의존하지 않고 같은 결과를 재현할 수 있습니다.

!6. 자주 하는 실수와 해결법

!자주 하는 실수

• README에 “실행하세요”만 작성: 실행 위치와 정확한 명령, 예상 결과를 적습니다.
• 폴더를 기능 없이 지나치게 세분화: 실제 책임이 생길 때 나눕니다.
• 임시 파일을 src에 계속 저장: 실험, 로그와 생성 결과 위치를 분리합니다.
• 비밀 값을 README 예시에 포함: 변수 이름과 안전한 빈 자리만 제공합니다.

✎7. 직접 실습

✎직접 실습

본인의 실제 프로젝트 README 첫 화면에 목적, 필요한 도구 버전 범위, 실행 위치·명령과 가장 작은 테스트 방법을 추가하세요.

?8. 이해 점검 질문 3개

?이해 점검

1. 프로젝트 루트를 명확히 하면 어떤 상대 경로 문제가 줄어드나요?
2. README 실행 명령에 실행 위치가 필요한 이유는 무엇인가요?
3. 모든 코드를 한 폴더나 Manager에 모으면 어떤 탐색 문제가 생기나요?

■9. 핵심 요약

■핵심 요약

프로젝트 시작 시 루트, 작은 책임 폴더와 복사 가능한 README 명령을 정합니다. 이 최소 기준이 이후 Formatter, 테스트와 Task의 공통 실행 위치가 됩니다.