Skip to content

hashgraph-online/awesome-codex-plugins / plugins/alpoxdev/hypercore/skills/hyper-decision

hyper-decision

Unverified

Use this skill when the user wants a decision API in software: a model call that returns a typed judgment (a yes/no probability, one option from a closed set, an ordered score, or an image box) instead of text, through TypeSafe Jev, OpenAI Decisions, Perplexity, Liquid, Cloudflare Clef, the Vercel AI SDK or AI Gateway, OpenRouter, or an emulation on a general LLM. It decides fit, writes typed questions, calling code, request templates, eval plans, audits of label-only LLM calls, and route setup. Do not use for chat or code generation, model training, moderation policy writing, or general prompt writing.

FileKindSize
SKILL.ko.mdmarkdown27.6 KB
SKILL.mdskill md25.0 KB
assets/evals/hyper-decision-cases.jsonlother36.1 KB
assets/templates/call-aisdk.tsscript9.2 KB
assets/templates/call-direct.tsscript14.5 KB
assets/templates/call-openai.tsscript14.6 KB
assets/templates/call-sdk.pyscript10.1 KB
assets/templates/call-sdk.tsscript9.2 KB
assets/templates/constants.template.tsscript4.2 KB
assets/templates/eval-cases.template.jsonlother3.2 KB
assets/templates/request-openai.jsonconfig2.5 KB
assets/templates/request.jsonconfig2.3 KB
assets/templates/routing-table.template.jsonconfig1.5 KB
references/ecosystem.ko.mdmarkdown7.4 KB
references/ecosystem.mdmarkdown6.6 KB
references/eval-and-audit.ko.mdmarkdown35.0 KB
references/eval-and-audit.mdmarkdown32.5 KB
references/mode-procedures.ko.mdmarkdown26.2 KB
references/mode-procedures.mdmarkdown24.9 KB
references/official/decision-providers.ko.mdmarkdown43.7 KB
references/official/decision-providers.mdmarkdown42.6 KB
references/official/jev-platform.ko.mdmarkdown34.8 KB
references/official/jev-platform.mdmarkdown32.3 KB
references/official/openai-decisions.ko.mdmarkdown20.7 KB
references/official/openai-decisions.mdmarkdown19.9 KB
references/patterns.ko.mdmarkdown20.2 KB
references/patterns.mdmarkdown18.9 KB
references/providers.ko.mdmarkdown30.3 KB
references/providers.mdmarkdown28.9 KB
references/question-design.ko.mdmarkdown34.9 KB
references/question-design.mdmarkdown31.8 KB
rules/modes-and-routing.ko.mdmarkdown12.4 KB
rules/modes-and-routing.mdmarkdown11.4 KB
rules/safety-and-boundaries.ko.mdmarkdown12.1 KB
rules/safety-and-boundaries.mdmarkdown10.7 KB
scripts/check-decision-request.shexecutablescript40.6 KB

references/mode-procedures.ko.md

View on GitHub
# 모드 절차

이 스킬이 만드는 산출물 전체를 일곱 모드가 덮습니다. `design`, `questions`, `code`, `template`,
`eval`, `audit`, `provider`입니다. 모드마다 그 모드를 고르는 신호, 빈칸을 기본값으로 채우는 데
필요한 입력, 순서대로 밟는 단계, 쓰는 파일과 자리, 결과를 검증하는 방법, 실행을 끝내는 조건을
적습니다.

모드는 사용자가 열고 싶어 하는 산출물에서 읽고, 그 표는
[`../rules/modes-and-routing.md`](../rules/modes-and-routing.md)에 있습니다. 그 파일의 적합성 판정이
아래 모든 모드보다 먼저 돕니다. `code`나 `llm` 판정은 거기서 작업을 멈추고, `hybrid`나 `decompose`
판정은 요청을 먼저 쪼갠 뒤 결정 모델 몫에서만 이어 가며, `provider`와 판단이 아니라 행동을
산출물로 하는 요청은 판정을 건너뛰고, `audit`은 후보 호출마다 판정을 한 번 돌립니다. 경로 사실은
[`./providers.md`](./providers.md)와 [`./official/`](./official/) 아래 스냅샷에서 오고, 가격과 한도,
엔드포인트, 모델 아이디는 값이 움직이므로 이 파일에서 되풀이하지 않습니다.

