ksj09406
0994d514fb
항목을 끝내면 상세는 history 날짜 파일, 진행상황은 상태만, changelog 는 한 줄. 진행 순서를 D → A → B → C 로 고쳤다. D 를 먼저 하라는 말이 D 묶음 안에만 있었다. 플랫폼 changelog 경로를 풀어 적었다. 같은 이름 파일이 둘이 되어 헷갈린다.
3.5 KiB
3.5 KiB
4차 — 로컬 머지툴 사용성 (2026-09-10 ~)
지시서: 작업지시/4차.md
D-1. doc/history/ 를 만들고 진행상황을 나눴다 — 완료 (2026-09-10)
왜 - 진행상황.md 가 721줄이었고 한 파일에 다섯 가지가 섞여 있었다.
주차 목표 · 차수별 상태 표 · 항목별 상세 · 미룬 것 · 완료 기록.
"3차 D-3 에서 무슨 판단을 했더라" 를 찾으려면 스크롤로 뒤져야 했다.
이렇게 나눴다.
doc/
진행상황.md 73줄. 지금 대기·진행 중인 것만
작업지시/
3차.md · 4차.md · 머지툴보강.md · 사용성보강.md
history/
changelog.md 한 줄 요약 + 날짜별 문서 목록
2026-09-08-2주차.md 90줄
2026-09-09-3차.md 565줄
2026-09-10-4차.md 이 파일
옮기기만 하고 내용은 고치지 않았다. 지시서가 그렇게 시켰다 - 다시 쓰면 그때 무슨 판단을 했는지가 흐려진다. 옮긴 자리에 날짜와 제목만 얹었다.
지시서를 doc/작업지시/ 로 옮긴 것은 git mv 로 했다. 새로 쓰고 지우면 이력이 끊긴다.
git log --follow 로 옛 이력을 그대로 따라갈 수 있다.
링크는 열다섯 개가 전부 살아 있다. 옮기면서 다섯 군데를 고쳤다.
doc/작업지시-3차.md → 작업지시/3차.md, 지시서 안의 doc/진행상황.md → ../진행상황.md,
작업지시-머지툴보강.md → 머지툴보강.md. 문서 전체를 훑어 남은 옛 경로가 없는 것을 확인했다.
곁들여 하나 - 미룬 것 목록에 최근 파일 목록 이 남아 있었다. 4차 B-1 로 올라온 항목이라
두 자리에 다르게 적혀 있었다. 미룬 것 쪽에서 뺐다.
판정 기준 확인
| 기준 | 결과 |
|---|---|
| 진행상황.md 200줄 아래 | 721 → 73줄 |
| 대기·진행 중인 것이 한 화면에 | 4차 열세 항목이 한 화면에 들어온다 |
| 끝난 차수 상세를 링크 한 번으로 | changelog 한 줄 → 날짜별 파일 |
| 링크가 깨지지 않음 | 15개 전부 정상 (스크립트로 확인) |
D-2. 앞으로의 기록 규칙을 정했다 — 완료 (2026-09-10)
왜 - D-1 로 자리를 나눠 놓기만 하면 다시 한 파일로 쌓인다. 어디에 적을지를 규칙으로 못박아야 한다.
지시서 작업지시/4차.md 의 공통 규칙을 고쳤다. 항목 하나가 끝나면 세 군데에 남긴다.
- 상세는
doc/history/YYYY-MM-DD-주제.md— 원인 · 판단 · 확인한 결과 진행상황.md은 상태만 — 여기에 상세를 적지 않는다history/changelog.md에 한 줄 — 날짜 · 무엇을 왜 · 커밋
곁들여 둘
- 진행 순서를
A → B → C에서D → A → B → C로 고쳤다. D 를 먼저 하라는 말이 D 묶음 안에만 있어서, 공통 규칙만 읽으면 A 부터 시작하게 되어 있었다. 규칙과 본문이 어긋나 있었다. - 플랫폼 changelog 경로를
UbisamPlatform/doc/history/changelog.md로 풀어 적었다. MergeHub 에도 같은 이름의 파일이 생겨서 그냥doc/history/changelog.md라고 쓰면 어느 쪽인지 알 수 없다. 두 파일은 기준이 다르다 - 플랫폼은 "다른 소비 프로그램에 미치는 영향", MergeHub 는 "무엇을 왜".
판정 기준은 4차 A~C 를 진행하는 동안 이 규칙대로 쌓이는지로 본다. 지금부터 적용한다.