sap-session

sap-session — Evidence Loop Orchestrator

🎯 이 스킬의 존재 이유

대기업 SAP 환경에서는 라이브 시스템 접근이 금지됩니다. 그래서 AI는 실행기가 될 수 없고, 조언자에 머물 수밖에 없습니다. 이 제약을 제거하는 대신 수용하면서도 "조언봇"을 넘어서는 방법이 Evidence Loop입니다:

• 운영자가 실행기 역할을 맡아 SAP에서 증거를 가져오고,
• AI는 각 턴마다 가설·요청·검증·판정을 담당하며,
• 세션 상태는 파일에 저장되어 중단·재개·인수인계가 가능합니다.

즉, Human-in-the-loop 비동기 루프입니다. 각 턴 사이에 몇 분·몇 시간·며칠이 걸려도 좋고, 다른 운영자가 이어받아도 맥락이 유지됩니다.

🔁 네 개의 턴

┌── Turn 1 · INTAKE ───────────────────────────────────┐
│ 운영자/엔드유저가 초기 증상 + 최소 증거를 업로드       │
│ 산출: Evidence Bundle 1개                            │
│ 세션 상태: intake → hypothesizing                    │
└──────────────────────────────────────────────────────┘
                          ↓
┌── Turn 2 · HYPOTHESIS ───────────────────────────────┐
│ AI가 2~4개 가설 + 각 가설의 반증 조건 + Follow-up    │
│ Request(운영자가 다음 수집할 체크리스트) 생성         │
│ 산출: hypotheses[] + followup_request 1개            │
│ 세션 상태: hypothesizing → awaiting_evidence         │
└──────────────────────────────────────────────────────┘
                          ↓
┌── Turn 3 · COLLECT ──────────────────────────────────┐
│ 운영자가 Follow-up Request의 체크리스트를 SAP에서     │
│ 실행하여 새 Evidence Bundle 업로드                    │
│ 산출: Evidence Bundle 1개 추가                        │
│ 세션 상태: awaiting_evidence → verifying             │
└──────────────────────────────────────────────────────┘
                          ↓
┌── Turn 4 · VERIFY ───────────────────────────────────┐
│ AI가 새 증거로 가설을 확정/기각. 확정 시 Fix + 필수    │
│ Rollback 플랜. 기각 시 새 가설 → Turn 2 재진입.      │
│ 산출: verdict 1개                                    │
│ 세션 상태: verifying → (resolved | hypothesizing)     │
└──────────────────────────────────────────────────────┘

세부 포맷과 예시는 references/turn-formats.md에 있습니다.

📦 데이터 모델

모든 턴의 입출력은 schemas/ 아래 5개 YAML JSON Schema로 정의됩니다:

스키마	언제 생성되는가	어디에 저장되는가
evidence-bundle.schema.yaml	Turn 1, Turn 3	.sapstack/sessions/{id}/bundles/evb-*.yaml
hypothesis.schema.yaml	Turn 2	.sapstack/sessions/{id}/hypotheses/h-*.yaml
followup-request.schema.yaml	Turn 2	.sapstack/sessions/{id}/requests/flr-*.yaml
verdict.schema.yaml	Turn 4	.sapstack/sessions/{id}/verdicts/vdc-*.yaml
session-state.schema.yaml	매 턴 업데이트	.sapstack/sessions/{id}/state.yaml