로그 운영 규칙¶
log.md는 저장소의 append-only 운영 기록입니다. 새 항목은 항상 파일의 아래쪽에 추가하고, 과거 항목은 삭제하거나 재배열하지 않습니다.
항목 형식¶
각 항목은 아래 헤더 형식을 따릅니다.
## [YYYY-MM-DD] scope | short title
YYYY-MM-DD: 작업 날짜scope:setup,docs,ingest,wiki,tooling같은 짧은 범위short title: 변경 내용을 한 줄로 설명하는 제목
필수 줄¶
각 항목은 아래 세 줄을 모두 포함해야 합니다.
- 범위:무엇을 추가, 수정, 정리했는지- 파일:주요 변경 파일 목록- 비고:배경, 제약, 후속 작업, 판단 이유
필요하면 추가 bullet을 붙일 수 있지만, 세 줄은 항상 유지합니다.
운영 원칙¶
- 새 문서를 추가하거나 구조 규칙을 바꿨다면 같은 변경 단위에서
log.md도 갱신합니다. - 제목은 검색하기 쉽게 짧은 영어 scope와 짧은 설명을 유지합니다.
python3 scripts/verify_wiki.py는log.md의 헤더 형식과 필수 줄 존재 여부를 검사합니다.