선행 커밋(93525cb)에서 add 중단으로 누락된 문서 보완.
- docs/development/local-dev-setup.md 신설: 업로드 저장루트(~/.bibimbap/uploads)
경로 규약 · @Value 기본값 유지 근거 · 자산 이전 이력 표 · SSRF DNS 캐시 운영 참고
- docs/development/index.md 목록 링크 추가
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01K3FeMrbtxfTScjrwUukyHD
설계·테스트 단계 체크리스트(append-only):
- 신규 *Test.java 는 "(검증)" 소유태그여도 구현 산출물(verification은 실행만, Write 없음)
- 매퍼 alias 케이스폴딩 기준 = Map resultType/집계 SELECT (VIEW 여부 아님). POJO 직접매핑은 비인용 허용 — BUG-2 교훈 정밀화
- 신규 컨트롤러 호출 공유 헬퍼는 정의 존재를 grounding(rg)으로 선확인(test-compile 비신뢰)
외부 번들 권고 2건 추가(design-advisor owner 표기 분리·impl-advisor 헬퍼 grounding). 근거 W2 세션(20260624).
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
비-메인스트림 브랜치(main/master·보호 브랜치 외)에서는 작업 단위마다 매번
묻지 않고 커밋하도록 표준 승인(durable authorization)을 명문화. 하니스
기본규칙('사용자 요청 시에만 커밋')과 모순 없음 — 프로젝트 지침이 사전·상시
승인을 부여하는 형태. push 는 브랜치 무관 명시 요청 한정, 메인스트림은
branch-first 유지.
- docs/development/git-workflow.md: 정본 신설. 브랜치 분류·표준 승인·push
제외·커밋 단위·Conventional Commits + Co-Authored-By 트레일러 규약.
- CLAUDE.md 작업 원칙: 표준 승인 요지 2불릿 + 정본 링크.
- docs/development/index.md: 정본 등재.
ADR 아닌 development 규칙으로 분류(가역적 운영 절차). 부수 발견: 보고서들이
참조하는 ADR-0010 은 docs/adr/ 에 실재하지 않는 phantom 참조.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
W3 합의 세션 회고 교훈을 MEMORY 대신 docs/development/ 에 반영(사용자 지시).
사용자 대면 의사결정 제시문은 배경+선택지+권장 풀어쓰기, 압축은 내부 산출물 한정.
발원: 20260617-174635 세션 W3-1 마무리 질문 과압축 → 사용자 파악 실패.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
docs/ 카테고리 트리(adr·analysis·architecture 등)와 ATP 워크플로 문서를 신규 추가하고,
4축(아키텍처·보안·품질·도메인) read-only 종합 분석을
docs/analysis/2026-06-16-project-analysis.md 로 기록한다.
- 신규 분석 문서 + docs/analysis/index.md 링크
- 기존 docs 2건(db-update-query-generator, user-signup-schema)에 교차링크 추가
- CLAUDE.md 프로젝트 지침, .atp/work-session 분석 세션 기록, .serena 프로젝트 설정 포함
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
이정수