# PROJECT_CONTEXT.md

## 프로젝트 개요

| 항목 | 값 |
|---|---|
| 프로젝트명 | 프로젝트 생성기 |
| 버전 | 0.1.0-initial |
| 작성일 | 2026-07-02 |
| 상태 | 초기 설계 단계 |

## 목표

사용자가 프로젝트 번호와 프로젝트 이름을 입력하면 D:\AI-WORKS 안에 표준 프로젝트 구조를 자동으로 생성하는 Python CLI 도구를 구축한다.

## 표준 프로젝트 구조

```
{PROJECT_NUMBER}-{PROJECT_NAME}/
├── source/       # 원본 파일 입력 디렉터리
├── output/       # 정리된 파일 출력 디렉터리
├── backup/       # 변경 전 파일 백업 디렉터리
├── logs/         # 실행 로그 디렉터리
├── src/          # 소스 코드 디렉터리
├── config.json   # 프로젝트 설정
├── PROJECT_CONTEXT.md
├── RULES.md
├── STATE.json
├── TODO.md
├── CHANGELOG.md
├── README.md
└── run.bat       # 실행 스크립트
```

## 핵심 요구사항

1. 입력: 프로젝트 번호 (숫자), 프로젝트 이름 (한글/영문)
2. 처리: 입력 검증, 디렉터리 생성, 기본 파일 생성
3. 출력: 표준 프로젝트 구조 완성
4. 안전장치: 기존 디렉터리/파일이 있으면 덮어쓰지 않음
5. 로깅: 모든 생성 작업 내역을 로그에 기록

## 템플릿 폴더 구조

```
templates/
├── default/           # 기본 템플릿
│   ├── source/        # 빈 디렉터리
│   ├── output/        # 빈 디렉터리
│   ├── backup/        # 빈 디렉터리
│   ├── logs/          # 빈 디렉터리
│   ├── src/           # 빈 디렉터리
│   ├── config.json.template
│   ├── PROJECT_CONTEXT.md.template
│   ├── RULES.md.template
│   ├── STATE.json.template
│   ├── TODO.md.template
│   ├── CHANGELOG.md.template
│   ├── README.md.template
│   └── run.bat.template
```

## 아키텍처 방향

- 언어: Python 3.10+ (표준 라이브러리만 사용)
- 실행 모드: CLI (터미널 입력)
- 입력 형식: 프로젝트 번호(숫자), 프로젝트 이름(한글/영문)
- 출력 형식: D:\AI-WORKS\{PROJECT_NUMBER}-{PROJECT_NAME}/ 디렉터리
- 템플릿: D:\AI-WORKS\00-프로젝트생성기\templates/default/ 사용

## 의사결정 로그

| 날짜 | 결정 내용 | 근거 |
|---|---|---|
| 2026-07-02 | 템플릿 폴더 도입 | D:\AI-WORKS\00-프로젝트생성기\templates 에서만 템플릿 관리 |
| 2026-07-02 | Python 표준 라이브러리만 사용 | 외부 의존성 최소화 |
| 2026-07-02 | 기존 파일/디렉터리는 절대 덮어쓰지 않음 | 원본 보존 원칙 준수 |

## 다음 단계

1. `TODO.md`의 작업을 순차적으로 진행
2. `STATE.json`의 `next_step`부터 시작
3. 각 단계 완료 후 `STATE.json`과 `CHANGELOG.md` 갱신