ResearchProject/FESurrogateModelTutorial/phases/0-project-foundation/step0.md

Step 0: python-project-skeleton

읽어야 할 파일

• /AGENTS.md
• /PROGRESS.md
• /WORKNOTES.md
• /docs/PRD.md
• /docs/ARCHITECTURE.md
• /docs/ADR.md

작업

Python tutorial project의 최소 기반을 만든다.

• /pyproject.toml 생성: Python >=3.12,<3.15, setuptools src layout, pytest pythonpath = ["src"], ruff target py312.
• runtime dependencies: numpy, scipy, pandas, scikit-learn, matplotlib, joblib.
• dev dependencies: pytest, ruff, jupyterlab, ipykernel, nbconvert.
• Python package directories: /src/femsurrogate/, /src/femsurrogate/fea/, /src/femsurrogate/data/, /src/femsurrogate/surrogates/, /src/femsurrogate/plotting/.
• artifact directories: /tests/, /data/reference/, /data/processed/, /reports/results/, /reports/predictions/, /reports/figures/, /notebooks/.
• 빈 artifact directory에는 .gitkeep을 둔다.
• Python cache, virtualenv, notebook checkpoint를 .gitignore에 추가한다.
• /PROGRESS.md에 phase 0 시작 상태를 기록한다.

Acceptance Criteria

uv sync
uv run python -c "import femsurrogate; print(femsurrogate.__name__)"
uv run ruff check .

검증 절차

AC 커맨드를 실행하고 성공하면 phases/0-project-foundation/index.json의 step 0을 completed로 갱신한다.

금지사항

• Beam solver, parser, dataset, surrogate 모델 구현을 이 step에서 만들지 마라.
• Notebook 내용을 만들지 마라.