## Contents

- 공통 규칙
- design
- questions
- code
- template
- eval
- audit
- provider
- Sources

## 공통 규칙

**산출물을 두는 자리.** 사용자가 경로를 지정했으면 그곳에 씁니다. 지정하지 않았으면
`.hyper/decision/<주제>/` 아래에 씁니다. `<주제>`는 요청에서 뽑은 짧은 이름입니다. 쓴 파일은 경로를
모두 보고합니다.

**확인 없이 덮어쓰지 않습니다.** 이미 있는 파일은 먼저 읽고, 옆 파일로 쓰거나 바꿔도 되는지 물은
뒤에 씁니다. `template`과 `code`는 파일이 이미 있을 가능성이 가장 큰 모드이므로 특히 지킵니다.

**요청을 검증하는 두 가지 길.** 기본은 `../scripts/check-decision-request.sh` 검사기를 돌리는
것이고 bash 3.2 이상과 jq가 필요합니다. `--route` 값은 `systemone`, `openai`, `aisdk`, `bai`
가운데 하나이고 기본값은 `systemone`입니다. 둘 가운데 하나라도 없으면
[`./question-design.md`](./question-design.md)의 요청 유효성 점검표를 사람이 직접 돌리고, 마지막
보고에 수동 점검이었다고 밝힙니다.

**경로 층이 호출자의 가정을 정합니다.** `T1`과 `T2` 경로는 분포가 붙은 타입 답을 돌려주므로
임계값이 뜻을 갖습니다. `T3` 경로는 범용 모델 위의 흉내이고 분포 없이 라벨만 돌려주므로, 그 경로의
호출자에는 임계값 대신 검토 경로를 넣고 주석으로 그 사실을 밝힙니다. `T4` 경로는 결정 경로가
아니므로 호출자를 만들지 않습니다.

**멈추는 때.** 모드는 산출물이 있고 검증이 돌았으며 아래 모드별 종료 조건이 성립할 때 멈춥니다.
적합성 판정, 사용자만 줄 수 있는 입력의 부재, 검증되지 않은 경로는 그보다 먼저 작업을 멈춥니다.

## design

**신호.** "결정 모델로 하는 게 맞나", "판단 문제인가", "결정 모델이냐 코드냐", "어떻게 나눌까",
"결정 계약". 영어: "Should this use a decision model", "is this a judgment problem", "how should I
split this".

**필요한 입력과 기본값.** 기능 설명과 그 기능이 내야 하는 출력입니다. 저장소 파일은 필요하지
않지만 경로가 주어지면 주변 코드를 읽습니다. 기본 언어와 경로는
[`../rules/modes-and-routing.md`](../rules/modes-and-routing.md)에서 옵니다.

**단계.**

1. 적합성 판정을 돌립니다. 판정과 그 판정을 가른 질문을 기록합니다.
2. 판정이 `code`나 `llm`이면 결정 산출물 없이 분할이나 대안을 씁니다. 코드가 맡을 몫, 생성 모델이
   맡을 몫, 요청을 쪼갰을 때 결정 모델이 맡을 몫을 적습니다.
3. 판정이 `decision`, `decompose`, `hybrid`이면 결정 계약을 씁니다. 결정마다 한 행에 그 결정이
   묻는 판단, 답의 유형, 답을 받아 행동하는 주체, 확률이 낮을 때 일어나는 일을 적습니다. `hybrid`는
   분할을 먼저 쓰고 결정 모델 몫의 계약만 씁니다. `decompose`는 산술과 정책을 코드로 옮기고 판단
   몫의 계약만 쓴 뒤 그 몫을 판정에 다시 겁니다.
4. 결정 자체를 코드의 표로 씁니다. 벤더 지침대로입니다. 계약은 그 결정이 읽는 판단을 나열하고,
   결정은 그 판단들에 대한 진리표이며, 각 행이 행동을 지정합니다. 결과가 정해지지 않은 조합은 설계
   공백이므로, 질문을 넓혀 덮지 말고 표시합니다.
