# [[Software Engineering Agents (SWE)|Software Engineering Agents (SWE)]]

## 📌 Brief Summary
Software Engineering Agents(SWE Agents)는 코드 작성, 버그 수정, 테스트 실행, 리팩토링 등 소프트웨어 개발 생명주기(SDLC) 전반의 작업을 자율적으로 수행하도록 특화된 AI 에이전트이다. 단순한 코드 완성을 넘어, 대규모 코드베이스의 구조를 파악하고, 터미널 도구를 활용하며, 실제 실행 환경에서 검증을 거치는 '자율 엔지니어' 역할을 수행한다.

## 📖 Core Content
*   **SWE-agent 및 프레임워크**: Princeton의 SWE-agent와 같이 모델이 파일 탐색기, 편집기, 셸을 효율적으로 사용할 수 있도록 인터페이스를 최적화한 시스템.
*   **SWE-World (Docker-Free Environment)**: 복잡한 Docker 설정 없이도 에이전트가 안전하고 격리된 환경에서 코드를 실행하고 테스트할 수 있게 지원하는 초경량 실행 환경.
*   **코드베이스 탐색 (Navigation)**: 대규모 프로젝트에서 관련 있는 파일과 클래스를 찾기 위해 시맨틱 검색(RAG)과 구문 분석(AST)을 결합하여 컨텍스트를 구성.
*   **자율 디버깅 루프**: 에러 로그 분석 -> 가설 수립 -> 코드 수정 -> 테스트 실행 -> 결과 확인의 과정을 반복하며 버그를 해결.
*   **도구 활용 표준화**: 에이전트가 `grep`, `find`, `sed`와 같은 표준 유닉스 도구나 `Language Server Protocol (LSP)`을 활용하여 정밀한 코드 조작을 수행.

## ⚖️ Trade-offs & Caveats
*   **파괴적 수정의 위험**: 에이전트가 잘못된 판단으로 코드베이스 전체의 아키텍처를 망가뜨리거나 중요한 데이터를 삭제할 위험이 있다. (강력한 샌드박싱과 Git 기반 롤백 필수)
*   **지연 시간**: 대규모 코드베이스를 분석하고 수십 번의 테스트를 돌리는 과정에서 인간 개발자보다 작업 완료 속도가 느려질 수 있다.
*   **기술 부채 생성**: 에이전트가 작성한 코드가 작동은 하지만 가독성이 떨어지거나 확장성이 부족한 경우 장기적인 기술 부채로 남을 수 있다.

## 🔗 Knowledge Connections

### Related Concepts
*   [[Agent Harness|Agent Harness]]
    *   연결 이유: SWE 에이전트가 실제 파일을 수정하고 명령을 내리는 런타임 기반이다.
*   [[Execution Environment (Sandbox)|Execution Environment (Sandbox)]]
    *   연결 이유: 코드를 안전하게 실행하고 검증하기 위한 필수 공간이다.
*   [[Reasoning & Planning|Reasoning & Planning]]
    *   연결 이유: 복잡한 버그 수정 계획을 세우는 에이전트의 지능적 기반이다.

### Deeper Research Questions
*   에이전트가 작성한 코드의 '유지보수성'과 '가독성'을 수치화하여 V-component에서 자동으로 평가하는 기준은 무엇인가?
*   다수의 개발자가 참여하는 프로젝트에서 에이전트가 PR(Pull Request) 리뷰 피드백을 이해하고 자율적으로 수정본을 제출하는 협업 워크플로우의 한계는 어디인가?
*   특정 프로그래밍 언어나 프레임워크에 특화된 '도메인 지식 그래프'를 결합했을 때 SWE 에이전트의 버그 해결률 상승 폭은 어느 정도인가?

### Practical Application Contexts
*   **Implementation:** 오픈소스 프로젝트의 Issue를 입력받아 에이전트가 자동으로 수정 코드와 유닛 테스트를 포함한 PR을 생성하는 자동화 파이프라인을 구축한다.
*   **System Design:** 사내 레거시 코드의 기술 부채 해결을 위해 에이전트가 점진적으로 리팩토링을 수행하고, 변경 전후의 성능 및 안정성을 비교 리포트로 제출하게 한다.

---
*Last updated: 2026-05-01*
