bibimbap/.atp/work-session/20260617-110836/documentation.md

phase	agent	agent_version	generated_at	concerns	concerns_checked
documentation	documentation-advisor	1	2026-06-17T11:08:36+09:00	usage/index.md '목록' 에 기재된 setup-checklist.md / faq.md 의 실제 파일이 부재(링크 dangling). 본 작업 범위 밖이라 수정하지 않음 — 별도 보강 필요.	true

문서화 보고

작성/수정된 문서

경로	카테고리	유형	링크 추가한 index	교차 링크
docs/usage/local-setup.md	usage	신규	docs/usage/index.md (목록 1줄)	analysis/2026-06-16-project-analysis.md open_question #4 → local-setup §1·§7
docs/usage/index.md	usage	수정(링크 추가)	자기 자신	-
docs/analysis/2026-06-16-project-analysis.md	analysis	수정(역링크 1줄)	-	local-setup.md 로 역링크

의사결정 기록 위치

• 로컬 개발환경 온보딩(경로 A Docker / 경로 B 직접 실행, DB 스키마 초기화, 트러블슈팅) → docs/usage/local-setup.md
• 카테고리 판별: 이식자·사용자 관점 운영 가이드 → usage/ (document-category-classification.md §usage 근거). 런타임 동작 변경(changes) 이나 불변 결정(adr) 아님.
• 검증 근거(BUILD SUCCESS, HTTP 200, Tests 6/0, WAR 산출 등)는 orchestrator 실행 결과만 인용. 추측 미추가.

추후 문서화가 필요한 항목

• usage/index.md 가 참조하는 setup-checklist.md / faq.md 실제 파일 작성 또는 인덱스 정리 (현재 dangling link).
• db/schema.sql 5개 비권위 테이블의 운영 DB pg_dump 대조 후 권위 DDL 확정 → 확정 시 maintenance/ 또는 contracts/ 에 스키마 기준 문서화 검토.
• spring-boot SNAPSHOT 고정 vs 안정 릴리스 결정 시 → adr/ 신규 레코드.

산출 경로

• /Users/wemadeplay/workspace/stz/bibimbap/docs/usage/local-setup.md (신규)
• /Users/wemadeplay/workspace/stz/bibimbap/docs/usage/index.md (목록 링크 추가)
• /Users/wemadeplay/workspace/stz/bibimbap/docs/analysis/2026-06-16-project-analysis.md (교차 역링크 추가)
• /Users/wemadeplay/workspace/stz/bibimbap/.atp/work-session/20260617-110836/documentation.md (본 보고)