기록일: 2026-10-12 · 1개월차 2주차 근거: 대화형 학습에서 확인된 판단을 사후 정리한 기록. 실제 구현·실험 완료 보고가 아니다. 2주차 학습계획
Human·Agent·Knowledge·Workflow의 책임과 계약을 어떻게 나누면 변경 영향과 오작동을 줄이면서 Agent의 유연성을 유지할 수 있는가?
| 주제 | 확인된 판단 |
|---|---|
| Knowledge와 원천 정보 | Email은 지식의 출처다. 단순 복사뿐 아니라 인식한 사실·정보를 다루되 원천과 근거를 유지한다. 오래된 버전으로 현재 사실을 추정하지 않는다. |
| Adapter와 validator | Email adapter가 외부 응답 schema의 변경을 감지하고 validator가 계약을 확인한다. provider 변경의 영향을 내부로 무제한 전파하지 않도록 경계를 둔다. |
| 날짜의 맥락 | 메일의 ’오늘’은 발송 시점이 기준일 수 있다. 수신 시점과 구분하고 근거·기준 시점을 확인한다. 확정되지 않은 날짜를 확정값으로 전달하지 않는다. |
| 논리·물리 구조 | 역할이 분리됐다는 이유만으로 별도 서비스가 되지는 않는다. 독립적으로 운영되는 실행 단위와 운영 조건을 고려해 container 경계를 결정한다. 외부 provider는 내부 API container와 구분한다. |
| 상태와 검증 | validation status를 명시한다. 새 관찰로 기존 run_state의 근거가 대체되거나 뒷받침되지 않으면 현재 유효성을 다시 판단한다. Agent와 Workflow 사이의 상태 조정은 orchestration에서 다룬다. |
| 정책과 계획 | 최소 조건은 deterministic policy로 검사하고 planner는 허용된 선택 안에서 계획한다. 계획·검증·상태 조정의 책임을 구분한다. |
| 업무시간과 buffer | 최소 여유뿐 아니라 담당자의 검토·확인, 회의 준비·이동 등 후속 활동을 고려한다. 단일 고정 buffer로 실제 필요를 모두 표현하지 않는다. |
숫자·선택지 답변만 남은 부분은 질문 맥락이 없으므로 구체적인 설계 결정으로 복원하지 않는다. 독립 운영 container 판단도 모든 논리 component를 별도 서비스로 나누라는 요구가 아니다.
경계마다 책임·소유 상태·입출력·금지 의존성을 정의한다. 전달 결과에는 출처, 자료 버전, 기준 시점, validation status를 포함한다. 외부 adapter는 provider 응답 변화와 내부 계약 변환을 담당하고 validator는 계약·최소 조건을 확인한다. Orchestrator는 관찰과 검증 상태에 따라 planner의 재계획을 조정한다.
이는 학습에서 도출한 설계안이며 실제 House 구현과 일치하는지는 코드로 별도 확인해야 한다.
책임과 계약을 명시하면 schema/provider 변화의 영향 범위와 모호한 ownership을 줄일 수 있다는 가설을 세운다. 경계별 소유자·계약, 변경 영향, 원천 및 버전 보존, 검증 상태 전달을 평가 대상으로 삼는다. 성능 개선이나 영향 반경 감소를 이미 측정했다는 의미는 아니다.
대화에서 확인된 개념·설계 판단을 기록했다. C4 그림 작성 요청은 있었지만 이 기록만으로 결과 파일의 정확성·완성을 인증하지 않는다. YAML manifest, validator, 주입 오류 테스트, 12개 변경 시나리오 CSV, change radius 실측, 교재·논문 완독은 이 대화에서 확인되지 않았다.
학습 운영상 미진행분은 완료 처리하고 다음 주로 이월하지 않는다. 이 원칙과 실제 구현·측정의 증거 상태는 별개다. 이 리포트는 보충 과제나 추가 시간을 배정하지 않는다.
결론: 경계는 역할 이름만으로 분리되는 것이 아니라 책임·상태·원천·검증 계약과 운영 조건을 통해 정의하고, 변경 시 영향받는 범위를 확인해야 한다.
저장소 원본 · 공개 사본 갱신: 2026-10-12