그래프 엔지니어링

왕초보 설명

  • 이게 뭐야? 여러 AI·루프·도구·검사자가 함께 일할 때, **누가 무엇을 하고(노드), 다음은 어디로 넘기고(엣지), 어떤 메모를 같이 보고(공유 상태), 실패하면 어디로 되돌아가는지(라우팅)**를 그림과 표로 미리 정하는 것이다.
  • 비유: 회사 결재 라인. “작성 → 팀장 검토 → 반려면 작성자에게, 승인이면 부장에게”를 미리 정해 둔다.
  • 나는 뭘 하면 돼? 갈림길이나 되돌아가기가 있는 작업이면 graph.md를 쓴다. 단계가 많기만 하면 그냥 순서대로 도는 스크립트로 충분하다.

정의

여러 agent, 루프, 도구, 평가자를 명시적 그래프(노드 + 엣지 + 공유 상태 + 라우팅 규칙)로 조직해, 작업 단위 간 연결·공유 상태·경로 선택을 설계·관측·부분 수리 가능하게 만드는 실천. 노드는 결정적 코드, 모델 호출, 도구, 또는 자기 루프를 가진 완전한 agent일 수 있다.

왜 중요한가

  • 단일 루프는 결정(분업·병렬·롤백·인계)을 한 agent의 컨텍스트 안에 숨긴다. 그래프는 그것을 종이 위에 올려 읽고 감사하고 고칠 수 있게 한다.
  • 단일 루프의 구조적 실패(Goodhart, 위쪽 실명, 루프 간 충돌)는 루프 안 체크포인트로 못 고친다. 검사를 독립 노드로 옮겨야 한다.
  • 반대로 남용하면 오케스트레이션 세금(사람의 검토 대역폭)만 늘어난다.

등장하는 곳

  • lecture-14: 4층 겹침(prompt → context → loop → graph), 네 부품, graph ≠ workflow, 첫 그래프 6단계, 다섯 판단 기준(셋 이상), LangGraph 참조 구현.
  • project-08: P07 루프를 graph.md로 그리기 → fan-out/fan-in → 문제 층으로의 롤백과 사람 승인 노드.

관련 개념

  • loop-engineering: 루프는 그래프의 한 노드. 그래프는 루프를 대체하지 않고 그 위에 쌓인다.
  • maker-checker-separation: 그래프에서 verify 노드는 fresh context로 구현 노드와 분리된다. 프롬프트 문제가 아니라 구조 문제.

상충·열린 질문

  • 하네스의 위치: 이 코스는 하네스를 loop·graph 모두의 기반으로 두지만, 강의 스스로 explainx는 loop 위에, Buildrix 논문은 loop 아래에 둔다고 소개한다. 합의된 정의가 없다.
  • lecture-14의 6단계 설명(implement 내부 최대 3회 루프, 병합 전 사람 승인)과 참조 코드 maker_checker_graph.py(횟수 상한 없음, attempts 미증가, 승인 정지 없음)가 다르다.