문서화 보고

작성/수정된 문서

경로	카테고리	유형	링크 추가한 index	교차 링크
`docs/changes/2026-07-24-post-categories-seed-list-redesign.md`	changes	신규	`docs/changes/index.md` 에 한 줄 추가	관련 문서 4개(W3-3 원설계, 2026-06-30 visual-redesign, frontend-redesign-coverage-checklist, document-category-classification)
`docs/changes/index.md`	changes	기존 갱신	— (index 자신)	—
`docs/development/frontend-redesign-coverage-checklist.md`	development	기존 갱신(스코프 정합 확인 후 append)	해당 없음(신규 문서 아님)	`posts-list.jsp` 행 근거 열에 새 문서로의 링크 추가
`docs/changes/2026-06-30-visual-redesign-bibimbap-css.md`	changes	기존 갱신(스코프 정합 확인 후 append)	해당 없음(신규 문서 아님)	"관련 문서" 절에 새 문서로의 후속 링크 추가(단위2 fragment 대체 사실 명시)

카테고리 판별 근거

document-category-classification.md "빠른 결정 순서" 적용: 아키텍처 원칙에 대한 되돌리기 어려운 결정이 아니고(카테고리 세트·시드 위치는 제품 taxonomy 확정일 뿐 레이어/기술 선택 아님), 운영 장애가 아니고, 실제 코드(posts-list.jsp, 신규 fragment 2개, PostControllerTest.java)와 소비 데이터(post_categories DML 시드)가 실제로 바뀌어 런타임 동작이 달라졌다 → changes/.

ADR 후보 여부 재검토: "편집형 일방 발행 모델" 정정은 이미 POST_WRITE 권한 게이트로 W3-3 설계 당시 확정된 기존 전제의 재확인이며 이번 세션이 새로 뒤집은 아키텍처 결정이 아니다(세션 내부 orchestrator 가정 오류의 정정일 뿐, 코드/스키마 차원의 기존 결정 변경 아님) → 신규 ADR 불필요로 판단.

기존 파일 append 전 스코프 대조 (수행 근거)

docs/development/frontend-redesign-coverage-checklist.md: 첫 단락 스코프 선언 "WEB-INF/views/*.jsp 전체... 클로드 디자인 리디자인의 '마크업·클래스 이식' 단위 반영 여부를 추적" + 사용 규칙 "세션 종료 시: 이번 세션에서 다룬 파일의 상태 열을 갱신하고, 다룬 근거 커밋/문서 링크를 채운다" — 이번 세션이 posts-list.jsp 를 다뤘고 근거 열 갱신은 선언된 스코프 내 정규 사용법이므로 append 적합 판정.
docs/changes/2026-06-30-visual-redesign-bibimbap-css.md: 첫 단락 스코프는 "9단위 비주얼 리디자인 changelog" 고정 스냅샷. 본문 서술은 수정하지 않고 "관련 문서" 절(이미 선행 작업 링크 1건 존재하는 인덱스성 절)에 후속 링크 1줄만 추가 — 선례(2026-06-18-w3-2-comments-reviews.md 가 2026-06-22 고도화 문서로 "해소" 링크를 사후 추가한 패턴)와 동형. 이월 항목이 아닌 완료 유닛(단위2)이 사후에 대체됐다는 사실 포인터이므로 스코프 위반 아님으로 판정.

의사결정 기록 위치

D1(카테고리 세트)/D2(시드 위치)/D3(모델 정정): .atp/work-session/20260724-100414/report.md # Decisions 섹션(원본 소스), docs/changes/2026-07-24-post-categories-seed-list-redesign.md "결정" 절에 요약 이관.
설계 상세(토큰계획·카테고리 hue 맵·탭 마크업·AC 12개 근거): .atp/work-session/20260724-100414/artifacts/design-posts-categories.md (design-advisor 산출, 원본 유지 — 이번 문서화 단계에서 복제하지 않고 링크만 인용).
검증 상세(L1 FAIL→복구 경위, AC 매칭 표): .atp/work-session/20260724-100414/artifacts/verification-posts-categories.md.

추후 문서화가 필요한 항목

모바일 좁은 폭 육안 확인, 라이트 테마 육안 확인, 카드 뱃지 dot 실물 확인, 운영 스키마 시드 반영(운영자) — 4건 모두 needs_user_verification 으로 changes/2026-07-24-post-categories-seed-list-redesign.md 에 이미 명시. 완료 시 해당 문서에 결과 append 필요(신규 문서 불요, 기존 문서 갱신).
graph-refresh partial-stale open item(근본원인 선행 커밋 02a1b75, JSP/JSPF graphify 스캔범위 밖) — 별도 graph 부채로 이월됨. graphify-update-advisor 소관이라 이번 문서화 단계에서 손대지 않음.

4.4 KiB Raw Blame History