팀 유형별

SW·AI 스타트업 연구노트: 커밋과 PR을 연구노트로 남기는 법

개발팀의 커밋과 PR을 연구노트로 쓰는 방법이에요. 지침 요건, 커밋 목록만으로 부족한 이유, 주간 정리 틀과 PR 템플릿, 커밋 날짜와 시점인증을 정리했어요.

3줄 요약

  • 지침은 형식을 자유롭게 두어요. 전자 기록인 커밋과 PR도 연구노트의 재료가 돼요.
  • 커밋 목록만으로는 목적과 결과가 잘 보이지 않아요. 한 주에 한 번 목표·한 일·결과·다음 계획을 짧게 묶어요.
  • 커밋 날짜는 git 옵션으로 정할 수 있는 값이에요. 제3자 시점인증을 함께 남기면 그 시각을 따로 보여 줄 수 있어요.

커밋과 PR도 연구노트가 될 수 있어요

지침은 연구노트를 이렇게 정의해요.

4. "연구노트"란 법 제35조제2항에 따른 연구노트로서 연구개발과제 수행을 통하여 얻은 정보, 데이터, 노하우 등을 체계적으로 기록한 자료를 말한다.

국가연구개발사업 연구노트 지침 제2조(새 창) · 과학기술정보통신부고시 제2021-102호 · 2026-09-28 확인

형식도 자유예요(제7조③, 서면·전자노트·음성·영상). 그래서 개발팀이라면 이미 쌓이는 커밋과 PR이 좋은 재료예요. 연구노트용으로 커밋을 따로 만들 필요는 없어요. 평소 작업 기록에 짧은 설명만 더하면 돼요.

커밋 목록만으로는 부족한 이유

커밋 메시지는 "무엇을 바꿨는지"를 보여 줘요. "왜 했고, 결과가 어땠는지"는 잘 보이지 않아요.

지침은 기록자에게 이렇게 요청해요.

⑥ 기록자는 연구노트를 작성할 때에 내용의 위조ㆍ변조 없이 객관적인 사실을 기록하고, 제3자가 연구개발 수행 과정과 결과를 재현하는데 활용할 수 있도록 노력하여야 한다.

국가연구개발사업 연구노트 지침 제8조⑥(새 창) · 과학기술정보통신부고시 제2021-102호 · 2026-09-28 확인

판결에서도 비슷한 기준이 나왔어요. 대전지방법원 2020구합100313 판결이에요(대전고등법원 2021누10932 항소기각). 법원은 당시 규정을 근거로 이렇게 봤어요. 연구노트에는 제3자가 재현할 수 있게 일시·목적·환경·절차·내용·결과·해석이 기록돼야 한다고 했어요. 회의자료나 PPT만으로는 그 정보를 확인하기 어렵다고 봤어요.

커밋에 목적과 결과 한두 줄을 붙이면 이 기준에 가까워져요.

한 주에 한 장으로 묶어요

한 주에 한 번, 계획서 항목 기준으로 짧게 묶어요. 아래는 예시예요.

