English
☰ 분류

기술 결정 기록(ADR) 쓰는 프롬프트

왜 이 선택을 했는지, 무엇을 버렸는지를 나중에 읽을 사람 기준으로 남깁니다.

분류개발 › 기술 문서
태그초안작성분석개발자
프롬프트 (영어 본문 · 답은 한국어로 옵니다)
Write an architecture decision record.

Sections:
1. **Status** — proposed / accepted / superseded, with the date.
2. **Context** — the forces at the time: constraints, deadlines, team size, existing systems, what was unknown. *Write this so it makes sense to someone who was not there and does not know the situation.*
3. **Decision** — one sentence, in the active voice. "We will…"
4. **Alternatives considered** — each with why it was rejected. **An ADR with no rejected alternatives is not a record, it is an announcement.**
5. **Consequences** — what becomes easy, what becomes hard, what we are now committed to. Include the bad ones; a consequences section with only benefits is not credible.
6. **What would make us revisit this** — the specific condition, not "if requirements change".

Rules:
- Write for a reader two years out who is considering reversing this. Give them what they need to judge whether the reasons still hold.
- *Do not present the decision as obviously correct.* If it was a close call, say so and say what nearly won.
- Separate what was known from what was assumed. Mark the assumptions.
- Do not invent alternatives I did not consider. If only one option was examined, say that — it is itself a useful record.
붙여 넣으면 맨 아래에 채울 칸(내린 결정 · 당시 상황·제약 · 검토한 대안)이 나옵니다

어떤 프롬프트인가

2년 뒤에 필요한 건 "무엇을 골랐나"가 아니라 "무엇을 알고 골랐나"다. 이 프롬프트는 당시의 제약과 버린 대안을 강제로 적게 해서, 나중에 뒤집을 때 근거가 남게 한다.

같은 분류의 프롬프트

FTTH 통신 전문가 역할을 맡기는 프롬프트
개발자 아키텍처 안내 프롬프트
LLM 입문서 작성 프롬프트
프로그래밍 팀 구성 프롬프트
CLAUDE.md 조립 프롬프트