# Clipwise World DSL·ESTC 에이전트 가이드

> 버전 2026-11-11. 이 글을 읽은 에이전트는 업무 규칙 질문을 이 개념으로 답하고, 업무 세계(World DSL) 초안을 만들고, 승인된 ESTC 기록을 읽을 수 있습니다. 판정은 Clipwise 엔진이 하고 에이전트는 제안만 합니다.

절: concepts(핵심 개념) · world(정의 형식) · conditions(조건식) · judge(판정) · apply(적용 절차) · example(환불 예시) · tools(MCP 도구)

## 1. 핵심 개념

| 용어 | 한 줄 정의 | 답하는 질문 |
|---|---|---|
| 온톨로지 | 업무 세계에 있는 대상과 용어 | 무엇이 있는가 |
| World DSL (업무 세계) | 그 용어로 무엇이 허용되는지 기계가 판정할 수 있게 고정한 규칙 | 무엇이 허용되는가 |
| 에이전트 | 자연어 요청을 세계의 어휘로 옮겨 행동을 제안하는 주체 | 지금 무엇을 하려는가 |

ESTC는 업무 세계를 이루는 네 가지입니다.

- **Entity (대상)**: 추적할 것. 예: 할 일, 결정, 환불 요청. 세계에 없는 대상은 만들지 않습니다.
- **State (단계)**: 대상의 지금 상태. 대상마다 허용 목록이 있습니다. 예: 접수 → 검토 → 승인 → 완료.
- **Transition (변화)**: 허용된 `from → to` 이동. 이름(action)과 확인할 규칙(guards), 자율도(autonomy)가 붙습니다.
- **Constraint (규칙)**: 근거·담당자·기한·금액 같은 조건. 원문 정책 문장(rule)과 기계가 계산하는 조건(check)을 함께 둡니다.

세 층으로 나뉩니다.

```text
[에이전트 층]  의도 해석 · 사실 추출 · 설명        ← 확률적, 제안만
     ↓ 제안 (대상 · 변화 이름 · 사실 + 근거)
[World 엔진]   어휘 확인 · 조건 판정 · 자율도      ← 결정적 코드, 같은 입력이면 같은 결과
     ↓ 허가된 변화만
[실행 층]      사람 확인 · 저장 · 감사 기록
```

지킬 원칙:

1. 에이전트는 판정하지 않습니다. 의도·사실·설명만 만듭니다. "80만 원이니 소액"이라고 말해도 엔진은 `amount <= 1000000`만 봅니다.
2. 세계에 없는 대상·단계·변화는 실행할 수 없습니다(UNKNOWN_VOCAB).
3. 원문에 없는 값(담당자·기한·금액)은 추측하지 않습니다. 값이 없으면 NEED_FACT로 사람에게 묻습니다.
4. 시스템·기록에서 확인한 값과 에이전트가 대화에서 뽑은 값은 같은 신뢰가 아닙니다. 에이전트 값이 쓰이면 사람 확인(REVIEW)이 됩니다.
5. 조건은 구조화 JSON으로만 씁니다. 문자열 식을 실행(eval)하지 않습니다.
6. 진행 중인 건은 시작한 세계 버전으로 끝냅니다. 활성 세계는 workspace당 하나입니다.
7. 처음에는 모든 변화를 `confirm` 이상으로 둡니다. `auto`는 시뮬레이션 일치율이 기준을 넘은 변화에만 씁니다.

## 2. World DSL 정의 형식

정의는 JSON 하나입니다. 키는 영문 snake_case, 화면 이름은 `label`·`stateLabels`·`actionLabel`에 한국어로 둡니다. 단계 이름을 바꿀 때는 키를 그대로 두고 `stateLabels`만 바꿉니다(저장된 기록이 깨지지 않게).

