LangGraph Patterns for Coding Agent

이 스킬은 LangGraph 패턴과 이 Coding Agent 프로젝트의 아키텍처 지식을 제공합니다.

프로젝트 아키텍처

핵심 개념

파일 중심 아키텍처: 태스크별 파일이 아닌, 파일별로 코드 누적

• file_map: Dict[str, FileState]가 중앙 저장소
• 각 태스크가 file_map[target_file].content에 코드 추가
• Save 노드에서 한 번에 디스크 저장

워크스페이스 격리: 세션별 독립 디렉토리

• workspaces/{prd_name}_{timestamp}/
• 동시 실행 지원

워크플로우

plan → retrieve → write → build → execute → critic ─┐
                                                     │
         ┌───────────────────────────────────────────┘
         ↓
    (retry or next task)
         │
         ↓ (all tasks done)
    test_gen → save → END

LangGraph 패턴

노드 정의

class MyNode:
    def __call__(self, state: AgentState) -> Dict[str, Any]:
        # 상태 읽기
        data = state["field_name"]

        # 처리

        # 변경된 필드만 반환
        return {"updated_field": new_value}

조건부 라우팅

def route_function(state: AgentState) -> str:
    if condition:
        return "node_a"
    return "node_b"

graph.add_conditional_edges(
    "source_node",
    route_function,
    {"node_a": "node_a", "node_b": "node_b"}
)

루프 패턴

def should_continue(state: AgentState) -> str:
    if state["current_idx"] >= len(state["items"]):
        return "end"
    return "continue"

graph.add_conditional_edges("process", should_continue, {
    "continue": "process",
    "end": "finalize"
})

상태 스키마

AgentState 필드

FileState 필드

주요 파일

• graph/state.py: 상태 스키마
• graph/build_graph.py: 그래프 구성
• graph/nodes/*.py: 노드 구현
• graph/workspace_manager.py: 세션 관리
• main.py: 엔트리 포인트

디버깅 팁

# 상태 필드 사용 현황
grep -oh "state\[\"[^\"]*\"\]" graph/nodes/*.py | sort | uniq -c

# 노드 반환값 확인
grep -A 3 "return {" graph/nodes/*.py

# 조건부 라우팅 확인
grep -B 5 -A 10 "add_conditional" graph/build_graph.py

제약 사항

• Windows: encoding='utf-8' 필수
• LangGraph: recursion_limit=100 설정
• JSON 파싱: 정규표현식으로 사전 정리 필요