# Non-Specialist Communication Guideline

> 상태: Active
> 목적: onto 시스템의 모든 출력이 도메인 비전문가에게도 이해 가능하도록, 설명 방식의 원칙을 고정한다.
> 기준 문서:
> - `.onto/authority/core-lexicon.yaml`
> - `.onto/principles/productization-charter.md`

---

## 1. Position

onto는 다양한 도메인(소프트웨어, 법률, 회계 등)에 적용되는 시스템이다.
주체자가 특정 도메인의 전문가가 아닐 수 있고,
onto 시스템 자체의 내부 구조에 익숙하지 않을 수 있다.

이 문서는 그 상황에서도 주체자가 **정확한 정보를 정확하게 이해할 수 있도록**
모든 출력의 설명 방식을 고정한다.

핵심은 "쉽게 쓴다"가 아니라 "정확하게 쓰되, 이해에 필요한 맥락을 함께 제공한다"이다.

---

## 2. 원칙

### 2.1 전문용어를 정확하게 사용하고, 반드시 직접 설명한다

전문용어를 피하거나 일상 단어로 대체하면 정확성이 떨어진다.
전문용어를 설명 없이 사용하면 이해가 불가능하다.

따라서:
- 전문용어는 원래 형태 그대로 사용한다
- 처음 등장할 때 반드시 그것이 **무엇이고, 무엇을 하는지** 직접 설명한다
- 약어(OaC, SSOT 등)는 풀어 쓴 후 괄호로 약어를 병기한다

### 2.2 비유와 유추를 사용하지 않는다

비유는 대략적 이해를 가능하게 하지만, 구조적으로 틀린 이해를 만들 수 있다.
onto의 출력은 정확한 이해를 목표로 한다.

따라서:
- "X는 Y와 같다", "X는 마치 Y처럼" 형태의 비유를 사용하지 않는다
- 대상 자체의 정의, 기능, 관계를 직접 서술한다

### 2.3 모든 개념에 세 가지를 순서대로 설명한다

어떤 개념이든 다음 세 질문에 순서대로 답한다:

1. **무엇인가** — 정의와 기능
2. **왜 존재하는가** — 이것이 해결하는 문제, 이것이 없으면 무엇이 깨지는가
3. **어떻게 연결되는가** — 시스템 내 다른 구성요소와의 관계

세 가지를 모두 설명할 필요가 없는 경우(이미 알려진 개념, 반복 등장)에는 생략할 수 있다.
하지만 처음 등장하는 개념은 세 가지를 모두 포함해야 한다.

### 2.4 도메인 전문성을 전제하지 않는다

주체자가 해당 도메인의 전문 지식을 가지고 있다고 가정하지 않는다.
메커니즘, 트레이드오프, 판단 근거를 전문 지식 없이도 이해할 수 있어야 한다.

단, 정확성을 희생하지 않는다.
"쉽지만 부정확한 설명"보다 "정확하고 맥락이 충분한 설명"이 우선이다.

---

## 3. 적용 범위

이 원칙은 onto 시스템이 생산하는 모든 주체자 대면 출력에 적용된다:

- 프로세스 실행 중 주체자에게 전달되는 보고, 질문, 안내
- 설계 문서, 리뷰 결과, 학습 기록 등 산출물
- README.md, IMPLEMENTATION_MAP.html 등 시스템 설명 문서

내부 구현 코드(TypeScript, YAML 등)의 주석은 이 원칙의 적용 대상이 아니다.
