bibimbap/docs/graph/index.md

kind	last_generated_at	source_commit	scopes
graphify-meta	2026-06-22T12:40:00+0900	b9d836d	src docs

Graph — graphify 산출물 메타

이 디렉토리는 /graphify 가 생성하는 지식 그래프 산출물의 메타 정보만 커밋한다. HTML/JSON/audit 본체는 .gitignore 대상이며 재생성 가능하다.

설치·적용 가이드는 atp-graphify add-on 번들의 graphify-usage.md 참조.

엔트리포인트 사용법

• 구조 탐색이 필요한 작업 전에 이 파일의 last_generated_at 과 source_commit 을 확인한다.
• 메인 브랜치 기준 마지막 소스 커밋보다 뒤쳐져 있다면 graph-refresh-checker 서브에이전트를 호출해 staleness 판정을 받는다.
• 판정 결과가 partial-stale / fully-stale 이면 메인 에이전트가 /graphify 를 호출해 재생성하고, 이 파일을 갱신한다.
• 더 이상 관련 없는 scope (제거된 모듈 등) 의 산출물은 재생성 전 삭제 한다.

산출물 레이아웃

docs/graph/
├── index.md               # 이 파일 — 메타, 커밋 대상
├── .gitignore             # 본체 무시
└── <scope>/               # scope 별 산출물 디렉토리 (무시됨)
    ├── graph.html
    ├── graph.json
    └── audit.md

scope 예시: src, src-features, docs, full 등. 한 번에 여러 scope 를 운용할 수 있다.

Scopes

scope	마지막 생성	소스 커밋	대상 경로	요약
src	2026-06-22	b9d836d	src/ (Java 42 + AST)	536 노드 / 1206 엣지 / 20 커뮤니티. Spring MVC 컨트롤러→매퍼→data 흐름. W3-2 댓글/리뷰 고도화 반영: 리뷰 API 다축평점(loadAxes/buildSummary/normalizeReviewSort) · 댓글 API commentView · 댓글 데이터 모델 edited/updatedAt 군집. 정적 이미지 제외.
docs	2026-06-22	b9d836d	docs/ (md 28 + DDL 3)	119 노드 / 164 엣지 / 15 커뮤니티. 문서 카테고리 체계 + 보안·검증 + 플랫폼 로드맵 군집. W3-2 고도화 반영: C3 재분류·육각형 SVG·game_review_axes/game_review_stats·TextNormalizer 군집 + game_reviews 계열 DB 스키마 군집 + 검증·설계 교훈 군집.

갱신 시 체크리스트

• frontmatter 의 last_generated_at, source_commit, scopes 갱신
• 아래 "Scopes" 표에 한 줄 추가/갱신
• 폐기된 scope 가 있다면 해당 디렉토리 rm -rf + 표에서 제거