프로젝트 결정 기록: 결과뿐 아니라 선택한 이유도 남기려면
웹사이트와 AI 프로젝트의 중요한 결정에 맥락, 대안, 이유, 결과와 변경 조건을 남기는 간결한 기록 방식을 살펴봅니다.
본문 언어: 한국어

목차
“왜 이렇게 만들었나요?” 팀에 새로 온 사람이 묻는다. 잠시 침묵이 흐른 뒤 누군가 답한다. “아마 이유가 있었겠죠.” 의사결정 기록은 그 이유와 검토한 대안, 선택 당시의 조건을 보존한다. 프로젝트 전체를 속기할 필요 없이 중요한 결정마다 짧은 카드 하나면 된다. 다음 변경 때 팀은 시간이 지나 회사의 자연법칙처럼 굳어진 관습만 물려받는 대신 맥락을 되찾을 수 있다.
사소한 행동까지 모두 기록할 필요는 없다. 변경 비용과 책임, 접근 권한, 후속 작업에 영향을 주는 결정을 고르자. Aeneia에서는 이 기록 방식으로 디자인, AI 검토, 출처를 다루는 작업을 연결한다. 사람과 에이전트 모두 어떤 결정이 유효하고 누가 바꿀 수 있는지 알아야 한다.
어떤 결정을 따로 기록해야 할까?
논의에서 반복해서 등장하는 주제부터 시작하자. 발행 방식과 연동 범위, 승인 절차, 데이터 출처가 그 예다. 새로 온 사람에게 왜 이런 방식인지 구두로 설명해야 한다면 그 맥락을 남겨둘 만하다.
웹사이트라면 하나의 도메인과 안정적인 주소를 선택한 이유일 수 있다. AI라면 특정 폴더에 대한 접근을 제한한 결정일 수 있다. 시장 조사라면 특정 범주를 어떻게 정의할지에 대한 결정일 수 있다. 몇 쪽을 차지하지 않더라도 각각 후속 작업에 영향을 준다.
기록부를 모든 회의의 일지로 만들지는 말자. 회의록은 출처가 될 수 있지만 실제로 무엇이 승인됐는지를 분명히 적어야 한다. 제안과 현재 유효한 선택의 경계를 정하자.
결정 카드 하나에는 무엇이 들어갈까?
식별자와 제목, 상태를 준비한다. 이어서 문제와 중요한 제약, 검토한 대안을 설명하자. 선택한 방향과 이유, 그 결과도 적는다. 승인자와 날짜, 사안을 이해하는 데 필요한 출처를 덧붙인다.
기술 프로젝트에서는 ADR, 즉 아키텍처 결정 기록이 비슷한 역할을 한다. AWS는 이 과정을 맥락과 결정, 결과, 상태 이력으로 설명한다. 아래 양식은 이 방식을 프로젝트의 다른 중요한 결정에도 확장한 것이다.
- 문제: 지금 무엇을 결정해야 하며 그 이유는 무엇인가?
- 조건: 목표와 제약, 출처는 무엇인가?
- 대안: 실제로 어떤 방법들을 검토했는가?
- 결정: 구체적으로 무엇을 골랐고 왜 골랐는가?
- 결과: 그 선택으로 어떤 작업과 비용, 제약이 생기는가?
- 변경: 무엇이 재평가의 근거가 될 수 있는가?
- 책임: 누가 승인했고 누가 다음 단계를 수행하는가?
기각한 대안과 그 이유도 남길 수 있게 하자. 그러면 다음 사람이 같은 분석을 처음부터 반복하지 않아도 된다.
실제로는 어떻게 기록할까?
가상의 회사 블로그를 연습 예제로 살펴보자. 팀은 정기적으로 글을 발행하고 싶지만 아직 편집자 계정과 복잡한 관리 화면은 필요하지 않다. 파일 기반 방식과 외부 관리 화면을 검토한다. 요구 범위를 확인한 뒤 수정과 배포 방법을 정해 파일 방식을 선택한다.
카드에는 누가 발행하고 HTML이 어떻게 만들어지며 무엇을 확인해야 하는지 적는다. 저장소 접근 권한이 없는 여러 편집자가 일해야 할 필요가 생기면 다시 평가할 수 있다. 이는 방법을 설명하는 예일 뿐 한 방식이 모든 회사에 맞는다는 주장은 아니다.
AI 시험 도입을 결정한다면 기록은 달라진다. 허용된 데이터와 결과를 검수할 사람, 계속 사용할지 판단할 기준이 필요하다. 모든 결과를 다른 문서에 복사하기보다 시험 운영 카드 (폴란드어)로 연결하자.
생각이 바뀌었을 때 이력을 어떻게 남길까?
새 결정을 기록하고 이전 결정과 연결한다. 이전 것은 날짜와 후속 결정 링크를 붙여 대체됐다고 표시하자. 그러면 프로젝트의 특정 버전을 만들 당시 어떤 결정이 유효했는지 되짚을 수 있다. AI가 이런 관계를 추출한다면 지식 그래프의 관계 방향과 시점, 근거를 확인해 도구가 현재 결정과 대체된 결정의 관계를 거꾸로 만들지 않게 한다. 지식 그래프의 관계를 다룬 글도 (폴란드어) 참고할 수 있습니다.
새로운 지식을 처음부터 알고 있었던 것처럼 예전 선택 이유를 고쳐 쓰지 말자. 이력은 조건이 어떻게 바뀌었는지 이해하는 데 도움이 된다. 문장 오류는 별도의 정정 메모로 남겨 수정 이력을 보존할 수 있다. 다만 AWS의 ADR 절차에서는 승인되거나 기각된 기록을 불변으로 취급하며, 결정을 바꾸려면 새로운 ADR을 작성해 검토한다.
AWS의 ADR 관리 지침은 책임자와 이력, 함께 접근할 수 있는 장소를 강조한다. 실제로는 의사결정자에게 맞는 저장소나 문서 데이터베이스를 고르자. 작업하는 순간 올바른 버전을 찾을 수 있는 것이 가장 중요하다.
에이전트의 작업에 기록을 어떻게 활용할까?
현재 유효한 카드를 작업의 출처로 지정한다. 에이전트는 제안과 승인된 결정, 대체된 결정을 구분할 수 있어야 한다. 출처들이 서로 충돌한다면 차이를 기록하고 이를 해결할 사람을 정해야 한다.
카드를 찾았다는 사실을 어떤 작업이든 실행할 수 있는 권한으로 취급하지 말자. 행동 범위는 여전히 현재 과제와 부여된 접근 권한에 따라 정해진다. 에이전트 작업 원칙은 읽기와 결과 준비, 작업 승인 단계를 구분하는 데 도움이 된다. 책임 있는 AI 에이전트 작업을 다룬 글을 (폴란드어) 읽어 볼 수 있습니다.

