prompt-compiler

Prompt Compiler Protocol v3.2-ko

Plugin package: prompt-compiler 0.7.1
Protocol spec: v3.2-ko

자연어 요청을 단순히 “더 좋은 문장”으로 고치는 것이 아니라, 요청의 충분성을 먼저 확인하고 사용자의 의도를 보존한 내부 실행 명세로 컴파일해 결과까지 만든다.

사용자의 원래 요청과 더 높은 우선순위의 지침이 항상 기준이다.

언어 아키텍처

이 Skill은 한국어 semantic layer + 영어 canonical machine layer를 사용한다.

한국어로 작성하는 요소:

• 작업 지침과 판단 규칙
• 설명과 예시
• 사용자와의 상호작용
• 사람에게 보여주는 계획과 진단

영어로 유지하는 요소:

• JSON key
• enum
• profile ID
• permission ID
• schema field
• eval label
• script/code identifier
• tool 또는 protocol에서 요구하는 정확한 식별자

예:

• research, analysis, coding
• read, draft, edit, send
• primary_outcome, permission_level, success_check

기계 식별자를 임의로 한국어로 번역하지 않는다.

자세한 원칙은 references/language-policy.md를 따른다.

핵심 파이프라인

다음 흐름을 사용한다.

사용자 요청 → 작업 범위·대기 상태 확인 → Prompt Sufficiency Gate → 내부 실행 명세 → Intent Frame → Complexity Gate → Minimal Task Graph → Execution Contracts → Capability Routing → 실행 → 검증 → 최종 통합

내부 실행 명세, Intent Frame과 Task Graph는 같은 모델 실행 안에서 사용하는 중간 표현(IR)이다. 새로운 사용자 메시지, 별도 모델 호출이나 자동 handoff가 아니며 이 Skill을 다시 호출하는 입력으로 취급하지 않는다.

Prompt Front Door

작업 범위 모드, 질문 후 이어가기, preview 후 승인, 가정과 부분 완료를 다룰 때 references/front-door-modes.md를 따른다. 같은 작업의 후속 요청은 references/task-state-and-delta.md도 읽어 전체 요청을 반복 컴파일하지 않고 변경된 상태와 영향받은 검증만 갱신한다.

Prompt Compiler가 선택되면 원래 요청을 곧바로 실행하지 말고 먼저 다음 세 결정 중 하나를 내린다.

• pass-through: 요청이 충분하다. 의미를 바꾸지 않는 최소 정리만 내부 적용하고 바로 실행한다.
• refine-directly: 영향이 작은 누락만 있다. 안전한 기본값과 현재 맥락으로 내부 실행 명세를 보완하고, 결과에 영향을 주는 가정만 최종 응답에 밝힌 뒤 실행한다.
• clarify-before-compile: 누락 정보에 따라 결과, 권한, 비용 또는 안전성이 실질적으로 달라진다. 가장 정보 가치가 높은 질문만 한 차례 1~3개 묻고 실행을 보류한다.

모든 항목을 채우기 위해 질문하지 않는다. 다음 정보 중 실제 결과를 바꾸는 것만 확인한다.

• 원하는 최종 상태와 산출물
• 대상, 사용 맥락 또는 수신자
• 사용할 입력과 근거
• 포함·제외 범위
• 필수 제약과 권한 경계
• 출력 형식과 검증 기준

질문은 최대 두 차례까지만 반복한다. 이후 남은 정보가 비핵심이면 명시적 가정이나 [확인 필요: ...]로 제한하고 안전한 범위에서 실행한다. 대상, 권한 또는 비가역적 행동의 핵심 정보가 여전히 없으면 이를 만들지 말고 실행을 중단한 채 정확한 blocker를 보고한다.

내부 실행 명세는 사용자가 요청한 경우에만 보여준다. 사용자가 단순히 작업을 요청했다면 컴파일된 프롬프트를 복사해 다시 보내라고 요구하지 말고, 충분해진 요청을 기준으로 바로 실행한다.