바이브코딩 실전 · 후속 개선 7편
새 속성은 입력 의무가 아니라 다시 찾을 질문을 나누는 장치다.
메모를 남길 때부터 정리를 끝내야 한다면 짧게 기록하는 편리함이 줄어든다. 생각이나 링크를 그록봇에 보내고 나중에 앱에서 찾아 읽는 흐름도 마찬가지다. 입력할 때 제목과 분류를 모두 고르지 않아도 된다는 점이 출발이다. 새 칸을 늘리는 목적은 그 편리함을 되돌리는 데 있지 않다. 이미 남긴 메모를 다른 기준으로 다시 찾되, AI가 채운 설명과 사용자가 직접 남긴 말을 구별하려는 데 있다.
유형·영역·용도는 무엇이 다를까?
‘유형’은 어떤 형태로 들어온 기록인지, ‘영역’은 어느 주제에 속하는지, ‘용도’는 어디에 쓸 수 있는지를 나눈다. 다음은 모두 가상 예시다. ‘텃밭 책 기획’에 짧은 발상을 남겼다면 유형은 ‘생각’, 영역은 ‘출판’, 용도는 ‘책소재’와 ‘참고자료’가 될 수 있다. 같은 출판 영역의 ‘홍보 카드뉴스’는 실행하거나 공유할 자료일 수 있다. 주제가 같다는 이유로 쓸 곳까지 같아지지는 않는다. 세 칸은 서로 대신하는 분류표가 아니라, 하나의 메모에 서로 다른 질문을 붙이는 장치다. 어느 하나만 보아도 기록의 성격 전체를 알았다고 여기지 않는 편이 좋다.
이번에 더하는 것은 유형·영역·용도에 연결 이유·검토필요·사용자 코멘트를 합친 여섯 칸이다. 모두 선택 사항이므로 빠짐없이 채워야 하는 입력 양식으로 읽지 않는다. 기존 분류를 없애고 새 칸에 다시 옮겨 적는 작업도 아니다. 기록을 남기는 쪽에서 필요한 값을 보태고, 뷰어는 그 값을 읽어 보여 주는 역할을 맡는다.
용도는 한 메모에 여러 개가 붙을 수 있다. 필터도 여러 용도를 고를 때 뜻을 분명히 해야 한다. 이번 뷰어의 방식은 OR다. ‘책소재’와 ‘공유’를 함께 고르면 둘 다 붙은 메모만 남는 것이 아니라, 둘 중 하나라도 붙은 메모가 나온다. 메모에 붙는 값의 복수 선택과 검색 조건의 결합 방식은 따로 확인할 항목이다.
빈칸은 정리가 덜 됐다는 뜻일까?
알맞은 영역을 고르기 어렵다면 빈 값으로 두는 것이 정상이다. 안내 문서는 맞는 영역이 없을 때 비워 두고 ‘검토필요’를 표시하도록 정한다. 빈칸을 없애려고 가장 비슷해 보이는 항목에 밀어 넣으면, 찾을 때는 깔끔해 보여도 기록의 뜻이 달라진다. 검토 표시는 나중에 판단할 곳을 드러내는 표지이지, 지금 입력을 끝내지 못했다는 벌점이 아니다. 반대로 표시가 없다고 AI의 분류가 검증된 사실이 되는 것도 아니다. 빈 영역과 검토필요를 각각 찾아볼 수 있어야, 값을 모르는 상태와 다시 살펴볼 상태를 구별하며 읽을 수 있다.
옵션은 앞으로 늘어날 수 있다. 지금 보이는 영역이나 유형만 화면에 고정해 두면, 기록 쪽에서 새 항목을 받아도 뷰어에서는 찾지 못할 수 있다. 따라서 현재 값에 맞춰 필터 선택지가 달라지도록 하고, 낯선 값이나 빈 값이 들어와도 목록을 읽는 흐름이 끊기지 않게 한다. 옵션의 증가는 입력 의무의 증가와 다르다.
이 변경을 구현하고 시험하는 일은 Aside가 맡는다. 1.5.0 작업 보고에는 실제 원본의 속성 형식과 값을 대조하고, 새 필터와 상세 표시를 확인한 범위가 적혀 있다. 여기서 확인한 것은 값이 제대로 전달되고 표시되는 동작이다. 각 메모의 영역과 용도가 내용상 옳은지까지 보증하는 시험은 아니다.
연결 이유가 있으면 관계도 확정될까?
관련 메모를 잇는 정보와 그 관계를 설명하는 문장은 별개다. 가령 ‘텃밭 책 기획’과 ‘홍보 카드뉴스’가 연결돼 있고, 이유에 ‘후속’이라고 적혀 있다면 다음 작업으로 이어진다는 설명을 읽을 수 있다. 하지만 AI가 붙인 관계 이름과 이유는 내용을 검토할 단서이지, 두 기록의 관계를 확정하는 증거는 아니다. 선이 있다는 사실, 어떤 관계라고 설명하는지, 그 설명에 동의할 수 있는지를 나누어 본다. 관계의 양쪽에 설명이 있다면 각각 살펴볼 수 있지만, 양쪽에 적혀 있다는 이유만으로 설명의 정확도가 두 배가 되지는 않는다.
더 조심할 곳은 제목으로 적힌 연결 이유다. 관계 정보가 메모를 가리키더라도, 이유 문장 속 대상 제목은 나중에 바뀌거나 다른 메모와 겹칠 수 있다. 제목이 하나와 명확히 맞을 때만 이유를 붙이고, 중복되거나 변경돼 짝을 정할 수 없으면 억지로 연결하지 않는다. 관련 메모의 연결은 남겨 두되 그 선의 이유는 비워 둘 수 있다. 짝을 못 찾은 설명과 형식이 다른 줄도 버리지 않고 원문 그대로 보존한다. 해석한 값과 원문인 raw를 함께 남기면, 그럴듯한 오연결로 덮는 대신 무엇을 해석하지 못했는지 다시 살필 수 있다.
사용자 코멘트는 왜 따로 읽을까?
사용자 코멘트는 메모와 함께 보낸 말을 그대로 남기는 칸이다. AI가 만든 요약이나 용도 옆에 보이더라도 출처가 다르다. 코멘트까지 매끈하게 고쳐 쓰면, 나중에는 사용자가 남긴 의도와 AI의 해석을 나누기 어려워진다. 비어 있으면 내용을 만들어 채우지 않고, 값이 있으면 원문을 인용해 읽는다.
화면에 넣을 때도 코멘트는 텍스트다. 태그처럼 생긴 문자가 들어 있어도 화면을 꾸미는 명령으로 해석하지 않는다. Aside의 작업 보고에 따르면 원본 코멘트는 당시 모두 빈 값이어서, 내용이 있는 코멘트의 표시와 HTML 비해석 동작은 별도 가상 자료로 시험한다. 실제 기록에서 대조한 범위와 가상 예시로 시험한 범위를 구분해야 한다. 예쁘게 보이는 시연 하나로 모든 원본 상태를 확인했다고 말할 수는 없다.
무엇을 요청하고 어떻게 검수할까?
비슷한 개선을 맡긴다면 다음처럼 요청할 수 있다.
짧게 남기는 입력 흐름은 유지하고, 유형·영역·용도의 역할을 나눠 보여 줘.
여섯 새 칸은 선택 사항으로 두고, 빈 영역도 정상으로 찾아볼 수 있게 해 줘.
옵션은 늘어날 수 있게 처리하고, 용도 복수 필터는 OR임을 드러내 줘.
제목이 겹치거나 바뀐 연결 이유는 억지로 맞추지 말고 원문도 보존해 줘.
사용자 코멘트는 고치지 않은 텍스트로 보여 줘.
원본은 변경하지 말고, 실제 대조와 가상 자료 시험의 범위를 나눠 보고해 줘.
독자가 쓸 검수 기준은 다음과 같다.
- 유형·영역·용도가 서로 다른 질문에 답하는가.
- 여섯 칸을 비워도 메모를 읽을 수 있고, 영역 없음과 검토필요를 각각 찾을 수 있는가.
- 새 옵션이 필터에 반영되며, 용도 두 개를 고르면 어느 하나에 해당하는 메모가 나오는가.
- 제목 중복·변경 때 이유를 추측하지 않고, 해석하지 못한 원문도 남는가.
- 사용자 코멘트가 원문 텍스트로 보이며, AI 요약과 구별되는가.
- 실제 원본 대조와 가상 자료 시험을 구분해 설명하는가.
마지막 시연은 가상 메모 두 개면 충분하다. 용도를 바꿔 고르고, 빈 영역을 찾고, 짝을 못 찾은 이유의 원문을 읽어 본다. 이 편에서 바꾸는 것은 다시 찾을 기준과 읽는 방식이다. 원본을 편집하는 권한까지 넓히지 않는다. 쓰기 기능의 안전 경계는 다음 편에서 따로 다룬다.
기록 기준: 2026년 10월 20일의 후속 개선 작업. 예시 화면과 설명도식에는 가상 자료를 사용했다.
이 글은 실제 제작 기록을 바탕으로 AI의 도움을 받아 구성하고 검수했다.