bibimbap/.serena/memories/graphify_workflow.md

964 B

Graphify Workflow — bibimbap

graphify 지식그래프 산출물 운용 규약.

  • 위치: 산출물은 docs/graph/<scope>/{graph.html, graph.json, audit.md}. 메타는 docs/graph/index.md (frontmatter last_generated_at/source_commit/scopes + Scopes 표).
  • 추적: graph 본체(html/json/audit)는 docs/graph/.gitignore무시(재생성 가능). index.md.gitignore 만 커밋.
  • 현재 scope: src (Java 코드, 정적 이미지 제외), docs (md + DDL, 자기 산출물 docs/graph/* detect 제외).
  • 함정: /graphify <path> 는 입력경로 하위에 transient 캐시 <path>/graphify-out/ (AST/semantic 캐시)를 남긴다. 실행 후 반드시 rm -rf <path>/graphify-out — 안 그러면 소스트리 오염 + 오커밋. (이번 세션에서 src/graphify-out·docs/graphify-out 발견.)
  • 재생성 시 index.md 메타 갱신 필수. 폐기 scope 는 디렉토리 rm + 표에서 제거.