사역을 위한 하네스 엔지니어링 — 결정론적 안전 코드 계층

한 줄 정의

LLM의 본질적 확률성(stochastic) 때문에 system prompt만으로는 안전 100% 보장 ❌. 모델을 감싸는 결정론적(deterministic) 검증 계층 = 하네스. Claude Code의 hooks 시스템이 1급 메커니즘. Ch.6 회차의 표준 기법.

요약

프롬프트가 사역자 측 자율, 컨텍스트가 시스템 측 자율이라면, 하네스는 코드 측 강제. 사역 AI의 안전 공학.

핵심 도구: Claude Code의 settings.json hooks (UserPromptSubmit · PreToolUse · PostToolUse · Stop). 3중·4중 가드레일을 코드 레벨에서 강제.

본 카드는 가드레일 카드의 공학 측면 짝. 가드레일 카드는 신학·정책 측면, 본 카드는 코드·구현 측면.

본문 상세

1. 자율적 vs 결정론적 — 3 층 방어

→ 자율 2 층 통과해도 마지막 1% 위반은 코드가 차단. 본 카드 영역.

2. Claude Code Hooks 6 이벤트

차단: exit code 2 + stderr {"decision": "block", "reason": "..."} JSON.

3. ONPP 4 중 하네스 매핑 (상세)

4. Defense-in-Depth 흐름

사용자 입력
   ↓
[UserPromptSubmit] ← 2 층 + 3 층 + 4 층 1차
   ↓
모델 추론
   ↓
[PreToolUse] ← 1 층 + 4 층 2차
   ↓
도구 실행
   ↓
[PostToolUse] ← 4 층 응답 스크러빙
   ↓
[Stop] ← 감사 로깅
   ↓
응답

각 층 독립 차단 가능. 하나 실패해도 다른 층이.

5. Fail-Secure 원칙

"의심스러우면 차단 (When in doubt, block)"

❌ fail-open (에러면 통과)

try { validate(input); } catch (e) { process.exit(0); }

✓ fail-secure (에러면 차단)

try { validate(input); } catch (e) {
  console.error(JSON.stringify({decision:"block", reason:`...`}));
  process.exit(2);
}

6. 3 인 체제 (Separation of Duties)

세 역할이 같은 사람이면 눈먼 점.

7. Human-in-the-Loop (HITL)

자동화 ❌, 사람 승인 필수:

permissions.ask + Notification hook.

사역 적용

단계적 도입 (사역자용)

1주: 사역 AI 정책 작성 — 4 층 중 가장 중요한 것 선정 2주: System Prompt 신학 베이스라인 3주: 자체 검증 체크리스트 4주: Claude Code hooks 도입 (개발자 협업)

도구별 적용

한계와 주의사항

• 가드레일 100% 보장 ❌
• 정규식 우회 가능 ("신·천·지" 분리 변형) — 정기 갱신
• Soft 경고만으로 ❌ — Hard 차단 우선
• HITL 없는 자동 승격 ❌ (Canon 8)
• 사용자 권한으로 hooks 우회 가능 — 평신도 권한 ❌

전 사역 적용 매트릭스 (온누리교회 전체)

본 하네스 패턴은 온누리교회 전 사역 영역에 적용된다. 차세대 사역본부 사례(case/onpp-22-agents)는 한 인스턴스일 뿐.

하나의 하네스 패턴, 모든 사역 인스턴스화 — 차세대는 한 사례, 전 사역이 같은 골격을 공유한다.

관련

• synthesis/ai-seonyong-ch6-harness-engineering — Ch.6 ★ 본 카드 핵심 회차
• concept/3-layer-guardrail — 가드레일 (정책 측면)
• concept/prompt-engineering-for-ministry · concept/context-engineering-for-ministry — 1·2 층 자율
• term/agent-orchestration — 22~38 에이전트 협업
• case/onpp-22-agents — 차세대 운영 사례 (한 인스턴스)

"When in doubt, block. 결정론적 안전 코드가 사역의 1%를 지킨다." "하나의 하네스, 전 사역 인스턴스화."