5. 질문마다 읽는 상태 필드의 이름을 적고, 그 상태에 사람 시험을 겁니다. 이 상태와 이 질문만 보고도
   능력 있는 사람이 곧바로 답할 수 있는가. 그렇게 만들려고 더한 필드를 함께 적습니다.
6. 아직 사람의 결정이 필요한 부분은 추측하지 말고 표시합니다.

**산출물과 자리.** 기본 위치 또는 사용자가 준 경로의 `decision-contract.md`입니다.

**검증.** 계약을 판정에 다시 대 봅니다. 모든 행이 텍스트나 이미지에 대한 판단 하나를 물어야 하고,
산술이나 셈, 날짜 비교, 생성 글을 요구하는 행이 없어야 합니다. 모델에게 결정 자체를 시키는 행도
없어야 합니다. 계약이 판정을 다시 통과하지 못하면 분할이 틀린 것이므로 다시 씁니다.

**종료 조건.** 계약이 모든 결정을 나열하고, 모든 행이 판정을 통과하고, 상태가 사람 시험을 통과하고,
확률이 낮을 때의 검토 경로가 적혀 있을 때입니다. 아무것도 호출하지 않고 요청 파일도 쓰지 않습니다.

## questions

**신호.** "질문 만들어", "질문 묶음", "선택지", "기준", "점수 단계", "라벨 만들어". 영어: "write the
questions", "question set", "criteria", "options".

**필요한 입력과 기본값.** `design`의 결정이나 그 결정에 대한 설명입니다. 지시문 언어는 기본이
영어이고, 상태는 사용자 자료의 언어를 그대로 둡니다. 질문마다 답의 모양으로 중립 유형을 고르고
([`./question-design.md`](./question-design.md)), 그 유형을 경로의 방언으로 적습니다. System One
방언은 `noul`/`choice`/`score`/`box`, OpenAI 방언은 `predicate`/`choice`/`score`, AI SDK는
`boolean`/`choice`/`score`/`box`입니다.

**단계.**

1. 판단마다 질문 하나를 씁니다. 답 하나 뒤에 판단 둘이 숨어 있으면 나눕니다.
2. 질문마다 유형과, 조건을 온전히 적은 지시문을 붙입니다. 뜻은 아이디가 아니라 지시문에 있어야
   합니다.
3. `choice`면 선택지 목록을 쓰고, 선택지마다 무엇을 덮는지, 무엇이 이웃에 속하는지, 예시가
   무엇인지 적습니다. `score`면 단계마다 상황을 적습니다. 예/아니오면 `true`와 `false`가 각각
   무엇을 뜻하는지 적습니다.
4. "해당 없음"이 요청 밖으로 나가는 방식을 정합니다. 기본은 짝 불리언이고, 닫힌 답 집합 하나가
   필요한 자리에서는 `other`나 `none` 선택지입니다. 어느 쪽을 골랐고 왜 그랬는지 적습니다.
5. 상태 필드를 백틱 안에 이름으로 지목하고, `design`에서 정한 필드 이름을 씁니다.
6. 경로에 맞는 요청 파일로 질문을 묶고, 검사할 수 있게 예시 상태를 넣습니다.
7. 그 경로의 `--route` 값으로 오프라인 검사기를 돌립니다. bash나 jq가 없으면
   [`./question-design.md`](./question-design.md)의 점검표를 사람이 돌리고 그 사실을 밝힙니다.
8. `questions.md`를 씁니다. 질문마다의 선택, 대비책 결정, 모델 아이디와 스냅샷 날짜, 그리고 첫
   실호출 전에 스냅샷을 다시 확인하라는 안내를 적습니다.

**산출물과 자리.** `request.json`과 선택을 설명하는 짧은 `questions.md`를 기본 위치나 사용자가 준
경로에 씁니다. 요청 JSON에는 주석을 넣을 수 없으므로 스냅샷 날짜, 모델 아이디, 첫 실호출 전 확인
안내는 `questions.md`로 갑니다.

