한 일

TODO.md를 448줄에서 47줄로 줄였다. 하나의 파일에 할 일과 끝난 일이 다 섞여 있었다. 그래서 너무 길어졌다. 살아있는 백로그(버그·개선·기능)만 남기고, 끝난 일은 따로 뺐다. 거기에 아카이브 목록과 일을 시작하는 절차만 더했다. 그렇게 47줄로 가벼워졌다.

완료 이력을 5개 파일로 나눠 docs/todo/에 보관했다. 끝난 일들을 날짜와 단계별로 쪼갰다.

  • 초기 구축과 GCP 이전 (5/23)
  • 스키마 개편, 수집·분석, 모니터링 (5/23)
  • 보안, 자가 업데이트, 테스트·스테이징 (5/24)
  • 이슈 그래프, CI/CD 파이프라인 (5/29)
  • 설명 필드, 명령어 개선, 멀티룸 (6/3)

docs 폴더를 종류별로 정리했다. drawio 그림 6개를 docs/diagrams/로 옮겼다. git mv로 옮겨서 이름 추적이 100%로 잡혔다. 끝난 일 사이에 묻혀 있던 살아있는 항목 하나(운영 terraform state 이전)도 찾아내 백로그로 끌어올렸다.

이력을 옮겨도 그래프가 안 깨지게 손봤다. 이슈를 별자리·그래프로 보여주는 도구가 있다. 그게 TODO.md만 읽고 있었다. 완료 이력을 다른 파일로 옮겼으니, docs/todo/*.md까지 같이 읽도록 고쳤다. 실제로 돌려보니 노트 25개(끝난 것 14, 진행 중 7, 할 일 4)가 잘 잡혔다. 완료된 별들이 그대로 살아남았다.

obsidian-vault 폴더를 통째로 gitignore 했다. 이 폴더는 생성 도구가 만들어내는 산출물에 머신별 설정까지 섞여 있다. 굳이 커밋할 이유가 없었다. 추적되던 파일 5개를 git rm --cached로 빼고(로컬 파일은 그대로 뒀다), .gitignore도 잘게 나눠진 규칙을 폴더 통째로 무시하는 한 줄로 합쳤다.

문서 정리라 코드 변경은 없었다. PR 네 개(#49·#50, #53·#54)로 나눠 올려 dev를 거쳐 main까지 반영했다. docs/·*.md·tools/ 같은 문서·도구 파일만 바뀌어서 배포는 안 돌았다.

돌아보며

화려한 날은 아니었다. 새 기능도 없고, 고친 버그도 없다. 그냥 책상을 치우는 날에 가까웠다.

그런데 막상 하고 나니 마음이 가벼웠다. 448줄짜리 목록은 열 때마다 숨이 막혔다. 무엇이 살아있고 무엇이 끝났는지 한눈에 안 보였다. 47줄로 줄이고 나니, 다음에 할 일이 또렷하게 보인다.

작은 데서 살아있는 항목 하나를 건진 게 특히 좋았다. 끝난 일 더미 속에 운영 terraform state 이전이 숨어 있었다. 정리를 안 했으면 계속 묻혀 있었을 거다. 청소를 하다 보면 잃어버린 줄 알았던 물건이 튀어나오는 것과 같았다.

도구가 옛 경로만 보고 있던 것도 미리 잡아서 다행이었다. 이력을 옮기기만 하고 도구를 안 고쳤다면, 그래프에서 완료된 별들이 슥 사라졌을 거다. 옮기기 전에 “이걸 읽는 게 또 누가 있지"를 한 번 떠올린 게 도움이 됐다.