4차 D-2: 앞으로의 기록 규칙을 공통 규칙에 못박음

항목을 끝내면 상세는 history 날짜 파일, 진행상황은 상태만, changelog 는 한 줄.
진행 순서를 D → A → B → C 로 고쳤다. D 를 먼저 하라는 말이 D 묶음 안에만 있었다.
플랫폼 changelog 경로를 풀어 적었다. 같은 이름 파일이 둘이 되어 헷갈린다.
This commit is contained in:
김승준 2026-09-10 20:17:17 +09:00
parent b82e40a17c
commit 0994d514fb
4 changed files with 279 additions and 248 deletions

View File

@ -45,3 +45,24 @@ doc/
| 대기·진행 중인 것이 한 화면에 | 4차 열세 항목이 한 화면에 들어온다 | | 대기·진행 중인 것이 한 화면에 | 4차 열세 항목이 한 화면에 들어온다 |
| 끝난 차수 상세를 링크 한 번으로 | changelog 한 줄 → 날짜별 파일 | | 끝난 차수 상세를 링크 한 번으로 | changelog 한 줄 → 날짜별 파일 |
| 링크가 깨지지 않음 | 15개 전부 정상 (스크립트로 확인) | | 링크가 깨지지 않음 | 15개 전부 정상 (스크립트로 확인) |
---
## D-2. 앞으로의 기록 규칙을 정했다 — **완료** (2026-09-10)
**왜** - D-1 로 자리를 나눠 놓기만 하면 다시 한 파일로 쌓인다. 어디에 적을지를 규칙으로 못박아야 한다.
지시서 [작업지시/4차.md](../작업지시/4차.md) 의 공통 규칙을 고쳤다. 항목 하나가 끝나면 세 군데에 남긴다.
1. **상세**는 `doc/history/YYYY-MM-DD-주제.md` — 원인 · 판단 · 확인한 결과
2. `진행상황.md` 은 **상태만** — 여기에 상세를 적지 않는다
3. `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 를 진행하는 동안 이 규칙대로 쌓이는지로 본다. 지금부터 적용한다.

View File

@ -8,6 +8,7 @@
| 날짜 | 항목 | 커밋 | | 날짜 | 항목 | 커밋 |
|---|---|---| |---|---|---|
| 2026-09-10 | **4차 D-2** — 항목을 끝내면 상세·상태·한 줄을 각각 어디에 적을지 공통 규칙으로 못박음 | 아래 |
| 2026-09-10 | **4차 D-1** — 721줄짜리 진행상황을 `history/` 의 날짜별 파일로 나누고 지시서를 `작업지시/` 로 모음 | 아래 | | 2026-09-10 | **4차 D-1** — 721줄짜리 진행상황을 `history/` 의 날짜별 파일로 나누고 지시서를 `작업지시/` 로 모음 | 아래 |
| 2026-09-09 | **3차 A 묶음** — 폴더 고르기 다운 · 화면 이동 결함 3가지 · 저장소 최상위 열기 | `5e667af` `af27800` `93a507e` `b5bd06c` / 플랫폼 `595aa23` `f664c31` | | 2026-09-09 | **3차 A 묶음** — 폴더 고르기 다운 · 화면 이동 결함 3가지 · 저장소 최상위 열기 | `5e667af` `af27800` `93a507e` `b5bd06c` / 플랫폼 `595aa23` `f664c31` |
| 2026-09-09 | **3차 B 묶음** — 3-Way 가로·세로 막대 · 행 어긋남 · Take Mine | `179dffb` | | 2026-09-09 | **3차 B 묶음** — 3-Way 가로·세로 막대 · 행 어긋남 · Take Mine | `179dffb` |
@ -26,6 +27,7 @@
| 날짜 | 문서 | 내용 | | 날짜 | 문서 | 내용 |
|---|---|---| |---|---|---|
| 2026-09-10 | **4차 D-2** — 항목을 끝내면 상세·상태·한 줄을 각각 어디에 적을지 공통 규칙으로 못박음 | 아래 |
| 2026-09-10 | **4차 D-1** — 721줄짜리 진행상황을 `history/` 의 날짜별 파일로 나누고 지시서를 `작업지시/` 로 모음 | 아래 | | 2026-09-10 | **4차 D-1** — 721줄짜리 진행상황을 `history/` 의 날짜별 파일로 나누고 지시서를 `작업지시/` 로 모음 | 아래 |
| 2026-09-10 | [2026-09-10-4차.md](2026-09-10-4차.md) | 4차 지시서 진행 중 | | 2026-09-10 | [2026-09-10-4차.md](2026-09-10-4차.md) | 4차 지시서 진행 중 |
| 2026-09-09 | [2026-09-09-3차.md](2026-09-09-3차.md) | 3차 지시서 A~E 스물세 항목. 항목마다 원인과 판단을 적었다 | | 2026-09-09 | [2026-09-09-3차.md](2026-09-09-3차.md) | 3차 지시서 A~E 스물세 항목. 항목마다 원인과 판단을 적었다 |

View File

@ -9,15 +9,23 @@
## 공통 규칙 ## 공통 규칙
- **A → B → C 순서로 진행한다.** A 는 작업한 것이 사라지는 문제라 제일 먼저다. - **D → A → B → C 순서로 진행한다.**
D(변경 이력 폴더)는 기록하는 자리를 바꾸는 일이라 **먼저 해 두는 편이 낫다** - 자세한 까닭은 D 묶음에 적었다. - D(변경 이력 폴더)가 먼저다. 기록하는 자리를 바꾸는 일이라, 나중에 하면 A~C 의 기록을 옛 자리에 쌓았다가 다시 옮기게 된다.
C(화면 구성)는 서로 얽히지 않아 순서를 바꿔도 되지만, 기능이 자리를 잡은 뒤에 손대는 편이 손이 덜 간다. - 그 다음이 A 다. 작업한 것이 사라지는 문제이기 때문이다.
- C(화면 구성)는 서로 얽히지 않아 순서를 바꿔도 되지만, 기능이 자리를 잡은 뒤에 손대는 편이 손이 덜 간다.
- **항목 하나를 끝낼 때마다** 빌드하고 실제로 실행해 화면을 확인한 뒤 보고한다. 전부 끝내고 한 번에 보고하지 않는다. - **항목 하나를 끝낼 때마다** 빌드하고 실제로 실행해 화면을 확인한 뒤 보고한다. 전부 끝내고 한 번에 보고하지 않는다.
- 항목 하나가 끝나면 [../진행상황.md](../진행상황.md) 의 대기/진행/완료를 갱신하고 **로컬 커밋**한다. 커밋 메시지는 한국어 한 줄. - **항목 하나가 끝나면 기록을 세 군데에 남기고 로컬 커밋한다** (D-1 로 자리가 바뀌었다).
1. **상세**는 `doc/history/YYYY-MM-DD-주제.md` 에 적는다 — 무엇이 원인이었는지, 어떤 판단을 했는지, 확인한 결과.
2. [../진행상황.md](../진행상황.md) 은 **대기 → 완료로 상태만** 고친다. 여기에 상세를 적지 않는다.
3. [../history/changelog.md](../history/changelog.md) 에 한 줄을 더한다 — 날짜 · 무엇을 왜 · 커밋 해시.
- 커밋 메시지는 한국어 한 줄.
- **왜 나누나** — 진행상황이 721줄까지 불어나 "그때 무슨 판단을 했더라" 를 스크롤로 뒤져야 했다.
상세가 갈 자리가 따로 있으면 진행상황은 한 화면에 머문다.
- **푸쉬하지 않는다.** 원격 저장소가 생기기 전까지 `.git` 에만 쌓아 둔다. - **푸쉬하지 않는다.** 원격 저장소가 생기기 전까지 `.git` 에만 쌓아 둔다.
- 기존 검사 하네스 16벌(514건)은 계속 통과해야 한다. 로직을 건드리면 **테스트를 먼저 늘린다.** - 기존 검사 하네스 16벌(514건)은 계속 통과해야 한다. 로직을 건드리면 **테스트를 먼저 늘린다.**
- 빌드 경고 0 · 오류 0 을 유지한다. 앱이 실행 중이면 파일 잠금으로 빌드가 실패하므로 `UbisamBase.Shell` 을 먼저 종료한다. - 빌드 경고 0 · 오류 0 을 유지한다. 앱이 실행 중이면 파일 잠금으로 빌드가 실패하므로 `UbisamBase.Shell` 을 먼저 종료한다.
- 플랫폼을 고치면 **다른 소비 프로그램에 미치는 영향**을 함께 적고 `doc/history/changelog.md` 에 남긴다. - 플랫폼을 고치면 **다른 소비 프로그램에 미치는 영향**을 함께 적고 `UbisamPlatform/doc/history/changelog.md` 에 남긴다.
MergeHub 쪽 changelog 와 헷갈리지 않게 한다 — 둘은 기준이 다르다(D-1 참고).
- 아래 넷은 지금 코드에 **아예 없다**(2026-09-09 확인). 있는 것을 고치는 게 아니라 새로 만드는 일이다 - - 아래 넷은 지금 코드에 **아예 없다**(2026-09-09 확인). 있는 것을 고치는 게 아니라 새로 만드는 일이다 -
최근 목록 · 같은 줄 접기 · 다음 파일 이동 · 외부 편집기 호출. 최근 목록 · 같은 줄 접기 · 다음 파일 이동 · 외부 편집기 호출.

View File

@ -49,7 +49,7 @@
| 상태 | 항목 | | 상태 | 항목 |
|---|---| |---|---|
| **완료** | D-1 `doc/history/` 를 만들고 진행상황을 나눈다 | | **완료** | D-1 `doc/history/` 를 만들고 진행상황을 나눈다 |
| 대기 | D-2 앞으로의 기록 규칙을 정한다 | | **완료** | D-2 앞으로의 기록 규칙을 정한다 |
--- ---