FAQ

일반

Optra Prism이란 무엇인가요?

Optra Prism은 AI 지원 코딩을 위한 인텔리전스 레이어입니다. Claude Code에 연결해 AI를 어떻게 쓰고 있는지 보여 주고, 프롬프트 채점, 대시보드 코칭, 사용 분석으로 개선을 돕습니다.

어떤 데이터를 수집하나요?

• OTEL 텔레메트리 — 로그와 메트릭(토큰 수, 시간, 모델 사용, 도구 호출)
• 프롬프트 텍스트 — 프롬프트 채점과 코칭에 사용되는 실제 프롬프트

프롬프트 텍스트는 저장 시 암호화되며 조직으로 스코프가 한정됩니다. 자세한 내용은 개인정보 처리방침을 참고하세요.

코딩을 느리게 만드나요?

플러그인 훅은 가볍습니다:

• 훅 처리: 밀리초 미만.
• ingest 서비스로의 프롬프트 캡처: 비동기, fire-and-forget.
• OTEL 전송: 비동기, 논블로킹.

플러그인은 인라인 LLM 호출을 하지 않으며, Claude Code와 Anthropic 사이에 끼어들지도 않습니다. 요청은 Anthropic으로 바로 갑니다.

플러그인이 터미널에서 인라인으로 코칭하나요?

아니요. 항상 활성화된 어드바이저도, 인라인 조언도 없습니다. 플러그인은 텔레메트리를 수집할 뿐, 터미널에서 프롬프트를 채점하거나 코칭하거나 다시 쓰지 않습니다. 턴이 끝난 뒤 짧은 실시간 요약을 출력할 수는 있지만, show_realtime_summary를 켜지 않으면 나오지 않습니다. 프롬프트별 채점은 서버 측에서 실행되며, 코칭은 대시보드에 나타납니다. 실시간 화면의 Task 어드바이저가 각 서브세션의 등급을 설명하고 다시 쓴 예시를 보여 줍니다. 상세한 리뷰를 원하면 /prism:report를 실행하거나 대시보드의 챕터 기반 리포트를 읽으세요.

플러그인

셋업 후 Claude Code를 재시작해야 하나요?

네. 플러그인은 세션 시작 시 OTEL_* 변수를 settings.json에 기록하고, Claude Code는 그 값을 프로세스 시작 시점에 읽습니다. /prism:setup 실행 후 재시작해야 적용됩니다.

Prism이 내 프롬프트를 차단할 수 있나요?

아니요. submit 훅은 항상 0으로 종료하며 프롬프트를 수정하거나 지연시키지 않습니다. 플러그인이 내놓는 정보는 모두 참고용(advisory)입니다.

실제로 설정할 수 있는 건 무엇인가요?

두 가지입니다. show_realtime_summary(기본값 꺼짐)와 ingest_url(Prism을 직접 운영하는 경우에만). ~/.prism/config.json의 나머지는 자동으로 관리됩니다. 설정을 참고하세요.

API 키가 없으면 어떻게 하나요?

dashboard.optra-prism.com에서 Prism에 가입하고 온보딩을 마치면 키가 자동으로 발급됩니다. 대시보드 헤더의 Connect 패널(Connect Claude Code)을 열면 키가 담긴 셋업 명령이 나오므로, 직접 만들 키도 따로 들어갈 키 페이지도 없습니다. 새 키는 prism_*로 시작합니다(레거시 gck_* 접두사도 여전히 허용됩니다).

디버그 로깅은 어떻게 활성화하나요?

디버그 로그는 항상 ${CLAUDE_PLUGIN_DATA}/debug.log(플러그인 데이터 디렉터리가 없으면 ~/.prism/logs/debug.log)에 기록됩니다. 터미널(stderr)로도 함께 보려면 ~/.prism/config.json에 "debug": true를 넣으세요. 켜짐 여부와 정확한 경로는 /prism:doctor가 알려 줍니다.

ingest 서비스에 도달할 수 없으면 어떻게 되나요?

submit 훅은 fail open 합니다. 프롬프트는 여전히 전달됩니다. OTEL 전송은 내부적으로 재시도합니다. 프롬프트 캡처 실패는 디버그 로그에만 기록되고 화면에는 나타나지 않습니다.

채점

점수는 어떻게 매겨지나요?