**검증.** 검사기 보고에 고른 경로의 오류가 없어야 하고, 수동 점검이면 모든 줄을 통과해야 합니다.
답을 코드에서 바로 쓸 수 없는 질문은 인계 전에 다시 씁니다. 짝 질문을 일부러 둔 요청에서 나온
`NO_FALLBACK_OPTION` 경고는 죽은 선택지를 넣어 지우지 않고 `questions.md`에 기록합니다.

**종료 조건.** 질문마다 판단이 하나이고, 답 유형이 코드가 그 답으로 할 일과 맞고, 요청이 그 경로의
검사를 통과할 때입니다.

## code

**신호.** "호출 코드", "연결 코드", "클라이언트", "연동", "TypeScript", "Python". 영어: "call it
from", "integration code", "wire this into".

**필요한 입력과 기본값.** 질문과 임계값이 있으면 그것을, 없으면 `questions` 모드의 질문 묶음을
받습니다. 언어 기본값은 TypeScript이고, `pyproject.toml`은 `package.json`이 없을 때만 Python을
뜻합니다. 둘 다 있으면 TypeScript입니다. 경로와 층은 [`./providers.md`](./providers.md)의 순서를
따릅니다. 계약 값은 코드에 쓰지 말고 [`./official/`](./official/) 아래 스냅샷에서 읽습니다. 예외는
[`../rules/safety-and-boundaries.md`](../rules/safety-and-boundaries.md) 9절이 말하는 이름 있는
엔드포인트 상수와 모델 상수 하나씩입니다.

**단계, 이 순서대로.**

1. **적합성 판정.** 아무것도 쓰기 전에 다섯 질문을 돌립니다. `decision`과 `decompose`만 이어 갑니다.
   `code` 판정은 호출자 없이 평범한 코드로 답하고, `llm` 판정은 이미 글을 쓰는 모델을 그대로 두고,
   `hybrid`는 먼저 쪼갭니다. 판정은 한 줄로 밝힙니다.
2. **경로와 층, 언어 결정.** [`./providers.md`](./providers.md)의 순서로 경로를 고르고 저장소에서
   언어를 고릅니다. 어느 경로, 어느 층, 어느 언어를 골랐는지 밝힙니다. 질문 유형 이름과 입력 키,
   확률 경로가 방언에 따라 모두 달라지기 때문입니다.
3. **상수 파일 먼저.** 질문과 모델 아이디, 임계값을 담은 파일을 호출자보다 먼저 씁니다. 임계값에는
   사용자 자료가 다르다고 말할 때까지 조정 전 가정이라는 주석을 답니다. `T3` 경로에는 임계값이
   없습니다. 그 파일은 검토 경로 플래그와, 그 경로가 분포를 주지 않는다는 주석을 담습니다.
4. **호출 파일.** 고른 경로와 언어의 호출자 하나를 씁니다. 키는 호출 시점에 환경 변수 이름으로
   읽고, 상태 하나에 질문 전부를 한 요청으로 보내고, 키를 출력하거나 로그에 남기거나 파일로 쓰지
   않습니다. 별칭이 아니라 버전이 붙은 모델 아이디를 고정하고, 응답이 보고한 모델 아이디를
   기록합니다.
5. **오프라인 검사기로 요청 점검.** 같은 질문을 요청 파일로 묶어 스킬 폴더에서
   `bash scripts/check-decision-request.sh --route <경로> <파일>`을 돌립니다. `--route`는
   `systemone`, `openai`, `aisdk`, `bai` 가운데 하나입니다. 호출자를 인계하기 전에 종료 코드 0이
   필요하고, 1이면 고칠 필드를 알려 줍니다. bash나 jq가 없으면
   [`./question-design.md`](./question-design.md)의 점검표를 사람이 돌리고 그 사실을 밝힙니다.
6. **응답 검증.** 호출자는 답으로 행동하기 전에 모두 확인합니다. 보낸 질문이 응답에 다 있고, 답
   유형이 보낸 질문 유형과 맞고, choice 답이 보낸 선택지 가운데 하나이고, score 답이 단계 범위
   안이고, 확률이 0과 1 사이이며, 분포가 작은 오차 안에서 1로 합쳐집니다. 거절은 별도 분기이고
   확률이나 첫 선택지, 점수 0으로 강제 변환하지 않습니다. 하나라도 어긋난 응답은 값으로 맞추지
   않고 오류로 다룹니다.