누가 결정을 알아야 하고 실행을 확인해야 할까?
승인과 실행은 구분하자. 카드에 발행 방식의 선택이 적혀 있어도 구현 책임자와 결과 확인이 따로 필요하다. 실제 수행을 보여주는 과제나 코드 버전, 검수 기록의 링크를 추가한다.
그 변경이 누구의 작업에 영향을 미치는지도 정한다. 도메인이 달라지면 자료의 링크에 영향이 있고, 연동을 제한하면 팀의 작업 지침이 바뀔 수 있다. 관련자에게 알리는 일과 문서 갱신은 각각 별도 항목으로 둔다. 그래야 기록부가 승인된 문장만 쌓는 곳이 아니라 실제 행동과 연결된다.
마음에 든 대안만 정당화하지 않으려면?
선택 전에 기준을 적는다. 발행 방식이라면 수정 담당자와 수정 빈도, 접근 권한 관리, 유지 비용이 될 수 있다. 모든 대안을 같은 질문으로 설명하자. 하나는 자세히 계산해 놓고 다른 대안은 “어렵다” 한마디로 비교하면 다음 사람이 평가 과정을 복원할 수 없다.
각 근거가 사실인지, 가정인지, 프로젝트가 부과한 제약인지 표시한다. 가상의 예를 보자. 팀이 편집자 한 명을 가정하지만 아직 대체 인력 계획은 없다. 이 숫자에 기반한 선택이라면 출처와 재확인 조건을 적어야 한다. 개발 비용과 나중에 변경하는 비용은 다르다.
웹사이트는 프리미엄 프로젝트 브리프 (폴란드어)에서 합의한 목표부터 시작하자. 하위 페이지 수와 구성을 정하는 문제라면 B2B 웹사이트 정보 구조가 도움이 된다. 기록부는 선택한 구성이 목표를 달성하는 이유를 설명해야지 화면 목록만 되어서는 안 된다. B2B 사이트 정보 구조를 설명하는 글도 (폴란드어) 참고하세요.
조건부 결정과 제한된 실험은 어떻게 적을까?
연습 삼아 회사가 사용 승인된 자료가 있는 폴더에 AI를 연결하려 한다고 가정하자. 결정 범위는 작은 시험과 정해진 데이터, 자동 발송 없음으로 한정될 수 있다. “AI를 도입한다”라고만 적으면 이런 제약이 사라진다. 무엇이 승인됐으며 시험이 성공해도 아직 무엇을 시작할 권한은 없는지 정확히 적는다.
그 카드에는 검토 날짜와 책임자, 종료 조건을 추가한다. 시험이 진행되지 않았다면 그 결정으로 활성 접근 권한을 무기한 정당화해서는 안 된다. 연결의 기술 범위는 AI 데이터 흐름 기록 (폴란드어)에 적고 성공 기준은 시험 운영 카드에 남긴다. 링크로 연결하면 각 주제의 최신 설명을 하나씩 유지할 수 있다.
실험에는 출발 상태를 복원할 방법도 필요하다. 웹사이트 변경이라면 이전 발행 버전과 주소 목록이 될 수 있다. 연동이라면 역할과 활성 연결에 대한 설명이다. 누가 되돌리고 합의된 동작이 실제로 복원됐는지 어떻게 확인할지 정하자.
결정은 유효한데 실제 작업이 달라졌다면?
기록과 동작을 비교한다. 카드에는 수동 승인이라고 적혀 있는데 새 연동은 결과를 자동으로 발행한다. 구체적인 대응이 필요한 차이다. 새 동작이 허용됐는지, 누가 승인했는지 정하지 않은 채 문서의 단어만 바꿔서는 부족하다.
기록부에는 구현의 근거와 중요한 조건을 마지막으로 확인한 날짜를 남긴다. 시스템에서 확인한 설정, 통제된 시험 결과, 확인된 발행 주소가 근거가 될 수 있다. 근거가 없다면 “확인 필요” 상태로 둔다. 카드를 읽는 사람은 방향을 선택한 사실과 실제 실행을 구분할 수 있어야 한다.
한 단계가 끝날 때 기록부를 짧게 검토하려면?
이번에 인계할 결과와 관련된 결정을 고르고 네 가지를 확인한다. 여전히 유효한가? 구현이 기록과 일치하는가? 재평가 조건이 충족됐는가? 이전 결정을 대체한 것을 쉽게 찾을 수 있는가? 과거의 모든 메모를 열 필요는 없다. 현재 작업과 책임이 의존하는 결정이 중요하다.
사이트 주소를 바꾼다면 카드를 주소를 유지하는 사이트 이전 계획 (폴란드어)과 연결하자. 변경 결정과 예전 링크를 확인한 근거는 따로 기록한다. 이 구분이 있으면 나중에 선택 자체가 잘못됐는지, 실행에 문제가 있었는지, 가정이 오래된 것인지 판단하기 쉽다.
단계를 인계할 때는 출처 자체에 접근할 수 있는지도 확인한다. 이유가 닫힌 세션이나 퇴사한 협업자의 폴더에만 있다면 새 담당자는 결정을 복원할 수 없다. 필요한 문서를 합의된 장소에 보관하고 그 범위를 설명할 책임자를 지정하자.
선택이 아직 승인을 기다린다면 경영진을 위한 의사결정 메모 (폴란드어)를 준비한다. 결정 후에는 선택된 대안과 유효 조건을 기록부에 남긴다. 선택을 돕는 문서와 이미 내린 선택의 기록은 역할이 다르다.
문서를 지나치게 늘리지 않고 시작하려면?
현재 프로젝트의 중요한 결정 몇 개를 고른다. 같은 양식으로 적고 대화에 참여하지 않은 사람에게 읽어 달라고 하자. 선택과 이유, 변경 조건을 이해하는지 확인한다. 분량을 늘리기 위해 문서를 길게 쓰기보다 빠진 맥락을 보완한다.
선택 이유를 읽었다는 것만으로 혼자 작업을 수행할 수 있다는 뜻은 아니다. 한 사람에 대한 회사의 의존도는 실제 행동으로 확인하자. 다른 사람이 전문가의 기억에만 의존하지 않고도 맥락을 파악해 결정과 자료를 활용할 수 있을까? 한 사람에 대한 의존도를 다룬 글을 (폴란드어) 살펴볼 수 있습니다.
기록부를 지식 구조와 프로젝트 인계 자료 (폴란드어)에 연결한다. 출처와 도구, 책임을 정리하는 작업은 Audit에서 다룬다. 실제 후속 작업에 영향을 주는 결정부터 시작하자. 회사 지식 구조를 다룬 글도 (폴란드어) 도움이 됩니다.









