AI 코드·스니펫 검사 글에 판단 매트릭스와 유입 경로 도식 추가

[haksungjang]

산문과 표만으로 설명하던 두 대목을 그림으로 옮겼습니다. 본문 서술은 도식 도입 문장 외에 바꾸지 않았습니다.

그림 1 — 판단 매트릭스

"어떤 조건에서 더 중요해질까" 절이 두 축을 제시합니다. 코드를 외부에 전달하는가, 외부 검증을 받는가. 그런데 바로 다음 표는 이 조합을 3행으로 눌러 담고 있었습니다. 두 축의 조합인데 표에서는 조합 관계가 보이지 않고, "코드 전달하지만 감사 없음"이 왜 중간인지도 위치로 드러나지 않았습니다.

사분면으로 바꾸면 독자가 자기 회사 위치를 바로 찾습니다. 표에 없던 네 번째 칸(전달 안 함 + 검증 있음)도 채웠고, 사분면과 무관하게 스니펫 검사가 기본 수단이 되는 임베디드 예외를 주석으로 달았습니다. 기존 표는 이 그림으로 대체했습니다.

그림 2 — 유입 경로와 검사 커버리지

글 전체가 "무엇이 무엇을 못 잡는가"를 논증하는데 그 구도를 한눈에 보여주는 그림이 없었습니다. 패키지 매니저로 선언된 것은 의존성 SCA가 보고, 복사·붙여넣기와 AI 생성 조각은 스니펫 매칭만 잡으며, 임베디드는 매니페스트가 없어 SCA가 아예 못 본다는 내용이 본문 여러 절에 흩어져 있어 독자가 머릿속에서 합쳐야 했습니다.

사전 차단 설정 이야기가 끝난 뒤에 배치해 세 요소가 모두 설명된 다음 정리되도록 했습니다.

손대지 않은 것

SCA와 스니펫 매칭을 구분하는 첫 표는 그대로 뒀습니다. 두 항목의 속성 비교라 표가 맞는 형태이고, 도식으로 바꾸면 오히려 장황해집니다.

표기

색은 강조 한 곳에만 썼습니다. 매트릭스는 부담이 가장 큰 사분면 하나, 커버리지 그림은 스니펫 매칭 카드 하나입니다. 나머지는 무채색이고 관계는 배치로 전달합니다.

PNG를 본문에 넣고 SVG 원본을 편집 소스로 함께 뒀습니다. 문구나 배치를 고칠 때 SVG를 수정하고 다시 렌더하면 됩니다.

확인

• Hugo 프로덕션 빌드 통과(1,438페이지)
• 도식 2개와 SVG 원본 4개 파일 배포 확인
• 기존 표 제거 확인