7. **확률 관문 분기.** `confidence`가 아니라 행동의 확률로 분기합니다. 예/아니오 답은 그 확률에,
   choice나 score 답은 실행할 선택지의 확률이나 해당 쪽 단계들의 누적 확률에 겁니다. 낮은 구간은
   사람에게 보내는 검토 경로를 돌려주고, 구간 경계는 호출자 안의 리터럴이 아니라 3번의 이름 있는
   상수입니다. `T3` 경로에는 분기할 확률이 없으므로 이 단계는 3번에서 정한 검토 경로가 되고,
   호출자는 라벨에 임계값을 거는 척하지 않고 그 사실을 주석으로 밝힙니다.
8. **실호출 전 동의.** 생성한 코드는 스스로 서비스를 부르지 않습니다. 첫 실호출 전에 그 사람에게
   묻고, [`./official/`](./official/) 아래 스냅샷으로 비용을 말하고, 질문에 답하는 가장 적은 요청만
   돌립니다. 환경 변수의 키나 검사 통과는 동의가 아닙니다.
9. **멈춤.** 파일과 검사기 결과, 경로와 층, 언어 결정을 인계합니다. 이 모드 안에서 실호출을 돌리지
   않습니다.

**산출물과 자리.** `constants.ts`(또는 `constants.py`), 호출자 파일, 5번이 묶는 `request.json`을
기본 위치나 사용자가 준 경로에 씁니다. 상수 파일과 `request.json`은 같은 모델 아이디를 담고 함께
맞춰져야 합니다. 세 경로와 검사기 종료 코드를 모두 보고합니다.

**검증.** 고른 경로에서 검사기가 0으로 끝나거나, bash나 jq가 없을 때 수동 점검이 모든 줄을
통과해야 합니다. 호출자는 대상 언어에서 컴파일되고, 6번의 응답 검증이 주석의 약속이 아니라 파일
안에 있습니다.

**종료 조건.** 상수 파일과 호출자가 있고, 지금 경로의 검사를 통과했고, 실호출이 동의 절차와 함께
사용자 몫으로 남았을 때입니다.

## template

**신호.** "요청 JSON", "상수 파일", "라우팅 표", "템플릿", "뼈대". 영어: "request json", "constants
file", "routing table", "starter", "skeleton".

**필요한 입력과 기본값.** 결정과 상태 필드입니다. 나머지는 모두 기본값이 있고, 이 모드의 요지는 그
기본값을 드러내 두어 사용자가 고치게 하는 것입니다.

**단계.**

1. 같은 질문 묶음으로 System One 방언의 `request.json`과 OpenAI 방언의 `request-openai.json`을
   씁니다. 그래야 두 파일이 한 예시에서 방언 차이를 보여 줍니다. 각 파일은 예시 상태, 예/아니오 질문
   하나, `choice` 하나, `score` 하나와, 그 방언에서 받는다고 스냅샷이 밝힌 모델 아이디를 담습니다.
2. 상수 파일에 질문과 모델 아이디, 임계값을 함께 내보내고, 임계값은 조정 전 가정으로 표시합니다.
3. 답마다 그 답을 받아 행동할 코드 경로를 잇는 라우팅 표를 씁니다. 낮은 확률 행과 거절 행도 함께
   넣습니다.
4. 각 요청 파일에 그 경로의 검사를 돌립니다. `request.json`은 `--route systemone`,
   `request-openai.json`은 `--route openai`입니다. SDK 경로용으로 쓴 템플릿은 `--route aisdk`로
   검사합니다.
5. 첫 호출 전에 바꿔야 할 값을 상수 파일 머리말과 보고에 적습니다. JSON 파일에는 넣지 않습니다.
   안내 키가 검사기에서 알 수 없는 필드로 돌아오기 때문입니다.

**산출물과 자리.** `request.json`, `request-openai.json`, `constants.ts`, `routing-table.json`을
기본 위치나 사용자가 준 경로에 씁니다.