Prism은 서브세션마다 네 가지를 확인합니다. 목표에 도달했는지, 이후 그 작업을 다시 해야 했는지, 토큰이 얼마나 들었는지, 그리고 프롬프트를 얼마나 잘 썼는지입니다.

이것이 프롬프트 점수(평균 프롬프트 등급, 0–100에 문자 등급 병기)로 모이고, 그 옆에 완료율(목표를 완료한 서브세션의 비율)이 보조 지표로 붙습니다.

판정을 확신할 수 없는 서브세션은 추측하지 않고 미채점으로 남깁니다.

좋은 프롬프트 점수는 어느 정도인가요?

프롬프트 점수는 프롬프트 평균 등급(0–100)이며, A+ → F 사다리의 문자 등급으로 표시됩니다. 프롬프트별 등급 밴드는 다음과 같습니다:

프롬프트별 등급: A+ 90–100, A 80–89, A− 72–79, B+ 62–71, B 50–61 (기준선), B− 42–49, C+ 34–41, C 24–33, D 12–23, F 0–11.

완료율(완료한 서브세션의 비율)은 그 나름의 티어로 이어집니다. 역량 페이지에도 이름은 같고 기준 점수만 다른 티어가 있으니, 어느 쪽인지 옆에 적힌 이름을 함께 확인하세요.

완료 티어(0–100):

• 90–100 — 최상위
• 70–89 — 전문가
• 50–69 — 숙련
• 30–49 — 실무자
• 0–29 — 초보

팀의 완료율은 팀 집계 crushed/total이며, 사용자별 비율을 평균 낸 값이 아닙니다.

보편적인 “좋은” 수치는 없습니다. 자신의 추이를 지켜보고, 가장 자주 실패하는 프롬프트 루브릭 항목에 집중하세요.

점수가 내 Claude Code 경험에 영향을 주나요?

아니요. 점수는 정보 제공용입니다. 접근을 제한하거나, 모델 동작을 바꾸거나, 과금에 영향을 주지 않습니다.

세션은 얼마나 자주 채점되나요?

채점은 서브세션이 닫히는 즉시 시작되고, 결과는 대략 1–10분 안에 대시보드에 반영됩니다. 하루 한 번 같은 고정 일정으로 도는 것은 없으니, 방금 끝낸 작업이 아직 안 보인다면 몇 분만 기다려 보세요.

일곱 개 루브릭 항목이 모든 프롬프트에 적용되나요?

아니요. 각 프롬프트는 먼저 무엇을 하려던 것인지(질문, 버그 수정, 계획, 리팩터링 등)로 분류되고, 그 종류에 맞는 항목만 적용됩니다. 예를 들어 단순 질문은 테스트를 요청하지 않았다고 감점되지 않습니다. 적용되지 않는 항목은 그냥 건너뛸 뿐, 감점으로 이어지지 않습니다.

대시보드

왜 데이터가 보이지 않나요?

흔한 원인:

1. 플러그인 미구성 — /prism:setup prism_YOUR_KEY를 실행하세요.
2. 세션이 너무 최근 — ingest, 채점, 분석 캐시를 위해 1–5분 기다리세요.
3. API 키 문제 — /prism:status로 확인하세요.
4. 방화벽이 OTEL 전송을 차단 — 텔레메트리 수집에는 ingest.optra-prism.com으로의 아웃바운드 HTTPS가 필요합니다.

팀이 내 프롬프트를 볼 수 있나요?

매니저는 팀 단위 사실(무엇을 했는지, 사용량, 비용)을 봅니다. 개별 프롬프트 텍스트는 매니저에게 보이지 않으며, 개인 등급과 코칭은 본인의 일일 리캡과 리포트에만 있습니다.

인사이트를 팀과 어떻게 공유하나요?

리포트로 내보내지 않는 한, 인사이트는 본인만 확인할 수 있습니다. 팀에 전달되는 길은 두 가지입니다.

• 리포트를 파일로 내보내 직접 전달하세요. 개인 리포트는 Markdown, Word(.docx), PDF로 내보낼 수 있습니다.
• 팀 기능을 통해 팀 매니저에게 공유됩니다. 매니저는 Team Console에서 팀 요약, 성과, 비용 같은 팀 단위 사실을 봅니다. 접근 권한은 조직 역할로 정해지며, 개별 프롬프트 원문과 등급·코칭은 이 경로로도 공개되지 않습니다.