| 위치 | 키 | 뜻 |
|---|---|---|
| `entities[]` | `type`, `label`, `fields` | 대상 키, 한국어 이름, 항목 키 목록 |
| `entities[]` | `fieldTypes` | 항목 종류: `text`, `person`, `date`, `datetime`, `number`, `money`, `boolean`, 또는 `{ "enum": [...] }` |
| `entities[]` | `fieldSources` | 값의 출처: `system`(시스템이 확인), `record`(기록에 있음), `llm_extract`(대화에서 뽑음), `user`(담당자가 입력). 기본 `record` |
| `entities[]` | `derived` | 계산값: `days_between`, `hours_between`, `count`, `is_empty` |
| `states` | `{ 대상: [단계 키...] }` | 대상별 허용 단계. 첫 단계가 시작 단계 |
| `stateLabels` | `{ 대상: { 단계 키: 이름 } }` | 단계 한국어 이름 |
| `transitions[]` | `entity`, `from`, `to`, `when` | 허용된 이동과 "이럴 때" 설명 |
| `transitions[]` | `action`, `actionLabel` | 에이전트가 부르는 변화 이름(대상 안에서 중복 금지)과 한국어 이름 |
| `transitions[]` | `guards` | 이 변화에서 확인할 `kind: "guard"` 규칙 id 목록 |
| `transitions[]` | `autonomy` | `auto`(바로 처리), `confirm`(담당자가 네), `approve`(결재), `human_only`(사람만). 기본 `confirm` |
| `transitions[]` | `actorRole`, `evidence`, `effect` | 확정하는 역할, 규정 문서 앵커, 실행 도구(허용 목록: `billing.partial_refund`) |
| `constraints[]` | `id`, `rule`, `required` | 규칙 id, 원문 정책 문장, 켜짐 여부 |
| `constraints[]` | `entity` | 없으면 모든 대상 공통, 있으면 그 대상 전용 |
| `constraints[]` | `kind`, `check`, `onMissing` | `record`(기록에 늘 적용, 기본) 또는 `guard`(지정한 변화에서만), 구조화 조건, 값이 없을 때 `need_fact`(기본) 또는 `deny` |
| `settings` | `timezone`, `calendar`, `reviewEveryDays` | 날짜 기준(기본 `Asia/Seoul`, `calendar` 또는 `business`), 규칙 재검토 주기 |

내장 규칙 `source_required`는 조건을 쓰지 않아도 "근거 구절 1개 이상, 없으면 거절"로 판정합니다. 모든 세계에 켜 두세요.

저장할 때 거절되는 정의(오류):

- 대상이 없음, 대상·단계 키 중복, 단계가 없는 대상
- 없는 대상·단계를 가리키는 변화, 같은 대상 안 `action` 중복
- 없는 규칙을 가리키는 `guards`, 다른 대상의 guard 규칙
- `check` 형식 오류, 대상에 없는 항목·계산값 참조, 종류가 다른 값 비교, 조건 상한 초과
- 알 수 없는 `settings.timezone`

경고(저장은 됨): 어떤 변화와도 이어지지 않은 단계, "이럴 때" 설명 없는 변화, 쓰이지 않는 guard 규칙, 켜진 필수 규칙 없음.

## 3. 조건식 (check)

조건은 아래 모양만 씁니다. 깊이 4, 조각 32개까지입니다.

| 모양 | 뜻 |
|---|---|
| `{ "all": [조건...] }` / `{ "any": [조건...] }` / `{ "not": 조건 }` | 그리고 / 또는 / 아님 |
| `{ "cmp": "==" \| "!=" \| "<" \| "<=" \| ">" \| ">=", "left": 값, "right": 값 }` | 비교 |
| `{ "exists": 값 }` / `{ "empty": 값 }` | 값이 있음 / 비어 있음 |
| `{ "in": 값, "values": [...] }` | 목록 중 하나 |
| `{ "timeOfDay": { "from": "23:00", "to": "07:00", "at"?: 값 } }` | 하루 중 시각이 구간 안. `from` > `to`면 자정을 넘는 구간. `at`이 없으면 판정 기준 시각을 씁니다 |

`timeOfDay`는 세계 `settings.timezone`의 지역 시각으로 봅니다. `HH:MM`(24시간)만 받고, 경계는 양끝을 포함합니다. `from`과 `to`가 같으면 그 시각 한 점입니다. `at`에 항목 시각(`datetime`)을 주면 그 값의 시각으로 판정하고, 값이 없으면 NEED_FACT가 됩니다.

값(ValueRef)은 `{ "field": "항목 키" }`, `{ "derived": "계산값 키" }`, `{ "meta": "state" | "evidence_count" | "confidence" }`, `{ "now": true }`, `{ "value": 상수 }` 중 하나입니다. `op`·`const` 같은 다른 이름은 형식 오류입니다.