**검증.** 템플릿이 주장하는 모든 경로에서 검사기가 0으로 끝나고, 라우팅 표에 질문이 낼 수 있는 모든
답의 행과 거절 행이 있습니다.

**종료 조건.** 파일이 있고, 주장한 모든 경로가 검사를 통과하고, 첫 호출 전 교체 안내가 상수
머리말과 보고에 있을 때입니다.

## eval

**신호.** "평가", "라벨", "임계값", "정확도", "검증 세트". 영어: "evaluate", "test set", "labels",
"how accurate", "before we ship".

**필요한 입력과 기본값.** 결정, 질문, 경로와 그 층, 그리고 사용자가 가진 라벨 예시입니다. 라벨이
없으면 계획이 어디서 오는지 적고 첫 묶음을 잠정으로 다룹니다. `T3` 경로의 계획에는 임계값 조정이
없습니다. 걸 확률 분포가 없기 때문입니다.

**단계.**

1. 결정을 적고 오류 유형마다 값을 매깁니다. 거짓 양성과 거짓 음성의 비용은 거의 같지 않고,
   임계값은 정확도가 아니라 비용을 따릅니다.
2. 케이스 묶음을 만듭니다. 대표 케이스 다음에 어려운 케이스입니다. 어려운 목록은 부정 표현, 제3자
   인용문, 한 메시지의 두 의도, 정답 라벨이 null인 정보 누락, 상태 안에 심긴 지시문, 어느 선택지에도
   맞지 않는 진술, 뒤집은 라벨 극성, 구어체 한국어로 시작합니다.
3. 케이스를 임계값 조정 분할과 보고용 평가 분할로 나누고 두 쪽을 분리해 둡니다. 나누기 전에 거의
   같은 케이스를 묶고, 클래스와 배포를 가르는 조각에 맞춰 층을 나눕니다.
4. 결과가 그대로여야 하는 비교에는 모델 버전을 고정하고, 요청에 쓴 별칭이 아니라 응답이 보고한
   모델 아이디를 기록합니다. 근거는 [`./eval-and-audit.md`](./eval-and-audit.md)에 있습니다.
5. 조정 분할에서 임계값을 맞추고, 질문 모양별 출발 구간에서 시작한 뒤 보고 분할에서 보고합니다.
   검토 구간은 정확도 곡선이 아니라 오류별 비용에서 뽑습니다. `T3` 경로에서는 이 단계 대신 검토
   경로를 정하고 건너뜁니다.
6. 라벨이 필요 없는 점검을 더합니다. 케이스마다 반복해 뒤집힘 비율을 보고하고, 선택지 순서와 극성
   치환을 돌립니다.
7. 질문 모양별 보정 점검을 더하고, 모든 비율 옆에 구간을 붙입니다.
8. 결과를 견줄 기준선을 적습니다. 지금 그 일을 하는 규칙이나 정규식이 있으면 그것이고, 어느 경로를
   쓸지가 문제라면 다른 경로입니다.
9. 질문 묶음에 가한 모든 변경을 프롬프트 체조 목록으로 검토하고, 체조로 읽히는 변경에는 구조적
   해법을 제안합니다.
10. 실측 전에 안전 규칙이 적용됩니다. 호출에 대한 그 사람의 동의, 상태에 사적 자료가 있으면 별도
    동의, 가장 작은 유용한 모양의 요청 하나 먼저입니다. 비용은 [`./official/`](./official/) 아래
    스냅샷으로 어림하고 반복 횟수를 포함해 말합니다.

**산출물과 자리.** `eval-plan.md`와 `eval-cases.jsonl`을 기본 위치나 사용자가 준 경로에 씁니다. 케이스
행은 정답 라벨을 담고, 정직한 답이 "정보 부족"인 곳에는 null 라벨을 담으며, 그 행이 어느 분할에
속하는지도 적습니다.

**검증.** 계획이 조정 분할과 보고 분할, 각 임계값을 정하는 측정, 반복과 치환 점검, 질문 모양별
보정 점검을 밝히고, 케이스 행이 null 행까지 포함한 정답 라벨을 담습니다.

