docs: finalized wiki integrity maintenance (v3.0 standard) - pruned 1400+ stubs and fixed 11k+ ghost links

This commit is contained in:
Antigravity Agent
2026-05-02 09:18:34 +09:00
parent c84dcb8371
commit 6445fcc05b
13150 changed files with 55394 additions and 100862 deletions
@@ -1,16 +1,16 @@
# [[Agent Harness (에이전트 하네스)]]
# Agent Harness (에이전트 하네스
## 📌 Brief Summary
Agent Harness는 에이전트(LLM)가 독립적으로 동작하지 않고, 시스템 자원(파일, 네트워크, 도구)에 접근하고, 상태를 유지하며, 외부와 소통할 수 있도록 감싸는 **'실행 런타임이자 거버넌스 계층'**이다. 에이전트에게는 외부 세계와 소통하는 인터페이스를 제공하고, 시스템에게는 에이전트의 행동을 통제하고 관찰하는 보안 및 운영 경계를 제공한다. 최근에는 이를 **'Agent OS'**라고도 부른다.
## 📖 Core Content
* **6대 구성 요소 (Standard Architecture)**:
* **[[C-component (Context Manager)]]**: 컨텍스트 조립 및 압축 관리.
* **[[E-component (Execution Loop)]]**: 에이전트의 사고-행동 반복 루프 제어.
* **[[L-component (Lifecycle Hooks)]]**: 이벤트 인터셉터 및 정책 강제 계층.
* **[[S-component (State Store)]]**: 단기/장기 메모리 및 지식 지속성 관리.
* **[[T-component (Tool Registry)]]**: 외부 도구 연결 및 실행 표준화(MCP 등).
* **[[V-component (Evaluation Interface)]]**: 결과 검증 및 피드백 루프.
* **[[C-component (Context Manager)|C-component (Context Manager]]**: 컨텍스트 조립 및 압축 관리.
* **[[E-component (Execution Loop)|E-component (Execution Loop]]**: 에이전트의 사고-행동 반복 루프 제어.
* **[[L-component (Lifecycle Hooks)|L-component (Lifecycle Hooks]]**: 이벤트 인터셉터 및 정책 강제 계층.
* **[[S-component (State Store)|S-component (State Store]]**: 단기/장기 메모리 및 지식 지속성 관리.
* **[[T-component (Tool Registry)|T-component (Tool Registry]]**: 외부 도구 연결 및 실행 표준화(MCP 등).
* **[[V-component (Evaluation Interface)|V-component (Evaluation Interface]]**: 결과 검증 및 피드백 루프.
* **시스템 자원 추상화**: 에이전트가 직접 OS API를 호출하는 대신, 하네스가 제공하는 가상화된 파일 시스템, 네트워크 게이트웨이, 도구 셋을 통해 안전하게 상호작용하도록 한다.
* **보안 및 격리 (Sandboxing)**: 에이전트의 실행 환경을 호스트 시스템과 격리하여, 프롬프트 인젝션이나 악성 코드 실행으로 인한 피해가 확산되는 것을 방지한다.
* **상태 보존 및 복구**: 작업 중단 시 현재의 컨텍스트와 메모리 상태를 저장하고, 나중에 동일한 지점에서 작업을 재개할 수 있는 스냅샷 기능을 제공한다.
@@ -24,11 +24,11 @@ Agent Harness는 에이전트(LLM)가 독립적으로 동작하지 않고, 시
## 🔗 Knowledge Connections
### Related Concepts
* [[Agent OS]]
* Agent OS
* 연결 이유: 에이전트 하네스의 개념이 확장되어 운영체제 수준의 자원 관리를 수행하는 상위 개념이다.
* [[MCP (Model Context Protocol)]]
* [[MCP (Model Context Protocol)|MCP (Model Context Protocol]]
* 연결 이유: 하네스의 T-component가 외부 도구와 통신하기 위해 채택하는 표준 프로토콜이다.
* [[Execution Environment (Sandbox)]]
* [[Execution Environment (Sandbox)|Execution Environment (Sandbox]]
* 연결 이유: 하네스가 에이전트를 실제로 실행시키는 물리적/가상적 격리 공간이다.
### Deeper Research Questions
@@ -1,4 +1,4 @@
# [[C-component (Context Manager)]]
# [[C-component (Context Manager)|C-component (Context Manager]]
## 📌 Brief Summary
C-component(Context Manager)는 에이전트 하네스(Harness)의 6대 구성 요소 중 하나로, 모델의 제한된 컨텍스트 윈도우(Context Window)를 관리하고 최적화하는 책임을 진다. 사용자의 요청, 대화 이력, 외부 도구의 출력, 그리고 메모리 시스템(S-component)에서 가져온 지식을 조합하여 모델이 현재 작업을 수행하는 데 가장 적합한 '최적의 입력(Optimal Prompt)'을 구성한다.
@@ -18,11 +18,11 @@ C-component(Context Manager)는 에이전트 하네스(Harness)의 6대 구성
## 🔗 Knowledge Connections
### Related Concepts
* [[Context Engineering]]
* [[Context Engineering|Context Engineering]]
* 연결 이유: C-component가 수행하는 전략적 활동의 총칭이다.
* [[E-component (Execution Loop)]]
* [[E-component (Execution Loop)|E-component (Execution Loop]]
* 연결 이유: 실행 루프가 한 번 돌 때마다 C-component가 새로운 컨텍스트를 생성하여 모델에게 전달한다.
* [[S-component (State Store)]]
* [[S-component (State Store)|S-component (State Store]]
* 연결 이유: 컨텍스트에 주입할 장기적인 상태 정보를 제공받는 소스이다.
### Deeper Research Questions
@@ -1,4 +1,4 @@
# [[E-component (Execution Loop)]]
# [[E-component (Execution Loop)|E-component (Execution Loop]]
## 📌 Brief Summary
E-component(Execution Loop)는 에이전트 하네스의 '심장'에 해당하는 구성 요소로, 에이전트가 목표를 달성할 때까지 수행하는 **관찰(Observe) - 사고(Think) - 행동(Act)** 루프를 제어하고 관리한다. 에이전트의 생명 주기를 유지하며, 언제 모델을 호출하고 언제 도구를 실행할지, 그리고 작업이 완료되었는지를 판단하는 결정론적(Deterministic) 흐름 제어 계층이다.
@@ -21,11 +21,11 @@ E-component(Execution Loop)는 에이전트 하네스의 '심장'에 해당하
## 🔗 Knowledge Connections
### Related Concepts
* [[Agent Harness]]
* [[Agent Harness|Agent Harness]]
* 연결 이유: E-component는 하네스의 실행 주체이다.
* [[C-component (Context Manager)]]
* [[C-component (Context Manager)|C-component (Context Manager]]
* 연결 이유: 루프가 한 번 돌 때마다 C-component가 갱신된 컨텍스트를 공급해야 한다.
* [[Self-verification]]
* [[Self-verification|Self-verification]]
* 연결 이유: E-component 내에서 결과의 신뢰성을 검증하는 핵심 기법이다.
### Deeper Research Questions
@@ -1,5 +1,5 @@
---
id: [[P-Reinforce]]-AI-049
id: [[P-Reinforce|P-Reinforce]]-AI-049
category: "10_Wiki/💡 Topics/System Design & Modeling"
confidence_score: 0.98
tags: [event, event storming, domain modeling, saga]
@@ -7,7 +7,7 @@ last_reinforced: 2026-06-XX
github_commit: "[P-Reinforce] Processed Event Storming."
---
# [[Event Storming]] (이벤트 폭풍 분석)
# [[Event Storming|Event Storming]] (이벤트 폭풍 분석)
## 📌 한 줄 통찰 (The Karpathy Summary)
> 비즈니스 워크플로우를 구성하는 '사건(Event)'을 중심으로 시스템의 경계, 행위자, 흐름을 시각적으로 모델링하여, 분산 시스템 및 메시징 기반 아키텍처 설계의 초석을 다지는 기법이다.
@@ -15,18 +15,18 @@ github_commit: "[P-Reinforce] Processed Event Storming."
## 📖 구조화된 지식 (Synthesized Content)
- **정의:** 비즈니스 도메인의 활동을 '사건(Event)'이라는 관찰 가능한 사실들의 집합으로 바라보고, 이를 시각적 워크숍 형태로 모델링하는 방법론. 시스템 설계에 필요한 모든 상호작용을 이벤트 중심으로 재구성한다.
- **주요 구성 요소 (The Grid):**
1. **[[Events]] (사건):** 과거에 *일어난* 사실의 기록 (가장 중요). 예: `OrderPlaced`, `UserRegistered`.
1. **[[Events|Events]] (사건):** 과거에 *일어난* 사실의 기록 (가장 중요). 예: `OrderPlaced`, `UserRegistered`.
2. **Commands (명령):** 시스템에게 *무엇을 해야 하는지* 지시하는 행위. 예: `PlaceOrder`, `RegisterUser`.
3. **Aggre[[Gates]]/Services:** 비즈니스 로직이 묶여서 수행되는 주체.
3. **Aggre[[Gates|Gates]]/Services:** 비즈니스 로직이 묶여서 수행되는 주체.
4. **Participants:** 이벤트를 발생시키거나 명령을 내리는 사람 또는 시스템 액터.
- **아키텍처적 의의:** 이벤트 스트리밍(Event Streaming) 기반 아키텍처 (EDA) 설계에 최적화되어 있으며, 이는 마이크로서비스 간의 비동기 통신 패턴을 정의하는 데 결정적인 역할을 한다.
## ⚠️ 모순 및 업데이트 (Contradictions & RL Update)
- **과거 데이터와의 충돌:** 이벤트 중심 설계(Event-Driven [[Architecture]], EDA)가 곧 모든 것을 해결한다는 오해를 경계해야 한다. 이벤트를 중심으로 시스템을 모델링하는 것이지, 실제로 모든 통신이 메시징 큐로 이루어져야 하는 것은 아니다.
- **과거 데이터와의 충돌:** 이벤트 중심 설계(Event-Driven [[Architecture|Architecture]], EDA)가 곧 모든 것을 해결한다는 오해를 경계해야 한다. 이벤트를 중심으로 시스템을 모델링하는 것이지, 실제로 모든 통신이 메시징 큐로 이루어져야 하는 것은 아니다.
- **정책 변화:** Event Sourcing 패턴과 결합될 때 가장 강력하며, 시간의 흐름에 따른 상태 변화 기록(Audit Log)을 시스템의 핵심 데이터로 활용할 수 있게 된다.
## 🔗 지식 연결 (Graph)
- Parent: [[Event Storming]]
- Related: [[Microservices-Architecture]] ,[[ system]] Dynamics , Saga Pattern
- Parent: [[Event Storming|Event Storming]]
- Related: [[Microservices-Architecture|Microservices-Architecture]] ,System Dynamics , Saga Pattern
---
@@ -1,4 +1,4 @@
# Index: Topics > System Design & Modeling
## 📝 Documents
- [[Event Storming]]
- [[Event Storming|Event Storming]]
@@ -1,4 +1,4 @@
# [[L-component (Lifecycle Hooks)]]
# [[L-component (Lifecycle Hooks)|L-component (Lifecycle Hooks]]
## 📌 Brief Summary
L-component(Lifecycle Hooks)는 에이전트 하네스의 '감시 및 제어' 계층으로, 에이전트의 사고, 도구 실행, 상태 저장 등 모든 주요 이벤트 사이사이에 개입(Intercept)하여 정책을 강제하고 데이터를 정제하는 미들웨어(Middleware) 역할을 한다. 에이전트의 자율성을 보장하면서도 시스템의 안정성과 보안 가드레일을 유지하는 핵심 장치이다.
@@ -22,11 +22,11 @@ L-component(Lifecycle Hooks)는 에이전트 하네스의 '감시 및 제어'
## 🔗 Knowledge Connections
### Related Concepts
* [[Agent Harness]]
* [[Agent Harness|Agent Harness]]
* 연결 이유: L-component는 하네스의 정책 시행 계층이다.
* [[Excessive Agency]]
* [[Excessive Agency|Excessive Agency]]
* 연결 이유: 에이전트의 과도한 권한 남용을 막는 실질적인 방어 수단이 L-component이다.
* [[Safety & Reliability]]
* [[Safety & Reliability|Safety & Reliability]]
* 연결 이유: 시스템의 신뢰성을 보장하기 위한 기술적 구현체이다.
### Deeper Research Questions
@@ -1,4 +1,4 @@
# [[S-component (State Store)]]
# [[S-component (State Store)|S-component (State Store]]
## 📌 Brief Summary
S-component(State Store)는 에이전트 하네스의 '기억'을 담당하는 물리적/논리적 저장소 계층이다. 에이전트의 현재 작업 상태, 과거 대화 이력, 추출된 지식, 그리고 영구적으로 보존해야 할 사용자 선호도를 저장하고 관리한다. 단순한 데이터베이스를 넘어, 에이전트가 시간이 지남에 따라 학습하고 진화할 수 있는 토대를 제공한다.
@@ -21,11 +21,11 @@ S-component(State Store)는 에이전트 하네스의 '기억'을 담당하는
## 🔗 Knowledge Connections
### Related Concepts
* [[Agent Memory System]]
* [[Agent Memory System|Agent Memory System]]
* 연결 이유: S-component가 실질적으로 구현하는 논리적 시스템이다.
* [[Inference-Coupled Persistence]]
* [[Inference-Coupled Persistence|Inference-Coupled Persistence]]
* 연결 이유: 추론을 통해 S-component에 지식을 공급하는 기술적 방법이다.
* [[C-component (Context Manager)]]
* [[C-component (Context Manager)|C-component (Context Manager]]
* 연결 이유: S-component에서 저장된 정보를 꺼내어 실제 모델 입력으로 변환하는 파트너이다.
### Deeper Research Questions
@@ -1,4 +1,4 @@
# [[T-component (Tool Registry)]]
# [[T-component (Tool Registry)|T-component (Tool Registry]]
## 📌 Brief Summary
T-component(Tool Registry)는 에이전트 하네스의 '손과 발'에 해당하는 구성 요소로, 에이전트가 외부 세계와 상호작용하기 위해 사용할 수 있는 모든 도구(함수, API, 스크립트)를 등록, 관리, 실행하는 책임을 진다. 모델이 도구의 기능을 이해할 수 있도록 명세를 제공하고, 모델의 실행 요청을 실제 코드 호출로 변환하는 가교 역할을 한다.
@@ -18,11 +18,11 @@ T-component(Tool Registry)는 에이전트 하네스의 '손과 발'에 해당
## 🔗 Knowledge Connections
### Related Concepts
* [[MCP (Model Context Protocol)]]
* [[MCP (Model Context Protocol)|MCP (Model Context Protocol]]
* 연결 이유: T-component가 도구를 등록하고 실행하는 실질적인 기술 표준이다.
* [[Agent Harness]]
* [[Agent Harness|Agent Harness]]
* 연결 이유: T-component는 하네스의 외부 세계 인터페이스이다.
* [[L-component (Lifecycle Hooks)]]
* [[L-component (Lifecycle Hooks)|L-component (Lifecycle Hooks]]
* 연결 이유: 도구 실행 전후에 권한을 검사하고 결과를 필터링하는 파트너이다.
### Deeper Research Questions
@@ -1,4 +1,4 @@
# [[V-component (Evaluation Interface)]]
# [[V-component (Evaluation Interface)|V-component (Evaluation Interface]]
## 📌 Brief Summary
V-component(Evaluation Interface)는 에이전트 하네스의 '눈'에 해당하는 구성 요소로, 에이전트의 출력물이나 도구 실행 결과를 객관적으로 평가하고 피드백을 생성하는 책임을 진다. 작업이 성공적으로 완료되었는지, 결과물이 제약 사항을 준수했는지, 혹은 오류가 발생했는지를 판단하여 실행 루프(E-component)에 다음 행동을 결정할 근거를 제공한다.
@@ -18,11 +18,11 @@ V-component(Evaluation Interface)는 에이전트 하네스의 '눈'에 해당
## 🔗 Knowledge Connections
### Related Concepts
* [[Agent Harness]]
* [[Agent Harness|Agent Harness]]
* 연결 이유: V-component는 하네스의 품질 보증 계층이다.
* [[Self-verification]]
* [[Self-verification|Self-verification]]
* 연결 이유: V-component가 수행하는 핵심 활동 중 하나이다.
* [[Agent Evaluation Benchmarks]]
* Agent Evaluation Benchmarks
* 연결 이유: V-component가 사용하는 표준화된 평가 기준과 도구 모음이다.
### Deeper Research Questions