조건은 3값 논리(참·거짓·모름)로 계산합니다. 필요한 값이 없으면 모름이고, 규칙의 `onMissing`에 따라 NEED_FACT 또는 DENY가 됩니다. `empty`만 값 없음을 참으로 봅니다.

예: 금액 100만 원 이하이고 배송 후 7일 이내

```json
{
  "all": [
    {
      "cmp": "<=",
      "left": {
        "field": "amount"
      },
      "right": {
        "value": 1000000
      }
    },
    {
      "cmp": "<=",
      "left": {
        "derived": "days_since_delivery"
      },
      "right": {
        "value": 7
      }
    }
  ]
}
```

계산값 `days_since_delivery`는 대상의 `derived`에 선언합니다(`delivered_at`은 `fields`에 있어야 합니다).

```json
{
  "key": "days_since_delivery",
  "label": "배송 후 지난 날",
  "fn": "days_between",
  "args": [
    {
      "field": "delivered_at"
    },
    {
      "now": true
    }
  ],
  "calendar": "calendar"
}
```

## 4. 판정

엔진 입력: 세계 정의, 대상(entity), 현재 단계(currentState), 요청(변화 이름 `action` 또는 목표 단계 `to`, 또는 기록 자체 점검), 사실(facts: `{ 항목: { value, source: "record" | "agent" | "human", evidence } }`), 근거 구절 수, confidence(`stated` 원문에 있음 / `inferred` 추론), 기준 시각 now. 엔진은 DB·네트워크·현재 시각을 직접 읽지 않습니다.

| 판정 | 코드 | 뜻 | 에이전트가 할 일 |
|---|---|---|---|
| ALLOW | OK | 조건 통과 | 자율도에 따라 확인·결재를 요청합니다. `auto`가 아니면 스스로 확정하지 않습니다 |
| REVIEW | HUMAN_CHECK_REQUIRED, AGENT_FACT_UNVERIFIED, INFERRED_RECORD | 사람 확인 필요(사람만 판단하는 규칙, 에이전트가 뽑은 값 사용, 추론 기록) | 쓰인 값과 근거를 보여 주고 담당자 확인을 받습니다 |
| NEED_FACT | FACT_MISSING | 판정에 필요한 값이 없음 | 빠진 항목을 사용자에게 묻습니다. 추측해 채우지 않습니다 |
| DENY | TRANSITION_NOT_ALLOWED, CONSTRAINT_FAILED, INVALID_INPUT | 지금 단계에서 갈 수 없거나 규칙 위반 | 막힌 규칙 문장과 지금 가능한 변화를 안내합니다 |
| UNKNOWN_VOCAB | UNKNOWN_ENTITY, UNKNOWN_STATE, UNKNOWN_ACTION, UNKNOWN_FIELD | 세계에 없는 말 | `estc_world`의 이름으로 다시 매핑합니다. 새 대상·단계를 만들지 않습니다 |

여러 규칙이 걸리면 실패 > 값 없음 > 사람 확인·에이전트 값·추론 기록 > 허용 순으로 하나를 고릅니다.

판정과 자율도를 합친 화면 결과:

| 판정 | `auto` | `confirm` | `approve` | `human_only` |
|---|---|---|---|---|
| ALLOW | 바로 처리 | 확인 필요 | 결재 필요 | 안내만 |
| REVIEW | 확인 필요 | 확인 필요 | 확인 필요 | 확인 필요 |
| NEED_FACT | 정보 필요 | 정보 필요 | 정보 필요 | 정보 필요 |
| DENY | 불가 | 불가 | 불가 | 불가 |
| UNKNOWN_VOCAB | 불가 | 불가 | 불가 | 불가 |

## 5. 에이전트 적용 절차

### A. 기록을 묻는 질문 ("이 할 일 어디까지 됐어?", "확정된 결정 알려줘")

1. `estc_world`로 활성 세계의 대상·단계 이름을 확인합니다.
2. 사용자의 말을 세계의 키로 옮깁니다. 예: "끝난 할 일" → `entity: "action_item"`, `state: "completed"`.
3. `estc_context`로 거릅니다. 세계에 없는 키를 넣으면 허용 값 목록과 함께 거절되니 그 목록으로 다시 고릅니다.
4. 답에는 단계의 한국어 이름, 근거 구절, 원본 제목을 함께 씁니다. 기록이 없으면 없다고 답합니다.