**종료 조건.** 계획이 두 오류의 비용을 정의하고, 두 분할이 분리돼 있고, 조정 절차와 라벨 없는 점검이
적혀 있고, 질문 묶음의 모든 변경이 프롬프트 체조 목록으로 검토됐을 때입니다. 이 모드는 계획과 케이스
템플릿, 조정 절차를 만들고 실측을 직접 돌리지 않습니다.

## audit

**신호.** "감사", "LLM 호출 찾아", "교체 대상", "어디서 낭비하나". 영어: "audit", "find the LLM
calls", "what should we replace".

**필요한 입력과 기본값.** 저장소 경로와, 사용자가 있으면 관심 파일 목록입니다. 기본 범위는 의존성과
생성 코드를 뺀 작업 트리 전체입니다.

**단계.**

1. 모델을 부르고 라벨 하나만 돌려받는 자리를 모두 찾습니다. 답 집합이 유한하고, 호출자가 응답을 그
   값으로 파싱하고, 사람이 근거를 읽지 않고, 자주 돌거나 사람이 기다리는 호출입니다. 패턴을 숨기는
   모양도 포함합니다. 구조화 출력 enum, `logit_bias` 표, 신뢰도로 바꾸는 로그프롭 읽기, 분류기로
   쓰는 모더레이션 호출, 실행 중에 쓰는 은퇴한 판정기나 채점기입니다.
2. 결정 모델이 감당하지 못하는 호출을 걸러냅니다. 문서로 밝힌 한도에 따라 산술, 셈, 날짜 비교, 여러
   단계 추론, 생성 글이 필요한 것은 그대로 둡니다. 정확해야 하고 검증할 수 없는 라벨도 그대로 둡니다.
3. 남은 호출마다 잽니다. 하루 호출 수, p50과 p95 지연, 방향별로 나눈 호출당 토큰, 그리고 그 호출이
   도는 동안 막히는 것.
4. 교체가 아끼는 것, 라벨이 질문 유형으로 얼마나 깔끔하게 옮겨 가는지, 대상 층이 분포를 유지하는지로
   순위를 정합니다.
5. 대상 경로 층과 기대 확률 원천을 포함해 표를 쓰고 멈춥니다.

**산출물과 자리.** 보고서 하나, `audit.md`입니다. 감사 대상 트리 밖의 `.hyper/decision/<주제>/`에
쓰거나 답장에 담거나, 사용자가 준 경로가 감사 대상 트리 밖일 때 그곳에 씁니다. 다른 것은 쓰지
않습니다.

**검증.** 모든 행이 파일과 줄을 인용하고, 모든 행이 층과 확률 원천을 적고, 감사 대상 트리의 어떤
파일도 고치지 않고 보고서를 만들었으며, 보고서 자체가 그 트리 밖에 있습니다.

**종료 조건.** 표가 있고 작업 트리가 그대로일 때입니다. 이 모드는 읽기 전용이고 후보를 찾기만 하며
고쳐 쓰지 않습니다.

## provider

**신호.** "어느 경로", "어디로 연결", "설정", "환경 변수", "층". 영어: "which provider", "which
route", "connect it", "setup", "environment", "tier".

**필요한 입력과 기본값.** 저장소와, 사용자가 이미 가진 키의 이름입니다. 이름만 확인합니다.

**단계.**

1. 층을 먼저 고르고 경로를 고릅니다. 답에 분포가 필요하면 `T1` 네이티브 엔드포인트, 프로젝트가 이미
   그 SDK에 의존하거나 여러 벤더를 한 인터페이스로 묶어야 하면 `T2` SDK나 게이트웨이, `T1`과 `T2`를
   쓸 수 없고 분포 없는 라벨로 충분할 때만 `T3` 흉내입니다. `T4`는 여기서 선택지가 아니고 `audit`
   이나 `design`으로 갑니다.
2. 고른 층 안의 순서는 [`./providers.md`](./providers.md)에서 가져오고, 저장소가 이미 의존하는
   것에서 시작합니다.
