모든 커밋은 아래 형식을 따른다.
type(scope): 영어로 짧게 핵심 요약
한글로 "왜/무엇을" 설명했습니다.
- 실제 변경 1
- 실제 변경 2
- 실제 변경 3
규칙:
- subject는 영어로 짧게 쓴다. 동사로 시작한다(
add,return,clarify,pin). - 본문 첫 줄은 한글 한 문장으로 왜 / 무엇을 했는지 쓰고
했습니다.로 끝낸다. - 그 아래 실제 변경을 불릿 3개로 쓴다. 바뀐 파일 목록이 아니라 무엇이 달라졌는지를 쓴다.
- 수치·엔드포인트·플래그처럼 확인 가능한 값을 쓴다. 추정해서 쓰지 않는다.
- 작업 주체를 쓰지 않는다.
Co-Authored-By트레일러를 붙이지 않고, 어떤 도구가 작업했는지 본문에도 쓰지 않는다. - 자기가 하지 않은 작업을 커밋할 때는 근거를 확보하고 쓴다. 수치·동작은 직접 실행해 확인한다. 확인할 수 있으면 남이 만든 코드여도 구체적으로 쓸 수 있다.
왜는 diff에 남지 않으므로WORKLOG.md의 문제/해결에서 가져온다. 거기에도 없으면 추정하지 말고 물어본다.
예시:
fix(agent): load local .env so the LLM credential reaches the planner
`.env`에 넣은 키가 planner에 보이지 않던 문제를 고쳤습니다. uvicorn은 `--env-file` 없이 `.env`를 읽지 않고 pytest는 아예 읽지 않습니다.
- `_load_env_file_once()`로 저장소 루트 `.env`를 최초 1회만 로드
- 실제 환경변수가 항상 우선하도록 `override=False` 적용
- `python-dotenv==1.0.1` 추가하고 미설치 시에는 조용히 건너뛰도록 처리