### B. 상태를 바꿔 달라는 요청 ("환불 승인해 줘", "이 일 완료로 바꿔")

1. 요청을 `{ 대상, 현재 단계, 변화 이름(action), 사실 }`으로 옮깁니다. 변화 이름은 `estc_world`의 변화에서만 고릅니다.
2. 현재 단계에서 그 변화가 허용되는지 봅니다. 없으면 지금 가능한 변화를 안내합니다.
3. 변화의 guard 규칙이 쓰는 항목을 확인하고, 값마다 출처(기록·시스템·사용자·대화)를 밝힙니다. 없는 값은 묻습니다.
4. 결과를 4절 판정 규칙으로 설명하되, 최종 판정은 Clipwise 엔진이 한다고 밝힙니다. 자율도가 `human_only`면 안내만 하고, `confirm`·`approve`면 누가 확정하는지(actorRole) 알려 줍니다.
5. Clipwise MCP는 ESTC를 읽기만 합니다. 상태를 직접 바꾸지 말고, 사용자가 Clipwise 화면에서 확정하도록 안내합니다.

### C. 업무 세계 설계를 돕는 요청 ("우리 환불 규정을 세계로 만들어 줘")

1. 규정 원문을 받습니다. 지식에 있으면 `evidence_package`·`get_knowledge`로 원문을 인용합니다.
2. 명사 → 대상과 항목, 처리 단계 → 단계, "~하면 ~로 넘어간다" → 변화, "~일 때만", "~이하" → guard 규칙으로 나눕니다.
3. 같은 `from → to`라도 조건이 다르면 변화를 나눕니다(예: `approve_small`, `approve_large`). 두 변화의 조건이 동시에 참이 되지 않게 합니다.
4. 규칙마다 원문 문장(`rule`)과 구조화 조건(`check`)을 함께 둡니다. 원문으로 계산할 수 없는 규칙은 `check` 없이 두고 사람 확인으로 남깁니다.
5. 모든 변화를 `confirm` 이상으로 두고, `source_required`를 켭니다.
6. 2절의 거절 목록으로 스스로 점검한 뒤 JSON 초안을 보여 줍니다. 저장·활성화는 Clipwise 관리자 화면(업무 규칙 지도·월드 DSL)에서 사람이 합니다.

### C-1. 지금 세계에 없는 요구를 만났을 때 ("이 경우는 어떻게 하나요?")

세계에 없는 대상·단계·변화는 지어내지 않습니다. `estc_propose`로 접수만 합니다.

| 상황 | `kind` | 함께 넣을 값 |
|---|---|---|
| 세계에 없는 대상을 다룹니다 | `entity` | `entity`(대상 이름) |
| 있는 대상에 없는 단계·이동이 필요합니다 | `state_transition` | `entity`, `fromState`, `toState`, `action` |
| 기존 변화에 조건이 더 필요합니다 | `constraint` | `rule`(원문 문장), `targetEntity` |
| 어느 쪽인지 확정할 수 없습니다 | `gap` | 주장과 근거만 |

`claim`(무엇이 없거나 잘못됐는지)과 `evidence`(원문 구절·문서·링크)는 필수입니다. `requester`에는 요청한 사람을 적습니다. 서버는 세계 어휘와 대조해 종류를 다시 정하고, 같은 주장이 이미 열려 있으면 중복으로 알려 줍니다.

접수한 뒤:

1. 세계가 바뀌었다고 말하지 않습니다. 승인은 지식 담당자만 합니다.
2. 처리 상태는 `estc_proposal_status`로 확인합니다. 승인되면 `appliedWorldVersion`이 찍힙니다.
3. 승인 전에는 `estc_world`의 어휘가 그대로입니다. 새 변화 이름으로 상태 변경을 제안하지 마세요.
4. 공백(`gap`) 제안은 세계 변경으로 승인되지 않습니다. 지식 담당자가 세계 정의를 직접 고치거나 반려합니다.

### C-2. 실행을 마쳤을 때 (관찰)

