49 lines
2.5 KiB
Markdown
49 lines
2.5 KiB
Markdown
---
|
|
kind: graphify-meta
|
|
last_generated_at: 2026-06-30T17:00:00+0900
|
|
source_commit: 360078a
|
|
scopes:
|
|
- full
|
|
---
|
|
|
|
# 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 예시: `full`, `src`, `docs`, `src-features` 등.
|
|
|
|
> **scope 전략**: 이 프로젝트는 `full` 단일 scope를 기본으로 한다 (src 1840노드 + docs 198노드 = 2038노드 수준은 단일 그래프로 감당 가능). src↔docs 교차 엣지(코드↔설계문서 관계)가 살아있어야 작업 컨텍스트가 끊기지 않기 때문. 규모가 수만 노드 수준으로 비대해지면 scope 분리 재검토.
|
|
|
|
## Scopes
|
|
|
|
| scope | 마지막 생성 | 소스 커밋 | 대상 경로 | 요약 |
|
|
| --- | --- | --- | --- | --- |
|
|
| `full` | 2026-06-30 | `360078a` | `src/` + `docs/` | **src+docs 통합** (재생성 요청 중). 신규 노드 6건(posts-empty.jspf, recruit-empty.jspf, bibimbap.css, screenshot-guide.md, screenshot-guide.py, 2026-06-30-screenshot-guide-auth.md) + include 엣지 2건(posts-list.jsp→posts-empty.jspf, recruit-list.jsp→recruit-empty.jspf) 반영. Java/컨트롤러/라우트/모델/스키마 무변경. |
|
|
|
|
## 갱신 시 체크리스트
|
|
|
|
- [ ] frontmatter 의 `last_generated_at`, `source_commit`, `scopes` 갱신
|
|
- [ ] 아래 "Scopes" 표에 한 줄 추가/갱신
|
|
- [ ] 폐기된 scope 가 있다면 해당 디렉토리 `rm -rf` + 표에서 제거
|