결정 원장 — decisions.md

같은 프로젝트를 여러 날에 걸쳐 진행하면, 지난번에 정한 값이 어디에도 안 남아 있는 일이 생깁니다. 대화는 끝나면 사라지고, 기획서에는 정하기 전의 값이 그대로 적혀 있습니다.

무엇을 적나요

한 항목에 네 칸이면 충분합니다.

칸	적을 것
날짜	정한 날
결정	무엇으로 정했는지
버린 안	같이 검토했다가 안 쓰기로 한 것
적용 범위	어느 폴더·어느 화면에 걸리는지

버린 안을 적어 두는 것이 특히 도움이 됩니다. 몇 주 뒤에 같은 안이 좋아 보여 다시 올라올 때, 왜 안 쓰기로 했는지가 그 자리에 있으면 다시 검토하지 않아도 됩니다.

새 항목은 맨 위에

파일 끝에 붙이면 최신을 보려고 매번 끝까지 내려가야 합니다. 맨 위에 넣으면 파일을 여는 순간 최신이 보입니다.

기획서와 다를 때

기획서·제안서·초안은 그 시점의 스냅샷입니다. 그 뒤에 값이 바뀌어도 문서가 자동으로 고쳐지지 않으므로, 원장과 다르면 원장을 따릅니다.

밀려난 문서는 지우지 말고 머리에 한 줄 붙입니다.

> 폐기 2026-08-13: 색 기준은 decisions.md 최신 항목을 따릅니다.

지우지 않는 이유는 되짚기 위해서입니다. 왜 그때 그렇게 정했는지가 남아 있으면 다음 결정이 쉬워집니다.

요청할 때 같이 붙입니다

색을 고르거나 문구를 쓰거나 화면 구조를 만들기 전에, 원장을 같이 읽게 합니다. CLAUDE.md에 “시각·문구 작업 전 decisions.md 최신 항목을 먼저 읽는다”를 한 줄 넣어 두면 매번 말하지 않아도 됩니다.

확정은 내가 합니다

AI가 대화 중에 스스로 확정이라고 적지 않게 하세요. 원장에 들어가는 것은 내가 정한 것뿐입니다. 후보를 뽑아 달라고 하는 것과, 그 후보를 확정으로 올리는 것은 다른 단계입니다.

실행 순서

프로젝트 폴더에 `decisions.md`를 하나 만듭니다. 맨 위가 최신이 되도록 새 항목을 위에 넣습니다.
```
이 폴더의 결정 기록을 확인해 주세요. 기존 기록이 있으면 그 위치와 형식을 유지하고, 없으면 decisions.md를 만들어 주세요. 문서에서 확정된 것으로 보이는 내용을 날짜·결정·버린 안·적용 범위로 정리하되, 제가 확인하기 전에는 후보로 표시해 주세요. 기존 기록을 지우거나 후보를 확정으로 바꾸지 말고 파일 위치와 확인할 후보를 알려 주세요.
```
확인결정 기록의 위치와 후보 목록이 나오며, 기존 기록과 아직 확인하지 않은 후보가 구분됩니다.
값이나 방향을 확정할 때마다 그 자리에서 한 줄 넣습니다. 날짜, 무엇을 정했는지, 무엇을 버렸는지, 어디까지 적용되는지를 적습니다.
색·문구·구조를 만들기 전에 이 파일의 맨 위부터 읽습니다. 요청에 이 파일을 같이 붙입니다.
기획서나 초안이 원장과 다르면 원장을 따릅니다. 밀려난 문서는 지우지 말고 머리에 폐기 표시를 붙입니다.

직접 해보기

대괄호 안은 실제 값으로 바꿔서 붙여넣습니다.

내 상황에 맞춰

방금 우리가 정한 건 [한 줄로 설명]이야. 이걸 decisions.md 맨 위에 한 줄로 넣어 줘. 무엇을 버렸는지와 어디까지 적용되는지도 같이 적어.

한 단계 더

decisions.md와 지금 폴더의 다른 문서들을 대조해 줘. 원장의 결정과 다르게 적힌 곳이 있으면 파일과 줄을 알려 주고, 원장이 이기는지 문서가 더 최신인지 판단이 어려운 건 따로 표시해 줘.

최근에 정한 것 하나를 골라 원장에 첫 줄로 넣어 보세요. 무엇을 버렸는지까지 적으면 나중에 같은 안이 다시 올라올 때 바로 걸러집니다.

헷갈리기 쉬운 것

나중에 몰아서 적으면 무엇을 버렸는지 기억이 안 나서 결정만 남고 이유가 사라집니다. 정한 자리에서 바로 넣습니다. 새 항목을 파일 끝에 붙이면 최신을 찾으려고 매번 끝까지 내려가야 하고, 같은 날 항목이 위아래로 흩어집니다. 그리고 AI가 스스로 확정이라고 적지 않게 합니다. 결정하는 사람은 나입니다.

용어 풀이

전체 용어집 →

결정 원장: 확정한 값과 방향을 한 줄씩 날짜와 함께 쌓아 두는 파일입니다. 무엇이 최신인지 대조하는 자리입니다.
스냅샷: 그 시점의 상태를 찍어 둔 문서입니다. 기획서·제안서가 여기 해당하고, 나중에 결정이 바뀌어도 자동으로 고쳐지지 않습니다.
폐기 표시: 더 최신 결정에 밀려난 문서 머리에 붙이는 한 줄입니다. 지우지 않고 남겨 두어 왜 바뀌었는지 되짚을 수 있게 합니다.