# 작업 규칙 ## 언어 - 코드와 변수명은 영어. 응답, 문서, 코드 주석은 한국어 존댓말. 일본어·중국어 금지. - 쉬운 문장으로 설명. 나는 교각과 코딩을 배우는 중임. ## 문서 - 설계 규칙(피복, 철근 형상, R값, 레이어 이름 등)은 docs/ 폴더 md 파일에 정리. - 코드와 문서가 충돌하면 먼저 알려줄 것. - 작업이 끝나면 docs/ 와 README 업데이트 여부를 물어볼 것. ## 개발 방식 - 기능 추가 전에 테스트를 먼저 만들 것. 계산(좌표, 길이, 간격, 철근 수량)은 Rhino 없이 테스트 가능하게 분리. - 버그는 재현 테스트가 실패하는 것을 먼저 확인한 뒤 수정. - 같은 방법으로 2번 실패하면 다른 가설을 세워 시도. - 철근 코드는 일회성으로 실행하지 말고 scripts/ 폴더에 .py 파일로 저장하고 재사용. ## Git - 브랜치를 임의로 만들지 말 것. 현재 브랜치에 완료된 작업만 커밋. - 커밋 메시지에 docs/tasks.md 의 작업 번호를 넣을 것. - 할 일은 docs/tasks.md 에 번호, 내용, 예상 시간, 상태로 기록. ## 경로 안내 - 작업에서 쓰는 모든 경로는 docs/paths.md 에 기록하고, 새 경로가 생기면 바로 추가할 것. - 파일을 만들거나 수정하거나 읽을 때마다 응답 끝에 "이번에 쓴 경로"를 전체 경로로 알려줄 것. 사용자가 경로를 자주 헷갈려 함. ## 저장 공간 - C 드라이브 Python(약 156MB)은 그대로 둠. 용량이 큰 패키지(numpy, 3D 라이브러리 등)가 필요하면 설치 전에 알리고, D 드라이브(`D:\★Pier 자료\pier_v1\Pier_T_rebar\Code\pier-program\.venv`)에 가상환경으로 설치할 것. - 용량이 큰 파일(렌더링, 백업, DXF, Rhino 파일)은 항상 D 드라이브에 저장. ## 폴더 구조 - `docs/` 설계 규칙과 할 일 (`design_rules.md`, `tasks.md`) - `scripts/` 재사용 철근 코드. 계산 모듈(Rhino 없이 실행)과 Rhino 실행 스크립트를 분리 - `tests/` 계산 모듈 테스트 ## 참고 (기존 프로젝트) - 기존 코드와 방법: `D:\★Pier 자료\pier_v1\Pier_T_rebar\Code\rebar_pipeline\` (README 먼저 읽을 것) - 설계기준: KDS 24 14 21 (상세는 docs/design_rules.md)