한국어EN
정리 노트그래프 엔지니어링

그래프 엔지니어링이라는 말이 뒤섞은 세 개념

그래프 엔지니어링이 혼란스러운 이유는 컨트롤 그래프(SOP로 에이전트 신뢰성 확보), 지식 그래프(엔티티 관계 기반 검색, 무관한 개념), 루프의 그래프(여러 루프의 조율, 아직 미해결)라는 세 가지가 한 단어로 뭉뚱그려지기 때문이다. 실무에서 쓸모 있는 것은 컨트롤 그래프이며, 그 배경에는 사람이 직접 프롬프트하던 방식에서 트리거 기반 루프와 에이전트 팀을 지휘하는 오케스트레이터로 옮겨가는 전환이 있고, Claude Code를 만든 Boris가 밤새 수천 개의 에이전트를 돌린다는 말이 그 규모감을 보여준다. 그래프는 노드·엣지·상태로 구성되지만 새로운 점은 노드가 스크립트에서 LLM을 거쳐 에이전트 자체가 됐다는 것이고, 구현은 LangGraph 같은 코드-그래프와 SOP를 스킬로 읽히는 LLM-그래프 모두 유효하다. 검증자와 플래너는 별도 노드로 분리하고, 흔한 데이터 처리는 코드로 하며, 노드별 입출력 경계를 정의하고, 상태는 마크다운 파일과 추가 전용 로그로 관리하라는 네 원칙이 체크리스트가 된다.

기억할 것
  • 컨트롤·지식·루프의 그래프는 다른 개념이며 실용적 핵심은 컨트롤 그래프
  • 노드가 에이전트가 된 것이 새로움, 코드-그래프와 LLM-그래프 모두 유효
  • 설계 4원칙: 노드 분리(검증자·플래너), 코드 활용, 입출력 경계, 상태 관리
  • 작업 분해만으론 부족하고 에이전트에게 테스트 도구를 줘야 루프가 돈다
그래프 엔지니어링컨트롤 그래프오케스트레이터Claude CodeSOP

이 글은 제가 여러 자료를 읽고 제 말로 다시 정리한 노트예요. 출처 링크를 달지 않는 대신, 사실 확인이 된 사건은 기록에 따로 있어요.