1. `agent_run_start`로 실행을 열고, 일이 끝나면 `agent_run_complete`를 부릅니다.
2. 서버가 그 실행을 **한 번** 관찰합니다. 실패했거나, 근거 없이 끝났거나, 나쁜 평가가 붙었으면 근거 있는 개선 후보를 검토 대기로 만듭니다.
3. 후보는 `proposal_queue`로 확인합니다. 승인은 사람만 합니다. 같은 실행을 다시 완료 처리해도 후보가 중복되지 않습니다.
4. 주간 검토는 `observation_review`로 실행합니다. 최근 7일(기본)에서 **3회 이상 반복**된 신호만 후보가 됩니다.

관찰은 원문 대화·평가 문장을 복사하지 않고, LLM을 부르지 않습니다. 후보 문장은 고정 템플릿입니다.

### D. 원문에서 ESTC 후보를 뽑는 요청 ("이 회의록에서 할 일 뽑아 줘")

1. 활성 세계의 대상·단계 안에서만 뽑습니다. 세계에 없는 개념은 "세계에 없음"으로 따로 알립니다.
2. 후보마다 근거 구절과 원본을 붙이고, 원문에 직접 있으면 `stated`, 문맥 추론이면 `inferred`로 표시합니다.
3. 원문에 없는 담당자·기한은 비워 두고 확인 필요로 적습니다.
4. 후보는 초안입니다. 사람이 Clipwise에서 검토·승인해야 공유됩니다.

### 하지 말 것

- 판정을 스스로 확정하거나 "승인되었습니다"라고 말하기
- 세계에 없는 대상·단계·변화 이름을 지어내기
- 없는 값을 추측해 조건을 통과시키기
- 조건을 문자열 식으로 쓰거나 실행하기
- 초안·반려 기록을 승인된 것처럼 인용하기

## 6. 예시: 환불 세계

Clipwise 환불 템플릿 그대로입니다.

```json
{
  "settings": {
    "timezone": "Asia/Seoul",
    "calendar": "calendar",
    "reviewEveryDays": 90
  },
  "entities": [
    {
      "type": "refund_request",
      "label": "환불 요청",
      "fields": [
        "title",
        "amount",
        "settled",
        "docs_ok"
      ],
      "fieldTypes": {
        "amount": "money",
        "settled": "boolean",
        "docs_ok": "boolean"
      },
      "fieldSources": {
        "settled": "system",
        "docs_ok": "llm_extract",
        "amount": "record"
      }
    }
  ],
  "states": {
    "refund_request": [
      "received",
      "review",
      "approved",
      "completed",
      "rejected"
    ]
  },
  "stateLabels": {
    "refund_request": {
      "received": "접수",
      "review": "검토",
      "approved": "승인",
      "completed": "완료",
      "rejected": "반려"
    }
  },
  "transitions": [
    {
      "entity": "refund_request",
      "from": "received",
      "to": "review",
      "when": "서류가 갖춰짐",
      "action": "to_review",
      "actionLabel": "검토로 보내기",
      "guards": [
        "docs_ready"
      ],
      "autonomy": "confirm",
      "actorRole": "담당자",
      "evidence": [
        "refund-policy#서류요건"
      ]
    },
    {
      "entity": "refund_request",
      "from": "review",
      "to": "approved",
      "when": "소액 승인",
      "action": "approve_small",
      "actionLabel": "작은 금액 승인",
      "guards": [
        "amount_lte_1m"
      ],
      "autonomy": "confirm",
      "actorRole": "담당자"
    },
    {
      "entity": "refund_request",
      "from": "review",
      "to": "approved",
      "when": "고액 승인",
      "action": "approve_large",
      "actionLabel": "큰 금액 승인",
      "guards": [
        "amount_gt_1m"
      ],
      "autonomy": "human_only",
      "actorRole": "팀장"
    },
    {
      "entity": "refund_request",
      "from": "review",
      "to": "rejected",
      "when": "반려",
      "action": "reject",
      "actionLabel": "반려",
      "autonomy": "human_only",
      "actorRole": "담당자"
    },
    {
      "entity": "refund_request",
      "from": "approved",
      "to": "completed",
      "when": "정산 후 환불",
      "action": "partial_refund",
      "actionLabel": "부분 환불",
      "guards": [
        "settled_ok"
      ],
      "autonomy": "approve",
      "actorRole": "권한자",
      "effect": "billing.partial_refund"
    }
  ],
  "constraints": [
    {
      "id": "source_required",
      "rule": "모든 레코드는 sourceId와 근거 구절을 가져야 한다.",
      "required": true,
      "check": {
        "cmp": ">=",
        "left": {
          "meta": "evidence_count"
        },
        "right": {
          "value": 1
        }
      },
      "onMissing": "deny"
    },
    {
      "id": "docs_ready",
      "rule": "서류가 확인되어야 검토로 넘어갑니다.",
      "required": true,
      "entity": "refund_request",
      "kind": "guard",
      "check": {
        "cmp": "==",
        "left": {
          "field": "docs_ok"
        },
        "right": {
          "value": true
        }
      }
    },
    {
      "id": "amount_lte_1m",
      "rule": "환불 금액이 1,000,000원 이하일 때만 담당자가 승인합니다.",
      "required": true,
      "entity": "refund_request",
      "kind": "guard",
      "check": {
        "cmp": "<=",
        "left": {
          "field": "amount"
        },
        "right": {
          "value": 1000000
        }
      }
    },
    {
      "id": "amount_gt_1m",
      "rule": "환불 금액이 1,000,000원을 넘으면 팀장이 직접 처리합니다.",
      "required": true,
      "entity": "refund_request",
      "kind": "guard",
      "check": {
        "cmp": ">",
        "left": {
          "field": "amount"
        },
        "right": {
          "value": 1000000
        }
      }
    },
    {
      "id": "settled_ok",
      "rule": "정산이 확인되어야 부분 환불을 실행합니다.",
      "required": true,
      "entity": "refund_request",
      "kind": "guard",
      "check": {
        "cmp": "==",
        "left": {
          "field": "settled"
        },
        "right": {
          "value": true
        }
      }
    }
  ]
}
```

