DongHyeonkaandClaude Opus 5
193da20d09
게시된 Reference 15편이 전부 규칙을 `### N. 제목` 으로 쓰고 적용 조건·예외·예시를 항목으로 쓴다. 내 15편은 규칙을 `**굵게**` 로, 나머지 셋을 문단으로 쓰고 있었다 — Studio 의 rules[]·applyWhen[]·exceptions[]·examples[] 는 배열이라 문단으로 두면 항목이 하나로 접힌다. 규칙 68개를 `### N. 제목` 으로 바꿨다 (편당 3~7개, 게시된 것은 4~10개) 적용 조건·예외·예시를 항목으로 갈랐다. 한 항목뿐이던 아홉 편은 조건을 나눠 적었다 주제 6 은 본문을 다시 썼다 — location = 이 정확히 일치하는 경로만 잡아 27개가 얼어붙은 구조, 여덟 곳이 우는 시점을 셋으로 가른 표, digest 를 다시 계산할 때 옛 값을 먼저 재현하는 이유. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
66 lines
2.9 KiB
Markdown
66 lines
2.9 KiB
Markdown
---
|
|
kind: REFERENCE
|
|
slug: write-down-what-would-undo-a-workaround
|
|
title: 우회를 남길 때는 되돌릴 조건을 함께 적는다
|
|
topic: addresses-frozen-at-publish-time
|
|
topicName: 주소가 만들어지고 굳어지는 곳
|
|
project: TechLog
|
|
status: 게시 전
|
|
verifiedOn: 2026-09-04
|
|
sourceRevision: tech-log@2026-09-02
|
|
source:
|
|
- final/document.md#§9.4
|
|
---
|
|
|
|
# 우회를 남길 때는 되돌릴 조건을 함께 적는다
|
|
|
|
그 화면이 줄 수 있는 것이 아직 비어 있어 링크를 다른 곳으로 돌린 적이 있다. 우회 자체는 틀리지 않았다 — 그때는 채울 내용이 없었다. 되돌릴 조건은 우회를 넣는 커밋에 적고, 그 조건이 충족되면 되돌린다.
|
|
|
|
## 관계
|
|
|
|
- **축 링크가 자기 자신을 가리켰고, 고친 뒤에는 백엔드를 먼저 배포했다**
|
|
같은 주제 링크를 다루며 이 기준이 나왔다.
|
|
- **홈의 비교 구역이 세 번 바뀌었다**
|
|
단계마다 무엇을 고치려 했는지 적어 둔 다른 예다.
|
|
- **새 라우트는 프론트엔드를 먼저 배포한다**
|
|
같은 사건에서 나온 짝이 되는 결정이다.
|
|
|
|
## 목적
|
|
|
|
임시 조치가 영구 구조로 굳는 것을 막는다. 되돌릴 조건이 적혀 있지 않으면 다음 사람이 그 우회를 설계로 읽는다.
|
|
|
|
## 규칙
|
|
|
|
### 1. 우회를 넣는 커밋에 되돌릴 조건을 적는다
|
|
|
|
무엇이 채워지면 되돌리는지 한 줄로 적는다. 그 조건이 충족됐을 때 실제로 되돌린다.
|
|
|
|
### 2. 우회할 때 무엇이 비어 있어서 우회하는지 함께 적는다
|
|
|
|
채울 것이 없어서 돌린 것과 구조상 그쪽이 맞아서 돌린 것은 다르다.
|
|
|
|
### 3. 되돌릴 생각이 없으면 우회가 아니라 결정으로 적는다
|
|
|
|
그때는 조건이 아니라 근거와 감수한 비용을 적는다.
|
|
|
|
## 적용 조건
|
|
|
|
- 그 화면이 줄 수 있는 것이 아직 비어 있어 링크나 흐름을 다른 곳으로 돌릴 때
|
|
- 임시라고 말하면서 코드에 남기는 변경을 커밋할 때
|
|
- 왜 이 링크가 저기로 가는지 다음 사람이 물을 만한 변경을 넣을 때
|
|
|
|
## 예외
|
|
|
|
- 되돌릴 생각이 없는 영구 변경은 우회가 아니다. 조건 대신 근거를 적는다.
|
|
|
|
- 조건을 적을 수 없으면 그것은 우회가 아니라 아직 정하지 않은 것이다. 열린 질문으로 남긴다.
|
|
|
|
## 예시
|
|
|
|
- 주제 화면이 주제 셋을 하드코딩해 두고 있어 실제 주제는 무엇이든 404 였다. 그때 주제 페이지를 채우는 대신 링크를 탐색 필터로 돌렸다.
|
|
|
|
- 돌린 이유는 그 페이지만 줄 수 있는 것 — 설명, 범위, 선별한 대표 기록 — 이 전부 비어 있었고 Studio 에 주제 설명을 쓸 칸조차 없었기 때문이다.
|
|
|
|
- 우회를 남겨 두면 「왜 주제 링크가 탐색으로 가지?」라는 질문이 계속 따라온다.
|
|
|
|
- 그 조건을 커밋 메시지에 적었고, 주제 화면을 계약에 잇고 하드코딩을 없앤 뒤 링크를 곧장 주제 화면으로 되돌렸다. |