[2-1 데이터 수집 파이프라인] 2026.10.12 ~ 10.16
목표: 수집 지연을 30초 이하로 줄이기
한 일: 큐 기반 수집기로 교체 (PR #142, #145)
결과: 평균 지연 41초 → 18초 (부하 테스트 3회)
문제: 재시도 중 중복 저장 1건
다음: 중복 제거 키 추가

PR 템플릿에 칸을 미리 두면 주간 정리가 거의 끝나 있어요.

<!-- .github/pull_request_template.md -->
### 계획서 항목
2-1

### 목적
왜 이 변경을 했나요?

### 결과
테스트·지표·스크린샷

### 확인 방법
다른 사람이 재현하려면?

AI 모델을 다루는 팀이라면 세 가지를 더 적어요.

  • 데이터: 어떤 데이터셋, 어떤 버전
  • 설정: 모델, 주요 하이퍼파라미터, 시드
  • 지표: 무엇으로 쟀고 값이 얼마였는지, 실험 관리 도구 링크

커밋 날짜와 시점인증

커밋 날짜는 보통 커밋한 컴퓨터의 시계로 찍혀요. Git 문서도 작성자 날짜와 커미터 날짜를 옵션이나 환경변수로 지정할 수 있다고 안내해요(git-commit 문서(새 창)). 그래서 커밋 날짜만으로는 그 시각을 따로 보여 주기 어려워요. 타임스탬프 기관의 타임스탬프는 다른 방식으로 시각을 남겨요.

A time-stamping service supports assertions of proof that a datum existed before a particular time.

(번역: 타임스탬프 서비스는 어떤 데이터가 특정 시각 이전에 존재했다는 증명을 뒷받침한다.)

RFC 3161 제1장(새 창) · 2026-09-28 확인

주간 연구노트에 그 주 커밋 해시 목록을 함께 넣고 시점인증을 받으세요. 그러면 그 커밋들이 시점인증 시각에 이미 있었다는 사실이 제3자 기록으로 남아요.

개발자가 아닌 팀원은

디자인·기획·사업화 담당에게 GitHub 기록은 필요 없어요.

  • 디자인: Figma 링크, 시안 캡처
  • 기획: Notion·Drive 문서 링크, 회의록
  • 현장 검증: 사진, 엑셀, 인터뷰 메모

각자 하던 일이 그대로 근거로 남아요.

연구대장에서는 12월 출시

GitHub를 읽기 전용으로 연결하면 그 주 커밋과 PR이 주간 초안의 재료가 돼요. 초안의 문장마다 어느 커밋에서 왔는지 표시돼요. 확정할 때는 초안에 쓰인 커밋의 해시·커밋 날짜·PR 병합 시각이 근거 목록으로 함께 시점인증돼요. 확인은 본인이 1탭으로 해요.

AI 초안이 지침 요건에 어떻게 맞는지는 AI로 정리한 연구노트 해설에 정리했어요. 요건 조문은 지침 제7조 해설에서 볼 수 있어요. 시점인증과 검증 방식은 보안·신뢰 센터에 있어요.

체크리스트

자주 묻는 질문

이 글을 읽은 분들이 물어요

지침은 형식을 자유롭게 두어서 전자 기록도 연구노트가 될 수 있어요. 다만 커밋 목록만으로는 목적·결과·해석이 잘 보이지 않아요. 한 주에 한 번 짧게 묶어 두면 평가 때 설명하기 편해요.

코드 전체를 붙일 필요는 없어요. 한 일의 요약과 PR 링크, 커밋 해시면 충분해요. 보안과제라면 기관의 보안 규정을 먼저 확인하세요.

커밋 날짜는 git 옵션이나 환경변수로 정할 수 있는 값이에요. 타임스탬프 기관의 RFC 3161 타임스탬프는 그 시각 이전에 데이터가 있었다는 것을 제3자가 확인해 줘요. 두 날짜가 함께 있으면 설명이 쉬워요.

출처 4개 · 원문 대조 2026.09.28
  1. 국가연구개발사업 연구노트 지침(과학기술정보통신부고시 제2021-102호, 2022.1.1 시행)(새 창)
  2. 대전지방법원 2021. 4. 7. 선고 2020구합100313 판결(케이스노트)(새 창)
  3. Git 공식 문서 git-commit(새 창)
  4. RFC 3161 Time-Stamp Protocol (TSP)(새 창)

협약 시즌 체크리스트를 보내 드려요

TIPS·디딤돌 협약과 연차보고 시기에 맞춰 챙길 것만 짧게 보내요.

12월 출시 · 30일 체험 · 카드 등록 없음 · 과제당 연 59만 원(부가세 별도) · 인원 무제한

읽는 것보다,한 번 써 보는 게 빨라요.

출시되는 날 한 번 알려 드려요. 이메일은 출시 알림을 보낸 날부터 1년 보관해요.

3분 진단부터

12월 출시 · 출시되는 날 알려 드려요과제당 연 59만 원(부가세 별도) · 인원 무제한

알림 받기

신뢰 장치 한눈에