판정 예시(기준 시각 2026-11-10T12:00:00+09:00, 근거 구절 1개, 원문에 있음). 결과는 Clipwise 엔진이 계산한 값입니다.

- **검토 중인 80만 원 환불을 담당자가 승인하려 함**: 단계 `review`, 변화 `approve_small`, 사실 amount=800000(record) → **ALLOW** (OK) · 화면 결과 「확인 필요」 · 엔진 사유: 지켜야 할 조건을 모두 통과했습니다.
- **검토 중인 150만 원 환불을 소액 승인으로 처리하려 함**: 단계 `review`, 변화 `approve_small`, 사실 amount=1500000(record) → **DENY** (CONSTRAINT_FAILED) · 화면 결과 「불가」 · 엔진 사유: ‘환불 금액이 1,000,000원 이하일 때만 담당자가 승인합니다.’ 규칙에 걸렸습니다. 조건: 금액: 1,000,000 이하.
- **접수된 건을 서류 확인 없이 검토로 보내려 함**: 단계 `received`, 변화 `to_review`, 사실 없음 → **NEED_FACT** (FACT_MISSING) · 화면 결과 「정보 필요」 · 엔진 사유: ‘서류가 확인되어야 검토로 넘어갑니다.’를 판정하려면 서류 확인이(가) 필요합니다.
- **접수된 건의 서류 확인을 에이전트가 대화에서 뽑아 옴**: 단계 `received`, 변화 `to_review`, 사실 docs_ok=true(agent) → **REVIEW** (AGENT_FACT_UNVERIFIED) · 화면 결과 「확인 필요」 · 엔진 사유: 조건은 통과했지만 에이전트가 알려 준 서류 확인 값을 사람이 확인해야 합니다.
- **이미 완료된 건을 다시 승인하려 함**: 단계 `completed`, 변화 `approve_small`, 사실 amount=800000(record) → **DENY** (TRANSITION_NOT_ALLOWED) · 화면 결과 「불가」 · 엔진 사유: ‘완료’에서 ‘작은 금액 승인’(으)로 가는 변화는 이 업무 세계에 없습니다. 이 단계에서 가능한 변화가 없습니다.
- **세계에 없는 변화 이름(force_refund)을 씀**: 단계 `review`, 변화 `force_refund`, 사실 없음 → **UNKNOWN_VOCAB** (UNKNOWN_ACTION) · 화면 결과 「불가」 · 엔진 사유: ‘force_refund’은(는) 이 업무 세계에 없는 변화 이름입니다.

