요약

에이전트 시스템을 4계층 으로 분리: (1) SDK & 프레임워크 → (2) 스캐폴딩 → (3) 하네스 → (4) 에이전트. 3계층 하네스가 전체 수명 주기를 제어 해 에이전트가 추론에만 집중 할 수 있게 한다. Martin Fowler 의 표현 — "에이전트를 프로덕션에서 작동하게 하는 숨겨진 아키텍처 계층."

상세

4계층 아키텍처

term/feedforward-sensor — 하네스 통제의 두 방향

가이드 (Feedforward) — 행동 전
  → 설계 원칙·코딩 컨벤션을 에이전트에 사전 주입
  → 올바른 코드를 작성할 확률 상승

센서 (Feedback) — 행동 후
  → 에이전트 출력 관찰
  → 커스텀 린터 메시지로 자가 오류 교정 유도

계획 vs 구현 분리 + term/repository-impact-map

Phase 1: 계획 (Planning)
   → 리포지토리 심볼 분석
   → 저장소 영향 지도(Repository Impact Map) 생성
   → 3줄짜리 영향 지도에서 잘못된 참조 즉시 발견
   ↓
[인간 검토 체크포인트] ← 필수
   ↓
Phase 2: 구현 (Implementation)
   → 실제 파일 경로·심볼 기반 코드 생성
   → 환각 없는 구조적 출력 보장

비용 차이: 3줄 영향 지도 수정 = 저비용 / 수천 줄 PR 의 구조적 결함 = 극고비용.

구조화 입출력 원칙

"Vague in → Vague out / Structure in → Structure out."

하네스가 제공해야 할 구조: 파일 경로 (정확) / 심볼 이름 (실제 존재) / 기존 코드 패턴.

term/architecture-fitness-harness (entity/martin-fowler)

• 성능 요구사항·로깅 표준 등 구조적 특성을 위반하지 않도록 지속적 압력
• 인간 개발자의 경험을 시스템에 외재화

방법론

강의 진행 시퀀스 (7분):

1. 4계층 표 (3분): 한 슬라이드 — 청중이 각 계층의 역할 분리 를 한 번에 인식.
2. 하네스 = 운영 체제 비유 (1분): 에이전트 = 앱, 하네스 = OS.
3. 가이드 vs 센서 (1분): 행동 전 / 행동 후 두 방향 통제.
4. 저장소 영향 지도 (1분): 3줄 영향 지도의 ROI.
5. 연결 (1분): "이걸 실제 도구 로 만든 게 lesson/hrn-superpowers-framework 입니다."

주의사항

• 계층 추상화의 부담: 청중에게 4계층 이 학술적 — 매 계층마다 친숙한 비유 (OS, 보일러플레이트 등) 함께 제시.
• 하네스 어원: 말 안장의 끈 / 낙하산 끈 — 자유롭게 움직이게 하면서도 떨어지지 않게 잡아주는 의미. 짧게 부연.
• Martin Fowler 권위: 청중이 Fowler 가 누군지 모를 수 있음 → Refactoring·Patterns of Enterprise Application Architecture 저자 짧은 부연.
• 본 단원의 위치: HRN 의 입구 — 추상 표를 먼저 보여주고 lesson/hrn-superpowers-framework 에서 구체 로 들어간다.

표어 정합

본 단원의 4 계층 아키텍처 가 강의 표어 "AI-Native Vibe Coding: No Design, No Code" 의 시스템 형태 다. 설계 없이는 코딩이 안된다 (Thesis) 의 Design 이 어디에 박히는가 — 3 계층 (하네스) 자리. AI 에게 어떻게 일을 시키는가 (Corollary) 가 4 계층 운영체제 의 모양으로 외재화된다.