3. 어떤 환경 변수 이름이 있는지 확인하고, 값은 절대 보지 않으며, 답은 이름으로만 보고합니다.
4. 고른 경로의 설정 절차만 씁니다. 키를 어디서 읽는지, 무엇을 로그에 남기면 안 되는지, 어느 모델
   아이디를 고정할지 적습니다. 설정 문서는 환경 변수 이름, 경로, 층을 적고, 받는 아이디와
   엔드포인트는 [`./providers.md`](./providers.md)와 [`./official/`](./official/)의 해당 스냅샷을
   가리킵니다. 그 값들이 그 파일에서 갱신되므로 산문으로 옮겨 적지 않습니다.
5. 사용자가 검증된 계약이 없는 경로를 지정했으면 그렇다고 말하고 그 경로의 코드를 만들지 않습니다.
6. 첫 호출 규칙을 밝힙니다. 동의 뒤에, 비용을 먼저 말하고, 실요청 하나입니다.

**산출물과 자리.** 기본 위치나 사용자가 준 경로의 `provider-setup.md`입니다.

**검증.** 고른 경로와 층이 [`./providers.md`](./providers.md)에 검증된 행을 갖고, 환경 변수는 값이
아니라 이름으로 적혔고, 모델 아이디는 별칭이 아니라 고정된 아이디이며, 문서에 키 값이 없습니다.

**종료 조건.** 설정 문서가 층, 경로, 환경 변수, 고정한 모델 아이디, 첫 호출 규칙을 적고, 실호출이
없었을 때입니다.

## Sources

> Links checked 2026-11-08.

| 주장 | 출처 |
| --- | --- |
| 모드 집합, 모드별 신호, 가장 먼저 도는 적합성 판정 | [`../rules/modes-and-routing.md`](../rules/modes-and-routing.md) |
| 질문의 모양, criteria와 짝 질문 지침, bash나 jq가 없을 때 쓰는 수동 점검표 | [`./question-design.md`](./question-design.md) |
| 경로 층, 경로 순서, 키 취급 규칙, 검증된 계약이 없는 경로 | [`./providers.md`](./providers.md) |
| 산출물 기본 경로와 덮어쓰지 않기 규칙 | repository policy |
| 질문 유형과 호출 뒤 검증하는 답 필드, 방언별 이름 | <https://docs.typesafe.ai/api/system-one.md> 및 <https://developers.openai.com/api/reference/resources/decisions/methods/create.md> |
| SDK 계약의 boolean, choice, score, box 이름과 언어 모델 경로에 분포가 없다는 점 | <https://ai-sdk.dev/docs/ai-sdk-core/decisions> |
| 호출을 걸러내는 문서상 한도와 선택지 순서 시험 | <https://docs.typesafe.ai/model-jaggedness.md> |
| 확률 우선 라우팅, 출발 구간, 나뉜 답의 누적 확률 해법 | <https://docs.typesafe.ai/confidence.md> 및 <https://docs.typesafe.ai/patterns/confidence-routing.md> |
| 상태에 대한 사람 시험, 코드의 진리표로서의 결정, 프롬프트 체조 목록 | <https://github.com/typesafe-ai/skills> (release v0.6.2, 2026-10-23) |
| 상수 파일 하나 습관과, 낡은 사본이 없는 필드를 만들어 낸다는 경고 | <https://docs.typesafe.ai/models.md> |
| 검사기의 경로, 플래그, 종료 코드 | `../scripts/check-decision-request.sh` |

### Evidence grade

공통 규칙과 모드별 단계, 종료 조건은 `LOCAL`입니다. 저장소의 라우팅과 질문 지침 위에 세운 이
패키지의 절차이기 때문입니다. 질문 모양과 답 필드, 문서로 밝힌 한도, 확률 지침, 감사 신호는
`VENDOR`이고 각각 링크한 페이지가 근거입니다. 검사기 항목은 `PRIMARY`이고, 설명이 아니라 이 패키지의
파일을 읽어 옮겼습니다.

가격, 요율 한도, 문맥 예산, 엔드포인트 이름, 모델 아이디는 이 파일에 일부러 두지 않았습니다.
[`./providers.md`](./providers.md)와 [`./official/`](./official/) 아래 스냅샷에 있고 검토 날짜가
붙어 있습니다.
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 470kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 470kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 470kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall