docs: align terminology (sensing/control layer) and update agent guidelines

This commit is contained in:
2026-07-06 10:59:08 +09:00
parent ee9ae41195
commit 2d48dc5323
5 changed files with 50 additions and 33 deletions
+7 -1
View File
@@ -166,4 +166,10 @@ TMUX 환경에서 실행되는 에이전트가 화면 스크롤 한계로 인해
### 🛡️ 4. 멱등성(Idempotency) 보장 스키마
- **물리 제어 명령의 멱등성 분류**: 인터페이스 모듈은 전달되는 제어 명령을 멱등성 보장 여부에 따라 분류해야 합니다. 정보 조회·상태 설정 등 멱등성이 자연 보장되는 명령과, 농약 투포·급수·밸브 개폐 등 부작용이 누적되어 재실행 시 치명적 안전 사고로 이어질 수 있는 비멱등성(non-idempotent) 물리 제어 명령을 명시적으로 구분해야 합니다.
- **중복 발행 억제 메커니즘**: 비동기 재시도 루프에서 동일한 제어 의도가 새로운 작업 ID로 중복 발행되는 것을 방지하기 위해, 제어 의도 식별자(Control Intent Key) 기반의 중복 억제(Deduplication) 스키마를 인터페이스 계층에 내장해야 합니다. 재시도 시 신규 작업 ID가 아닌 원본 제어 의도에 바인딩된 멱등성 키를 재사용하여 동일 제어의 재실행 가능성을 시스템 차원에서 통제해야 합니다.
- **물리 장치측 사전 검증**: 중복 제어가 물리 장치에 도달하기 전에 인터페이스 모듈이 사전 검증(pre-flight check)을 수행하여, 이미 실행된 제어 의도에 대한 재실행 요청을 사전 차단하거나 장치측 상태와 대조 후 승인하는 안전망을 제공해야 합니다.
- **물리 장치측 사전 검증**: 중복 제어가 물리 장치에 도달하기 전에 인터페이스 모듈이 사전 검증(pre-flight check)을 수행하여, 이미 실행된 제어 의도에 대한 재실행 요청을 사전 차단하거나 장치측 상태와 대조 후 승인하는 안전망을 제공해야 합니다.
### ✍️ 5. 학술 용어 및 일관성 통일 지침 (Terminology & Alignment Guidelines)
- **학술적 명확성 확보**: 논문 또는 설계 문서를 작성하거나 편집할 때, 직관적인 구어체 표현(예: '값을 나르는 계층', '행동을 시키고 확인하는 계층')의 사용을 지양하고 정식 학술 용어인 **'센싱 계층(Sensing Layer)'**과 **'제어 계층(Control Layer)'**을 사용해야 합니다.
- **센싱 계층의 정의**: 센싱 계층은 단순히 데이터를 업로드하는 단방향 전송에 그치지 않고, "온도·습도 등의 센서 값을 특정하여 edge 또는 cloud로 전송"하는 명확한 동작으로 정의하여 데이터 흐름을 정합적으로 기술합니다.
- **제어 계층의 정의**: 제어 계층은 "농약 살포"와 같이 물리 계층에 제어 명령을 내리고 그 결과를 검증/확인하는 능동적 행위 계층으로 정의합니다.
- **용어 일관성 유지**: 모든 문서(서론, 배경기술, 설계, 실험 등) 전반에 걸쳐 해당 명칭을 통일되게 사용하여 독자의 이해를 돕고 인지적 혼선을 방지해야 합니다.