LLM 기능을 랜딩 페이지처럼 배포하지 마세요. APRF는 코드, YAML 게이트(gates), 그리고 이번 주에 바로 연결할 수 있는 CI를 갖춘, 폐쇄형(gated)이며 기계 판독이 가능한 운영 준비 프레임워크(production readiness framework)입니다.

stackrail.io

대부분의 팀은 랜딩 페이지를 배포하는 것과 똑같은 방식으로 LLM 기능을 배포합니다: PR(Pull Request)을 머지하고, 데모를 지켜보고, 축하합니다.

그러면 현실이 닥쳐옵니다.

• 프롬프트 인젝션(Prompt injection)이 고객의 CRM 데이터를 유출합니다.
• 코딩 에이전트(Coding agent)가 비밀 정보를 커밋합니다.
• '지원 봇(Support bot)'이 환불 정책을 환각(Hallucinate)하여 소송으로 이어집니다.
• 잊혀진 API 키가 하룻밤 사이에 8만 2천 달러를 태워버립니다.

이러한 실패 중 그 어느 것도 "모델이 충분히 똑똑하지 않았다"처럼 보이지 않습니다.
그것은 **운영 게이트(production gates)가 없는 운영 시스템(production systems)**처럼 보입니다.

이 포스트는 해당 논쟁의 개발자용 버전이며, 여러분이 구현할 수 있는 부분들—허용 목록(allowlists), 승인 게이트(approval gates), YAML 정책(YAML policy), CI, 그리고 기계 판독이 가능한 증명(attestation)—을 포함하고 있습니다. 정식 버전은 StackRail에서 확인할 수 있습니다: Your AI Is "In Production." That Doesn't Mean It's Production-Ready.

대부분의 프레임워크가 당신에게 강요하지 않는 질문

NIST AI RMF는 위험에 대해 어떻게 생각해야 하는지를 알려줍니다.
ISO/IEC 42001은 AI 시스템을 어떻게 관리해야 하는지를 알려줍니다.
SOC 2는 감사인에게 어떻게 당신의 회사를 신뢰할지를 알려줍니다.

유용하고, 필요하지만, 당직을 서는 엔지니어에게는 불충분합니다.

당신이 밤에 잠을 잘 수 있을지를 실제로 결정하는 질문은 더 간단합니다:

이 AI 애플리케이션이 운영 환경(production)에서 안전하게 작동할 수 있는가?

이것이 바로 AI 운영 준비 프레임워크 (AI Production Readiness Framework, APRF) 뒤에 숨겨진 질문입니다. 이는 StackRail에서 발표한 벤더 중립적인 작업 초안(working draft)입니다.

이것은 인증이 아닙니다.
파트너 네트워크도 아닙니다.
이사회 보고서에 넣을 0~100점 사이의 "준비도 점수(readiness score)"도 아닙니다.

이것은 **게이트 방식(gated)**의 방법론입니다: 필수 점검 사항은 통과하거나, 아니면 당신을 차단(block)합니다. 권장 제어 항목(Recommended controls)은 게이트의 평균 점수에 포함되지 않습니다.

"게이트 방식(gated)"이 의미하는 것 (그리고 그것이 중요한 이유)

만약 당신이 "AI 성숙도 점수(AI maturity score)"를 제안받은 적이 있다면, 이미 그 실패 패턴을 알고 있을 것입니다.

• 보안 비밀(Secrets) 위생 상태는 엉망입니다.
• 하지만 평가(Eval) 대시보드는 아주 예쁘게 보입니다.
• 어떻게든 여전히 87% 준비됨이라는 결과를 얻습니다.

APRF는 그러한 타협을 금지합니다.

vanity_score = mean(all_controls)          # ❌ 누락된 킬 스위치(kill switch)를 평균값으로 희석함
gate_result  = ALL(mandatory_checks.pass)  # ✅ 하나라도 실패하면 차단됨
capability   = min(pillar_levels)          # ✅ 가장 취약한 기둥(pillar)이 전체 수준을 결정함

