에이전트

에이전트와 실행 역할

에이전트, 파이프라인 기능, 호환용 프롬프트를 구분합니다.

기준일
이 페이지에서

DTRAC Project의 에이전트 문서는 런타임 역할과 이를 지원하는 파이프라인 기능을 구분합니다. 현재 분류의 기준은 agentTaxonomy.mjs, 프롬프트 파일 연결의 기준은 agentPromptRegistry.mjs입니다. 파일명만으로 새로운 에이전트가 있다고 판단하지 않습니다.

런타임 에이전트

현재 canonical 목록은 다음 네 가지입니다. 목록에 등록되어 있다는 사실과 특정 작업에서 실제 호출되는지는 별도로 확인해야 합니다.

ID연결된 프롬프트 파일
research-partnerresearch-partner.md
protocol-agentprotocol-agent.md
ui-agentui-agent.md
data-agentdata-collection-specialist.md

이 이름과 파일의 대응은 registry가 관리합니다. 예를 들어 data-agent의 파일에는 기존 specialist 이름이 남아 있습니다.

파이프라인과 호환 역할

flow-design, feasibility-review, screen-generation, build-validation은 taxonomy에서 파이프라인 기능으로 분류됩니다. 이들을 네 개의 추가 런타임 에이전트로 세지 않습니다.

orchestrator와 기존 specialist 이름은 compatibility 분류에도 남아 있습니다. 프롬프트 registry는 별도로 persona 파일과 legacy stage 파일 목록을 관리합니다. 기존 저장 데이터나 호출 경로의 호환성을 확인하기 전에 이 파일을 제거하거나 이름을 바꾸면 안 됩니다.

프롬프트를 읽는 경로

agentDocs.ts는 registry가 지정한 Markdown을 읽어 역할별 지시문을 구성합니다. specialist 프롬프트는 호출 시 다시 읽으며, 버전 함수는 역할·계약 버전·지시문으로 해시를 만들어 추적용 버전을 생성합니다.

이 문서는 역할 분류와 로딩 경로까지 다룹니다. 각 작업의 모델 선택, 실행 순서, 실패 복구와 사용자 검토 조건은 해당 실행 경로를 확인한 상세 문서가 필요합니다. UI 작업 영역과의 관계는 빌더 문서에서 시작할 수 있습니다.

아키텍처 참고 자료

DTRAC 아키텍처 — Assurance 탭을 빌더·에이전트 구조와 함께 참고하세요. 외부 아키텍처 자료로 이동하며, 링크는 Assurance 탭을 지정합니다.

참고 사이트는 현재 ChatGPT 로그인이 필요합니다.

문서 근거

현재 작업 트리 기준 · 소스 경로 · HEAD 8213e6b7

  • app-electron/src/shared/agentTaxonomy.mjs
  • app-electron/src/shared/agentPromptRegistry.mjs
  • app-electron/src/main/llm/agentDocs.ts
DTRAC Project연세대학교 · 이봉신 연구팀