From 203072115564b5771f0b85bce4146acad9e910b9 Mon Sep 17 00:00:00 2001 From: Godopu Date: Mon, 6 Jul 2026 23:28:45 +0900 Subject: [PATCH] refactor: reorganize project structure by moving deployment and asset files and updating core orchestration scripts --- .mam/agent-sessions.yaml | 53 ++++++++++++++++--- Planning.md | 14 ----- .../slides/lecture_summary.md | 0 remove.sh => deploy/remove.sh | 0 requirements.txt => deploy/requirements.txt | 0 update.sh => deploy/update.sh | 0 reviewer_prompt.txt | 13 +++++ 7 files changed, 59 insertions(+), 21 deletions(-) delete mode 100644 Planning.md rename lecture_summary.md => assets/slides/lecture_summary.md (100%) rename remove.sh => deploy/remove.sh (100%) rename requirements.txt => deploy/requirements.txt (100%) rename update.sh => deploy/update.sh (100%) create mode 100644 reviewer_prompt.txt diff --git a/.mam/agent-sessions.yaml b/.mam/agent-sessions.yaml index 77cab58..78942c7 100644 --- a/.mam/agent-sessions.yaml +++ b/.mam/agent-sessions.yaml @@ -1,9 +1,9 @@ snapshot: - taken_at: '2026-07-06T00:54:45Z' + taken_at: '2026-07-06T02:01:13Z' cwd: /Users/godopu16/PuKi/lab/canary_projects/multi-agent-paper tmux_sessions: - name: canary-projects-multi-agent-paper-creator-claude - status: running + status: stopped role: researcher-reviewer tmux_session_created_at: '2026-06-30T02:14:27Z' tmux_session_epoch: 1782785667 @@ -26,9 +26,14 @@ tmux_sessions: version: (unknown — read from TUI) claude_session_id_own: d6eb5e41-a7a6-4c92-b6f2-4133da3a292e last_visible_status: resumed conversation d6eb5e41-a7a6-4c92-b6f2-4133da3a292e at 2026-07-06T00:54:45Z - last_visible_status_at_termination: ' 32 33 -셋째, **구조화된 직렬화 기반의 태스크 생명주기 관리 및 부하 분산 효율**이다. Protobuf(Protocol Buffers)의 스키마 정의형 바이너리 직렬화는 텍스트 기반 JSON 파싱 대비 직렬화·역직렬화 연 -산 비용과 페이로드 크기를 현저히 절감하여, 동적으로 생성·소멸하는 다수의 서브에이전트와 오케스트레이터 간에 폭증하는 제어 메시지를 메모리 효율적으로 처리할' + last_visible_status_at_termination: ' grpcT1Client=표준 grpc.ClientConn)으로 명확히 분리되어, "권장 구현 (a)"가 실제로 코드에 반영되었습니다. > [!IMPORTANT] 구조적 제약 규정으로 회귀 방지 장치까지 명문화한 점도 적절합니다. - 부수적으로, TCP 폴백 분기의 grpc.WithTransportCredentials(insecure.NewCredentials()) 전환은 다이얼러 내부에서 이미 수행된 TLS 핸드셰이크 위에 gRPC 계층이 재차 TLS를 씌우는 이중 래핑 버그를 함께 해' + stopped_at: '2026-07-06T03:08:31Z' + stopped_at_epoch: 1783307311 + stop_reason: manual_stop + termination_mode: graceful + resumable: true - name: canary-projects-multi-agent-paper-creator-cline - status: running + status: stopped role: researcher-reviewer tmux_session_created_at: '2026-06-30T02:23:09Z' tmux_session_epoch: 1782786189 @@ -36,7 +41,7 @@ tmux_sessions: delegate_job_id: null pane: index: 0 - pid: 25041 + pid: 30678 cmd: cline cmd_full: cline -i --id 1782786184987_wcllh cwd: /Users/godopu16/PuKi/lab/canary_projects/multi-agent-paper @@ -45,5 +50,39 @@ tmux_sessions: kill_command: tmux -L multi-agent-paper kill-session -t canary-projects-multi-agent-paper-creator-cline child_pid: 0 cline_conversation_id_own: 1782786184987_wcllh - last_visible_status: resumed conversation 1782786184987_wcllh at 2026-07-06T00:54:45Z - last_visible_status_at_termination: ' │IDL을 "명확한 계약서"에 비유 │33 │"사전에 문서로 못박아 두는 ''명확한 계약서'' 역할 ... 계약서에 서명한 양측이 조항을 재협상할 필요 없이 곧바로 거래할 수 있듯이" │✅ 정확 반영 │ ├────────────────────────────────┼───┼────────────────────────────────────' + last_visible_status: resumed conversation 1782786184987_wcllh at 2026-07-06T02:01:13Z + last_visible_status_at_termination: ' > 이번 요청 신규 검증 포인트: ⑤-1 42행 기술 스택 요약이 TransportSelector 패턴에 정합하게 업데이트(42행). ⑤-2 QUIC 경로 내 grpc.Dial 사용 금지 IMPORTANT alert(GitHub [!IMPORTANT] 블록, 566-567행)가 추가되어 naive 터널링 회귀 원천 방지 구조적 제약이 명문화되었으며, 1509행 코드 주석과 정합. ⑤-3 OTLP용 grpc. DialContext(TCP 고정 관측성 경로)가 QUIC 폴백 수정에서 정확히 제외됨을 검증' + stopped_at: '2026-07-06T03:08:39Z' + stopped_at_epoch: 1783307319 + stop_reason: manual_stop + termination_mode: graceful + resumable: true +- name: canary-projects-multi-agent-paper-creator-claude-planner + status: stopped + role: planner + tmux_session_created_at: '2026-07-06T01:51:41Z' + tmux_session_epoch: 1783302701 + tmux_server: multi-agent-paper + delegate_job_id: null + pane: + index: 0 + pid: 29301 + cmd: claude + cmd_full: claude --dangerously-skip-permissions + cwd: /Users/godopu16/PuKi/lab/canary_projects/multi-agent-paper + start_command: tmux -L multi-agent-paper new-session -d -s "canary-projects-multi-agent-paper-creator-claude-planner" -x 140 -y 40 -c "/Users/godopu16/PuKi/lab/canary_projects/multi-agent-paper" "claude --dangerously-skip-permissions" + attach_command: tmux -L multi-agent-paper attach -t canary-projects-multi-agent-paper-creator-claude-planner + kill_command: tmux -L multi-agent-paper kill-session -t canary-projects-multi-agent-paper-creator-claude-planner + tui: + model: (unknown — capture after first message) + provider: anthropic + plan: (unknown) + account: (unknown — read from claude auth status) + version: (unknown — read from TUI) + claude_session_id_own: d6eb5e41-a7a6-4c92-b6f2-4133da3a292e + last_visible_status: TUI started; awaiting first user message + stopped_at: '2026-07-06T03:08:57Z' + stopped_at_epoch: 1783307337 + stop_reason: manual_stop + termination_mode: graceful + resumable: true diff --git a/Planning.md b/Planning.md deleted file mode 100644 index f2fb37d..0000000 --- a/Planning.md +++ /dev/null @@ -1,14 +0,0 @@ -# gRPC 기반 Multi-Agent 인터페이스 연구 사용사례 - -## 목적 -이기종 환경에서 동작하는 Multi-agent 서비스를 위한 gRPC 기반 인터페이스 모듈 설계/개발 연구 논문 작성용. -- 연구의 필요성 및 연구 개발 내용의 방향을 설립하기 위함 - -## 요구사항 -- agy와 claude 각각 1개의 agent를 생성함. -- 각 agent는 3개의 sub-agent를 spawn 함 (개발자, AI 에이전트 관리자, 자료분석가) -- 각 에이전트는 자료분석 sub-agent를 통해 현재 multi-agent 가 사용되는 사례, 각 에이전트 간 통신 기술의 background를 조사하고, 개발자와 AI 에이전트 관리자 sub-agent를 통해 각자의 입장에서 필요한 요구사항을 도출함. -- 도출된 요구사항을 만족시키기 위해 gRPC를 어떻게 활용할 수 있을지 깊이 생각한 후 보고서를 작성 -- agy와 claude는 sub-agent를 통해 작성된 보고서를 최종 검토한 후 각자의 보고 내용을 서로 피드백함. -- agy가 claude에게 먼저 피드백 받은 후 claude는 자신의 보고서 내용을 반영한 수정방안을 agy에게 전달, agy가 최종 보고서를 작성한 후 claude가 한 번 더 검토를 거쳐 최종보고서를 작성함 -- 작성된 보고서를 너가 다시 한 번 더 검토하여 A4 6장 분량의 보고서를 작성해줘. \ No newline at end of file diff --git a/lecture_summary.md b/assets/slides/lecture_summary.md similarity index 100% rename from lecture_summary.md rename to assets/slides/lecture_summary.md diff --git a/remove.sh b/deploy/remove.sh similarity index 100% rename from remove.sh rename to deploy/remove.sh diff --git a/requirements.txt b/deploy/requirements.txt similarity index 100% rename from requirements.txt rename to deploy/requirements.txt diff --git a/update.sh b/deploy/update.sh similarity index 100% rename from update.sh rename to deploy/update.sh diff --git a/reviewer_prompt.txt b/reviewer_prompt.txt new file mode 100644 index 0000000..6c01a0d --- /dev/null +++ b/reviewer_prompt.txt @@ -0,0 +1,13 @@ +안녕. 너는 이 프로젝트의 Reviewer 에이전트야. +대학교 특강 소개 요약안(4-5개 불릿)에 대해 새로운 피드백이 왔어. +이전 개선안이 "너무 연구 주제스러워서 학술적"이라는 피드백이야. +이번에는 톤을 낮춰서 "기본부터 차근차근 학습하는 AI Agent"의 입문/실습 중심 주제로 다시 작성하고자 해. + +아래 가이드라인에 맞춰 너의 리뷰 의견과 대안 요약안(4-5개 불릿)을 제시해줘: + +1. **기초부터 출발**: AI 에이전트의 3대 요소(Planning, Memory, Tool Use)와 싱글 에이전트 작동 방식 등 기초적인 개념 이해부터 다루어줘. +2. **멀티 에이전트 확장**: 싱글 에이전트의 한계를 인지하고, 왜 멀티 에이전트 협업이 필요한지 설명하는 과도기적 단계를 포함해줘. +3. **핵심 실습은 간략하게**: crewAI, LangGraph 실습, ACP 실습, A2A 실습, AIoT를 위한 Multi agent 기술 동향 등 아까 언급된 핵심 실습 키워드는 복잡한 이론 연구 설명 대신 "간략한 도구 활용 실습 및 동향 소개" 수준으로 가볍게 녹여내줘. +4. **학술적 무게감 덜어내기**: 분할 정복, 순환 그래프 이론 등 과도한 연구 중심 전문 용어는 덜어내고, 직관적이고 쉽게 배울 수 있는 흐름으로 구성해줘. + +답변 양식은 자유롭게 작성하되, 최종적으로 제안하는 "기본부터 학습하는 AI Agent 특강 요약안(4-5개 불릿)"을 명확히 포함해줘. \ No newline at end of file