Skip to content

Agent Workflow

JJ04s edited this page May 30, 2026 · 1 revision

1. 개요

AI Agent와의 대화에서 발생할 수 있는 논리적 도약을 방지하고, 물리 법칙이 코드로 변환되는 과정을 사용자가 완벽히 통제하기 위한 워크플로우를 정의한다.

2. 작업 단위

효율적인 개발과 디버깅을 위해 작업을 두 가지 단위로 나누어 수행한다.

  • 컴포넌트 단위
    • 초기 화면: 신규 프로젝트 생성, 저장된 프로젝트 불러오기 등
    • 유형 선택 모달창: 1D/2D 등 프로젝트 유형, 제목 등 선택
    • 워크스페이스: 4분할 레이아웃, 아래의 기능을 화면에 렌더링
  • 기능 단위
    • 사용자 입력을 받아 $V(x)$ 배열을 생성하는 로직 구현
    • 전달받은 데이터를 그래프로 시각화하는 로직 구현
    • 물리량을 전달받아 슈뢰딩거 방정식을 수치적으로 해결하는 Solver 엔진 구현 등

3. AI Agent 개발 워크플로우

  1. 루프 단위
  • 2. 작업 단위를 참고하여 수행할 일의 체크리스트 작성, 체크리스트 단위 기능 개발.

  • AI 작업 단위는 한 토큰당 한 파일만을 생성.

  1. 코드 작성
  • 단일책임원칙에 의거해 한 함수가 한 기능만을 수행하도록 코드를 작성.

  • docs 폴더의 디렉토리 구조, 상태 흐름 등의 설계 문서를 적극 참고

    • 설계되지 않은 기능 구현의 경우 사용자에게 계획을 보고 후 진행.
  1. 예외 처리
  • 테스트케이스 등을 설정, 테스트코드를 작성해 케이스를 모두 통과하면 다음 기능 개발로 이동.

  • 직접 npm run dev, npm start를 터미널에 입력하도록 하여 오류가 발생 시 hook 등으로 break 및 알림.

Clone this wiki locally