## 7. Clipwise MCP 도구

| 도구 | 쓰임 |
|---|---|
| `estc_guide` | 이 가이드. topic으로 절 하나만 받을 수 있습니다. |
| `estc_world` | 지금 workspace의 업무 세계. 대상·단계·변화·규칙과 한국어 이름, 각 변화의 action 이름·자율도·확정 역할·확인 규칙 문장을 줍니다. 세계가 여럿이면 scope·worldId로 지정합니다. |
| `estc_worlds` | 사용 중인 업무 세계 전체와 범위(scope)·기본 여부. 어느 세계를 읽을지 고를 때 씁니다. |
| `estc_context` | 사람이 승인한 ESTC 기록(대상·현재 단계·근거 구절·원본). entity·state·query·since로 거릅니다. 초안·반려 기록은 나오지 않습니다. |
| `estc_propose` | 세계에 없는 요구를 새 대상·새 단계·전이·새 규칙·공백으로 접수합니다. 주장과 근거가 필수이고, 세계를 바꾸지 않습니다. |
| `estc_proposal_status` | 내가 접수한 제안이 승인·반려됐는지, 어떤 세계 버전이 만들어졌는지 확인합니다. |
| `estc_brief` | 일을 시작할 때 읽는 짧은 안내. 활성 세계의 대상, 열린 제안 수, 접수 방법. |
| `whoami` | 이 연결의 사용자·역할·읽는 공간·세계와 노출 도구 목록. 도구가 안 보이거나 공간이 의심될 때 진단합니다. |
| `proposal_queue` | 세계·지식 수정·지식 문제·지침·기록·도구 결함 제안을 한 번에 조회합니다. |
| `knowledge_revision_propose` | 검토·공개된 지식을 revise·merge·retire로 고치자고 제안합니다(필드 diff만). 승인은 사람만. |
| `knowledge_issue_report` | 게시 지식의 모순·중복·오래됨·근거 부족을 신고합니다. 접수만 합니다. |
| `improvement_candidate_propose` | 실행·평가 근거로 에이전트 지침 개선안을 제안합니다. |
| `estc_record_propose` | 활성 세계 어휘로 업무 기록과 상태 변화를 제안합니다(L1, 승인 필요). |
| `tool_defect_report` | 도구 입력·출력·설명 결함을 개발 검토용으로 신고합니다. 도구를 바꾸지 않습니다. |
| `knowledge_versions` | 지식 한 건의 불변 버전(작성·AI 정리·수정 승인·되돌리기) 이력. |
| `observation_review` | 주간 관찰. 최근 기간의 실행·평가에서 반복된 실패·근거 누락·나쁜 평가를 근거 있는 개선 후보로 만듭니다(모두 검토 대기). |
| `evidence_package` | 질문에 맞는 검토·공유 지식의 인용 묶음. 업무 규정 원문을 인용할 때 씁니다. |
| `get_knowledge` | 지식 한 건의 요약·핵심 결정·본문. 규정 문서 전체를 읽을 때 씁니다. |

모든 도구는 연결한 사용자의 workspace 안에서만 읽습니다. 공개 사본: https://clipwise.kr/guides/world-dsl-estc.md

`estc_world` 응답에서 바로 쓰는 값:

| 자리 | 쓰임 |
|---|---|
| `transitions[].action` | 상태 변경 요청을 옮길 때 쓰는 이름. 여기 없는 이름은 UNKNOWN_VOCAB |
| `transitions[].autonomy`, `autonomyLabel`, `actorRole` | 누가 확정하는지, 에이전트가 안내만 해야 하는지 |
| `transitions[].guards[]` | `id`, 원문 `rule`, 문장으로 렌더한 `condition`. 필요한 항목을 사용자에게 묻는 데 씁니다 |
| `entities[].fields[].type`·`source` | 값의 종류와 출처. `llm_extract` 값은 사람 확인(REVIEW) 대상 |
| `constraints[].machineCheckable`, `kind` | 기계가 판정하는 규칙인지, 변화에서만 확인하는 guard인지 |

조건 트리(`check`) 자체는 응답에 실리지 않습니다. 판정을 흉내 내지 말고 문장과 어휘만 쓰세요.