필수 점검 항목(Mandatory checks)은 합격/불합격(pass/fail) 방식입니다.
실패는 **차단 요소(blockers)**입니다.
역량 달성(Capability attainment)은 기둥(pillars)들 중 최솟값을 기준으로 하며, 평균값이 아닙니다.
당신은 단일한 전체 백분율을 절대 발표하지 않습니다.

이것이 너무 엄격하게 들린다면, 잘된 일입니다. 운영 환경(Production)은 엄격합니다.

멘탈 모델: 데모 경로(demo path) vs 게이트 경로(gated path)

flowchart LR
  subgraph Demo["Demo path"]
    A[Prompt works] --> B[Merge PR]
...

카탈로그 구성 요소 (v0.10 기준)

구체적인 예시: "우리는 도구를 사용하는 에이전트가 있습니다"

APRF는 당신에게 축하를 건네지 않습니다. 대신 질문을 던집니다 (Core + Agents 관점 영역):

다이어그램: 모델은 제안하고, 플랫폼은 결정한다

sequenceDiagram
  participant U as User
  participant A as Agent runtime
...

실무 구현 (이번 주)

첫날부터 "APRF를 채택"하여 종교처럼 따를 필요는 없습니다. 동일한 아이디어들을 당신의 스택에 연결하세요.

1. 도구 화이트리스트 + 스키마 검증 (TypeScript)

import { z } from "zod";

const tools = {
...

2. 우회 불가능한 승인 (Python 스케치)

반드시 제거해야 할 실패 모드: UI에는 "승인(Approve)" 버튼이 있지만, 에이전트의 HTTP 경로가 도구(tool)를 직접 호출하는 경우입니다.

HIGH_IMPACT = {"update_crm_contact", "refund_order", "shell_exec"}

def execute_tool(agent_id: str, name: str, args: dict, approval_id: str | None):
...

CI(지속적 통합)에서 실제로 실행해야 하는 우회 테스트:

# 403 / TOOL_DENIED를 기대해야 함 — 절대로 CRM 쓰기가 발생해서는 안 됨
curl -sS -X POST "$GATEWAY/tools/update_crm_contact" \
  -H "Authorization: Bearer $AGENT_TOKEN" \
...

3. YAML 정책 팩 (app 버전과 연동)

프레임워크 버전을 고정하고, 이 서비스에 대해 어떤 게이트(gate)를 주장하는지 선언하세요:

# aprf/policy.yaml
aprfVersion: "0.10.0"
profileId: aprf-profile-core
...

4. GitHub Actions: 게이트 누락 시 릴리스 실패 처리

# .github/workflows/aprf-gates.yml
name: APRF gates
on:
...

증거 검사기(Evidence checker) 스케치:

# scripts/check_aprf_evidence.py
import json, sys, pathlib, yaml

...

5. 증명(Attestation) JSON ("완료"의 모습)

자기 증명(Self-attestation)은 인증(certification)이 아닙니다. 이는 PR(Pull Request), 변경 티켓 및 감사를 위한 재현 가능한 산출물(artifact)입니다.

최소한의 형태 (attestation schema 0.6 및 samples 참조):

{
  "$schema": "https://stackrail.io/aprf/attestation-schema/0.6",
  "type": "aprf-self-attestation",
...

필수 항목 중 하나라도 실패하면 → **게이트 실패(gate fail)**입니다. 평균을 내거나 "87% 준비됨"과 같은 방식은 허용되지 않습니다.

레퍼런스 평가 시도하기 (15–30분 소요)

선택적 관점(lenses)을 포함한 Core / Regulated 자기 평가 도구를 공개했습니다. 완료되면 증명(attestation) JSON을 다운로드하세요.

• APRF 평가 받기
• APRF 작동 방식
• 기계 판독 가능 사양(Machine-readable spec)
• 공개 RFC

대상 사용자

• 실제 트래픽에 에이전트(Agents) / RAG / 음성(Voice) / 코딩 코파일럿(Coding copilots)을 배포하는 엔지니어