Migrate Graphify harness to a raw source corpus

[pko89403]

한 줄 요약

• 이 PR은 Graphify 하네스를 docs/wiki/docs/sources 중심 모델에서 raw/ source corpus + graphify-out/ generated graph 모델로 바꿔, 로컬 자동 갱신과 검증 가능한 지식 그래프 워크플로를 정착시킵니다.

배경 / 문제

• 기존 상태:
  • 설계/지식 계층이 docs/wiki와 docs/sources 전제를 오래 끌고 있었고, Graphify 입력 경계와 하네스 문서가 일치하지 않았습니다.
  • PR/이슈 템플릿, command draft, hook/CI 일부도 이전 knowledge model을 가정하고 있었습니다.
• 문제:
  • Graphify source-of-truth가 불명확했고, wiki 제거 이후에도 여러 하네스 표면에서 stale 경로를 계속 가르칠 수 있었습니다.
  • auto-refresh, candidate CI, PR 생성 규칙이 모두 새 raw/ 모델에 맞게 정렬될 필요가 있었습니다.
• 이번 PR의 목표:
  • Graphify의 유일한 source corpus를 raw/로 고정합니다.
  • generated graph는 graphify-out/ 하나만 최신 상태로 유지합니다.
  • full refresh / verify / sync / auto-refresh / CI candidate / 하네스 문서를 하나의 모델로 맞춥니다.

PR 대시보드

항목	내용
유형	refactor / docs / chore
영향 범위	docs / harness / tests
동작 변경	있음
Breaking Change	있음 (docs/wiki, docs/sources 제거 및 raw/ 전환)
관련 이슈	없음
기준 브랜치	main

변경 묶음별 리뷰 가이드

변경 묶음	파일/디렉토리	무엇이 바뀌었나	리뷰 포인트	실행 없이 보는 법
Graphify source 전환	raw/..., graphify-out/..., scripts/graphify_*	source corpus를 raw/로 전환하고 full refresh/verify/sync/auto-refresh 파이프라인을 추가	source boundary가 src/, tests/, raw/로 닫혔는지, BUILD_INFO.json 신뢰 모델이 맞는지	scripts/graphify_prepare_corpus.sh, scripts/graphify_verify_full_refresh.py, graphify-out/BUILD_INFO.json 확인
하네스 규칙	CLAUDE.md, .github/copilot-instructions.md, .harness/..., .agents/skills/...	docs/wiki 전제를 제거하고 raw/ + Graphify-first 모델로 정렬	에이전트가 stale 경로를 다시 배우지 않는지, PR 생성 규칙까지 포함해 source of truth가 일관적인지	규칙 문서와 skills 설명만 읽고 경로/명령 비교
CI / hooks	.github/workflows/ci.yml, .harness/hooks/...	candidate CI와 local auto-refresh를 raw/ 모델에 맞춤	CI는 candidate-only인지, local hook은 code/doc 변경을 올바른 refresh 경로로 보내는지	paths filter, bootstrap 조건, candidate note 문구 확인
테스트	tests/test_graphify_*.py, tests/test_execute_script.py	새 knowledge model과 hook behavior를 고정하는 회귀 테스트 추가	raw/ 기반 기대치가 충분한지, git hook 환경 누수 같은 운영 이슈를 막는지	테스트 이름과 assertion만 읽기

Before / After

Before

• docs/wiki와 docs/sources가 지식 계층의 중심처럼 남아 있었고, Graphify는 그 위에 부분적으로만 얹힌 상태였습니다.
• stale hook/CI/path guidance 때문에 source corpus 경계가 문서마다 조금씩 달랐습니다.
• 자연어 PR 생성 요청 시 템플릿을 우회할 수 있었습니다.

After

• raw/design/**, raw/external/**가 Graphify source corpus의 유일한 정본이 됩니다.
• graphify-out/가 primary machine-readable knowledge layer로 고정됩니다.
• code refresh / full refresh / verify / sync / auto-refresh / candidate CI / docs-manager가 모두 같은 raw/ 모델을 기준으로 동작합니다.
• 자연어 PR 생성 요청도 .github/pull_request_template.md를 기준으로 처리하도록 규칙이 추가됩니다.

검증

항목	결과	근거
테스트	✅	uv run pytest -q
린트	✅	uv run ruff check .
타입체크	✅	uv run mypy src

추가 확인:

• uv run pytest tests/test_graphify_harness.py -q
• pre-push hook: uv run pytest --ignore=tests/test_mlx_runtime.py --ignore=tests/test_cli_smoke_mlx.py

남은 리스크 / 후속 작업

• raw/design/diagrams/**와 raw/design/screenshots/**의 richer semantic extraction은 아직 v1 범위 밖입니다.
• 필요하면 gh pr create를 감싸는 repo-local PR 생성 스크립트를 추가해 템플릿 적용을 더 강하게 자동화할 수 있습니다.
• 주의할 점:
  • docs/wiki와 docs/sources는 제거됐으므로, 이후 문서/하네스 변경은 모두 raw/와 graphify-out/를 기준으로 해야 합니다.
  • graphify-out/는 generated output이고, source edits는 raw/에서 해야 합니다.
• 리뷰 시 특히 볼 부분:
  • scripts/graphify_prepare_corpus.sh, scripts/graphify_verify_full_refresh.py, .harness/hooks/graphify-auto-refresh.sh
  • CLAUDE.md, .github/copilot-instructions.md, .harness/reference/local-adaptation.md
  • .github/workflows/ci.yml, tests/test_graphify_auto_refresh.py, tests/test_graphify_harness.py