평가 질문 하나를 선택하고 지원 경로를 따라 증거를 기준과 비교한 뒤 비용·리소스·미해결 문제를 정리합니다.
한국어 검토판 · 기록 예제: 로컬 R234 · 기존 운영자의 재현에는 일치하는 승인된 설치 필요.
Guide Pack이 처음입니까?구조·안전한 사용 경계·Packtory 목록 등록 목적 보기 → 문서 패키지이며 읽는 것만으로 제품 작업 권한을 부여하지 않습니다.
비공개 계획·출처가 연결된 관찰 기록·검토 결론을 완성하는 경로입니다. 기존 로컬 R234 예제를 읽으며 제품 요청을 보내지 않습니다. 기존 설치를 직접 사용하려면 준비 자료를 완성한 뒤 별도 운영 경로를 따릅니다.
실제 환경에 맞게 Online 또는 Offline을 선택합니다. Online은 승인된 네트워크 접근을 사용합니다. Offline은 폐쇄 온프렘용 선택 사항으로 반입 전에 호환 제품·컴파일러·네이티브 도구 체인·선언된 의존성을 준비해야 합니다. 문서 다운로드에는 이 패키지가 없습니다.
빈 워크시트를 내려받아 guide-practice-01 같은 새 폴더에 비공개 작업 사본으로 저장합니다. JSON은 UTF-8 텍스트 편집기로 열고 따옴표와 미관찰 필드의 null을 유지하며 .json.txt가 아닌 .json으로 저장합니다. 워크시트는 기록 문서이며 제품 요청이 아닙니다. SDK나 Helper에 제출하지 마십시오.
수행할 작업: poc-plan.blank.json을 내려받습니다. route를 retained-reading으로 정하고 기록된 Work 하나를 JSON·PDF 보고서와 인수 상태까지 추적할 수 있는가를 질문으로 적습니다. 답을 판단할 기준을 정하고 실제 환경·실행 필드는 null로 둡니다.
결과 확인: 저장한 계획에 읽기 질문·검토자 역할·한계가 있습니다. 고객 배포나 AI 품질 입증 여부를 이 읽기 질문에 섞지 않습니다.
일치하지 않을 때: 질문에 자체 데이터·비용·공급자 동작이 필요하면 별도의 향후 PoC로 기록하고 지원 설정을 먼저 확보합니다.
수행할 작업: 아래의 기록된 Work 독해 자료를 엽니다. 성공 제출 전 1–3단계부터 읽고 health 종료 1·READY 생존 상태·UNKNOWN 준비 및 런타임·거부된 의도·빈 Work 목록을 기록합니다. 이 읽기 경로에서는 명령을 터미널에 복사하지 않습니다.
결과 확인: 기록에 기준 상태·준비 실패·실제 실행이 구분됩니다. 세션 메타데이터가 남았으므로 실패 시도를 무변경으로 적지 않습니다.
일치하지 않을 때: 발췌에 없는 필드는 미관찰로 둡니다. 빠진 결과를 재구성하거나 UNKNOWN을 허가로 취급하지 않습니다.
수행할 작업: 4–5단계에서 제출·목록 및 상세·선택 보고서의 기록된 Work ID를 비교합니다. execution_count 1·validation_results PASSED·최종 결과 문자열을 기록하고 관찰 필드에 출처 URL을 적습니다.
결과 확인: 관찰이 과거 Work 하나와 LOCAL R234에 연결됩니다. 반복되는 ID는 독해 참조이며 다음 작업에서 쓸 ID나 키가 아닙니다.
일치하지 않을 때: 식별자가 다르면 비교를 미해결로 두고 선택한 Work·리비전을 확인합니다. 서로 다른 보고서를 합쳐 완료 기록을 만들지 않습니다.
수행할 작업: 6단계와 5단계 보고서 필드를 읽습니다. 과거 JSON·PDF 지문은 일치했다고 기록되어 있고 human_acceptance는 null입니다. 원본 파일을 직접 다시 계산했다고 적지 말고 과거 파일 확인 기록을 인용합니다.
결과 확인: 기록에 AUTOMATION_COMPLETED_HUMAN_ACCEPTANCE_PENDING과 남은 사람 결정을 명시합니다. 프로세스 종료 0만으로 인수이 종결되지 않습니다.
일치하지 않을 때: 자체 보고서 파일은 Part.8의 동일 Work·지문 절차를 따릅니다. 파일이 없거나 읽을 수 없으면 해당 확인은 미완료로 둡니다.
수행할 작업: poc-reading.example.json을 열어 질문·출처·보고서 부분·설명용 검토 결론을 자신의 기록과 비교합니다. 배운 내용과 근거를 적되 미관찰 운영 필드에 미리 작성된 통과를 복사하지 않습니다.
결과 확인: 독자가 무엇이 성공했는지·이전 실패·남은 대기 상태·사실이 속한 환경을 설명할 수 있습니다.
일치하지 않을 때: 설명할 수 없는 값은 추정하지 말고 인용 단계로 돌아갑니다. 더 넓은 평가 계획은 아래 11단계 상세 가이드를 사용합니다.
수행할 작업: 읽기 완료·실제 운영 미평가·기록 보존 위치·누락 전달 및 관리자·공급자 준비의 다음 담당자를 적습니다. 실제 시험은 아래 공통 PoC의 인계·기준 상태 단계를 따르고 지원·승인된 경우에만 한 번 제출합니다.
결과 확인: 제품 인수 상태를 바꾸거나 자원을 구성하지 않고 완성된 독해 기록과 다음 조치를 남깁니다.
일치하지 않을 때: 운영 제출이 시간 초과 또는 결과 불명이면 추가 시도 전에 원래 Work·키를 확인합니다. 새 폴더라고 중복 제출이 안전해지는 것은 아닙니다.
과거 출력 발췌이며 자신의 설치에 대한 기대 응답이 아닙니다. 작성 예시는 이 제품 필드를 바꾸지 않고 사람의 독해 결정을 더합니다.
{
"work_id": "work-headless-c36fddb388d8599d9f5e70e40296eae13ccfa8ddaccf3976daacfa18e2ce373e",
"execution_count": 1,
"final_result": "AUTOMATION_COMPLETED_HUMAN_ACCEPTANCE_PENDING",
"validation_results": "PASSED",
"closure": {
"disposition": "AWAITING_HUMAN_ACCEPTANCE",
"human_acceptance": null,
"human_acceptance_required": true
}
}보존 사례는 명시된 릴리스·환경의 이미 공개된 관찰을 인용합니다. 절차 예시는 대응 방법 설명이며 추가로 관찰한 사고가 아닙니다. 이 가이드 작성을 위해 제품을 실행하지 않았습니다.
보존된 실제 관찰 사례
증상: PACKR_OPERATOR_STATUS_UNAVAILABLE에 SEMANTIC_INTENT_TYPE_UNRESOLVED가 포함되었습니다. 이전 의도에 필요한 audit 용어가 없었습니다.
증거의 의미: 보존된 준비 오류에서는 해당 범위의 Work·입장·실행·보고서 행이 생기지 않았지만 세션 메타데이터는 남았습니다. 장애 원인 전체를 뜻하거나 모든 실패가 무변경임을 보장하지 않습니다.
완료 또는 재개 확인: 실행 주장에는 나중에 관찰한 Work·결과가 필요합니다. 과거 성공 입력 쌍은 CREATE_AUDIT_ARTIFACT / create audit artifact였습니다.
보존된 실제 관찰 사례
증상: 로컬 R234 health 명령은 service_state가 RUNNING이고 liveness가 READY인 상태에서도 종료 코드 1을 반환했습니다.
증거의 의미: 준비 상태와 런타임은 각각 사유 코드가 있는 UNKNOWN이었습니다. 서비스 존재와 운영 권한은 서로 다른 관찰입니다.
완료 또는 재개 확인: 해당 타깃에 제공된 지원 준비·입장 절차가 충족될 때만 제안 작업을 재개합니다.
보존된 실제 관찰 사례
증상: validation_results PASSED와 AWAITING_HUMAN_ACCEPTANCE·human_acceptance null이 함께 기록되었습니다.
증거의 의미: 관찰 결과는 자동화 완료와 사람 인수 대기입니다. 독해 결론은 제품 인수 이벤트가 아닙니다.
완료 또는 재개 확인: 실제 반환된 인수 기록만 해당 제품 상태를 종결할 수 있으며 워크시트 수정으로는 종결되지 않습니다.
대응 절차 예시 · 새 관찰 사고 아님
증상: 설명용 증상: JSON은 한 Work·리비전을 가리키는데 PDF는 다른 저장 결과에서 선택했습니다.
증거의 의미: 추가 관찰 사고가 아닌 문제 해결 절차입니다. JSON 파일 지문·PDF 지문·보고서 식별자는 비교 대상이 서로 다릅니다.
완료 또는 재개 확인: 식별·지문·가독성이 맞을 때만 확인을 마치며 일치를 만들기 위해 매니페스트를 수정하지 않습니다.
계획·출처 연결 관찰·검토 결론·미해결 인계를 보존합니다. 읽기 완료는 선택한 질문의 답이며 새 설치·고객 AI 품질·비용·사람 인수을 입증하지 않습니다.
가이드에서 목적을 고른 뒤 해당 Part에서 정확한 도구 단계를 확인합니다. 두 문서는 같은 순서·용어·자료 역할을 사용합니다.
질문을 정하고 범위에 맞는 관찰을 모아 결과를 검토합니다. 보존 기록 독해에는 신규 설치가 필요하지 않습니다.
정확한 심사 전달물과 기준 증거를 연결합니다. Cloud 접근·문서 범위·실제 Google 승인은 각각 구분합니다.
정확한 OS·패키지·네트워크 선택·도구 체인을 준비합니다. 로컬 SDK 준비 요건이 제공된 뒤에만 해당 단축 경로를 사용합니다.
지원 작업을 선택합니다. 소스 문서 준비·전체 SDK 후보·실제 Work 및 보고서 확인을 서로 다른 경로로 구분합니다.
Helper B는 구현·새 Pack 필요 여부를 결정하기 전에 완성된 선언을 확인합니다. 구현·선언 변경 후에는 영향을 받은 지원 검사를 다시 수행하고 별도 구현·등록·Pack 승인 경로를 마친 뒤 사용합니다. 생성 후보는 운영 권한을 부여하지 않습니다.
목표에 필요한 경로만 선택합니다. 보존 PoC 독해는 설치 없이 시작할 수 있습니다. 제공된 로컬 SDK 실습은 Part.1 → Part.5를 따르며 새 GAPE 관찰·어플라이언스 계정이 필요하지 않습니다. 기존 승인 Pack은 현재 준비 요건 확인 후 Part.1 → Part.7 → Part.8을 따를 수 있습니다. 새 연동·Pack 작성은 조건부 전체 순서를 따릅니다.
| 구성 요소 | 역할과 기대 범위 |
|---|---|
| Part.1 · 설치·초기 연결 | OS 준비·제공 패키지·초기 연결입니다. 설치는 실행된 Work가 아닙니다. |
| Part.2 · GAPE 관찰·비교·공유 | 리비전에 고정된 구조 관찰입니다. 워크시트는 승인된 GAPE 입력 매니페스트가 아닙니다. |
| Part.3 · Integration Helper 사용 | A는 Document 작성 전 계획, B는 완성된 전체 요청 확인입니다. 단계마다 타입이 있는 status·reason을 읽습니다. |
| Part.4 · Contract·Document 작성 | 소스 Document·매핑을 작성하고 제공된 대상 Contract·리비전을 사용합니다. JSON 구문만으로 의미상 호환성이 확인되지 않습니다. |
| Part.5 · SDK Engine 실습·연동 후보 | 로컬 SDK 구현 후보를 생성합니다. 기존 구현·등록·릴리스 호환 연동이 요구를 충족하면 재사용합니다. |
| Part.6 · Builder·추가 Pack 사용 | 새 Pack이 필요할 때 Pack 후보를 준비합니다. 목표·설치 범위에 맞는 기존 승인 Pack은 재사용합니다. |
| Part.7 · PackrGUI·헤드리스 사용 | 현재 권한·사전 조건에 따라 제공 GUI·헤드리스 경로를 사용합니다. 반환된 Work 식별·결과를 확인합니다. |
| Part.8 · 운영·문제 해결·지원 | 동일 Work 산출물·영수증·종결을 비교하며 사람 인수은 실제 기록될 때까지 대기로 유지합니다. |
status.read 소스 전용 예제와 read_quality SDK 실습은 서로 다른 예제입니다. 일치하는 전체 요청을 사용하고 status 소스 파일을 quality SDK 전체 요청으로 제출하지 않습니다. 아래 매핑 값은 설명을 위한 기대값이며 새 실행 캡처가 아닙니다.
| 파일 / 역할 | 입력 | 출력 / 확인 |
|---|---|---|
status-document.jsonstatus.read의 소스 전용 CUSTOM_API 선언입니다. 제공된 전체 준비 요청 안에서 사용합니다. | service: string(문자열) | service: string·healthy: boolean을 선언합니다. 스키마이며 관찰된 서비스 응답이 아닙니다. |
read-only-custom-api.json / custom-api-01.json유지관리되는 전체 SDK 기준 요청이며 가이드 사본은 같은 JSON입니다. | fixture.response.component = "fixture-component"; score = "97" (문자열) | STRING_TO_INTEGER는 score를 기대 정수 quality_score 97로 매핑합니다. 문서의 SDK 결과는 로컬 후보입니다. |
custom-api-02.jsonfixture 응답 값 두 개만 바꾼 두 번째 전체 SDK 요청입니다. | component = "my-test-component"; score = "88" (문자열) | 기대 매핑 component는 "my-test-component", quality_score는 정수 88입니다. 실제 매니페스트·단계를 확인하며 매핑 소스는 같을 수 있습니다. |
custom-api-score-number.json정상 기준 예제가 아닌 의도적 오류 입력입니다. | 선언된 문자열 스키마에 fixture.response.score = 88 (JSON 숫자) 사용 | 실제 타입 오류 결과를 보존하며 이 예제를 성공 후보로 기록하지 않습니다. |
Worksheet / SDK artifacts / Work reports사람 기록·로컬 컴파일 후보·실제 Work 및 보고서·영수증이라는 서로 다른 산출물 종류입니다. | 해당 도구·현재 타깃을 사용하며 워크시트·이전 결과를 다음 전체 요청으로 제출하지 않습니다. | 실제 입력·버전·후보 또는 Work 식별에 출력을 연결합니다. 파일 존재·종료 0만으로는 충분하지 않습니다. |
사용자가 제공한 구조 개요입니다. 도구 패널은 필수 실행 순서가 아닌 상호 보완 역할을 설명합니다. 원본의 Legacy SDK planned·릴리스별 문구는 유지되며 현재 SDK 가용성은 Part.5와 실제 제공 패키지로 확인합니다. 이 그림은 권한·런타임 증거가 아닙니다. 현재 표시본은 문서 변경을 반영한 영문 SVG이며, 이전 래스터 원본은 보존합니다.
최신 설치·도구 실습·문제 해결은 Part.1–8을 따르십시오. 아래 보존 예제와 워크북은 원래 릴리스·목적·관찰 범위를 유지합니다.
Helper B는 구현·새 Pack 필요 여부를 결정하기 전에 완성된 선언을 확인합니다. 구현·선언 변경 후에는 영향을 받은 지원 검사를 다시 수행하고 별도 구현·등록·Pack 승인 경로를 마친 뒤 사용합니다. 생성 후보는 운영 권한을 부여하지 않습니다.
목표에 필요한 경로만 선택합니다. 보존 PoC 독해는 설치 없이 시작할 수 있습니다. 제공된 로컬 SDK 실습은 Part.1 → Part.5를 따르며 새 GAPE 관찰·어플라이언스 계정이 필요하지 않습니다. 기존 승인 Pack은 현재 준비 요건 확인 후 Part.1 → Part.7 → Part.8을 따를 수 있습니다. 새 연동·Pack 작성은 조건부 전체 순서를 따릅니다.
설치 릴리스와 호환되며 구현·등록된 기존 연동이 요구를 충족할 때만 SDK 작성을 생략합니다. 기존 승인 Pack이 목표와 설치 범위를 충족할 때만 Builder 제작을 생략합니다. 어느 경우든 선언 확인·연동 검증·결과 검토는 수행합니다.
Online은 해당 설치에서 승인한 네트워크 접근을 사용합니다. Offline은 폐쇄 온프렘용 선택 사항이며, 반입 전에 정확한 OS·타깃 도구 체인과 의존성 세트를 준비합니다. 매뉴얼 ZIP에는 문서와 합성 입력이 있으며 제품 바이너리나 Rust 도구 체인은 없습니다.
실행 전에 목표 하나, 정확한 전달 버전, 네트워크 모드, 허용 작업, 기대 출력과 검토자를 기록합니다. 읽기 평가는 작성된 독해 기록으로 마칠 수 있지만 운영 PoC에는 지원되는 설치와 실제 결과 증거도 필요합니다.
기존 승인 Pack은 호환성을 확인하고 검증·운영으로 진행합니다. 새 연동은 Document·공개 대상 참조를 완성하고 Helper B로 확인한 뒤 구현이 필요한 경우에만 SDK 후보를 만듭니다. 필요한 Builder Pack 승인·운영 전에 별도 검토·등록 경로를 마칩니다. 생성 소스·워크북만으로 연동이 등록되거나 Work 실행이 입증되지는 않습니다.
운영 준비물이 없으면 계획 결과를 보존하고 누락 항목·담당자·재개 조건을 기록합니다. 첫 실패 시도를 보존하며 시간 초과나 결과 불명 제출은 원래 결과를 확인하기 전 반복하지 않습니다.
설치·증거가 뒷받침하는 경로를 선택합니다. 명확한 결과 하나로 판단할 수 있게 질문 범위를 작게 유지합니다.
| 입력 | 담당자 | 확인 |
|---|---|---|
| 정확한 전달 버전·지원 설치 경로 | 전달 담당자 | 대상과 일치. 신규 r232 첫 관리자 C7은 미해결 |
| 허용 작업 하나·인수 기준 | PoC 담당자 및 제품 관리자 | 작성된 범위·작업 권한. health만으로 추정하지 않음 |
| 클라이언트·서비스·계정·엔드포인트 | 어플라이언스 운영자 | 일치하는 로컬 클라이언트/서비스·제공 소켓. 시작 절차를 만들지 않음 |
| 비기밀 입력·보존 선택 | 데이터 담당자 | 승인 입력·비공개 보고서 처리 |
| 필요한 경우 AI 모델·ID·네트워크·비용 | 클라우드·AI 담당자 | 지원 고객 절차·실제 작업 검증. 로컬 감사로 입증되지 않음 |
| 보고서 접근·사람 검토 | 서비스 운영자 및 지정 검토자 | 승인된 열람 가능 산출물·명시적인 검토 책임 |
누락 입력을 담당자·재개 조건과 함께 문제 인계에 기록합니다. 비밀 대신 참조를 저장합니다.
기존 6단계 해설은 로컬 Work 하나·JSON/PDF 보고서·사람의 인수 대기를 추적합니다. 점검할 내용을 이해하는 데 사용합니다.
작성 예제는 인용한 과거 사실을 바탕으로 만든 설명용 워크시트이며 새 실행·고객 결과가 아닙니다.
지출·제출 전에 평가로 무엇을 배울지 합의합니다.
기록된 예제를 고객 설치 절차로 취급하지 않습니다.
보존 예제의 동작·결과·한계 파악.
설정 명령을 만들지 않고 요건을 충족한 재현을 구체화합니다.
제출 전에 실제 상태·구성 요소 사유를 기록합니다.
PACKRCTL="/ABSOLUTE/SUPPLIED/PATH/packrctl"
SOCKET="/ABSOLUTE/SUPPLIED/PATH/control-plane.sock"
"$PACKRCTL" --help
"$PACKRCTL" --socket "$SOCKET" status --json > status.json
STATUS_EXIT=$?
"$PACKRCTL" --socket "$SOCKET" health --json > health.json
HEALTH_EXIT=$?
printf 'status_exit=%s\nhealth_exit=%s\n' "$STATUS_EXIT" "$HEALTH_EXIT"의도한 Work 하나를 만들고 반환 식별자를 보존합니다.
WORK_KEY="REPLACE_WITH_ONE_UNUSED_APPROVED_KEY"
"$PACKRCTL" --socket "$SOCKET" work run CREATE_AUDIT_ARTIFACT "create audit artifact" "$WORK_KEY" --json > work-run.json
RUN_EXIT=$?
printf '%s\n' "$RUN_EXIT"두 번째 실행을 복구로 오인하지 않도록 합니다.
WORK_ID="PASTE_EXACT_result.work.work_id_FROM_work-run.json"
"$PACKRCTL" --socket "$SOCKET" work list --limit 10 --json > work-list.json
"$PACKRCTL" --socket "$SOCKET" work show "$WORK_ID" --json > work-show.json자동화 완료와 사람의 인수을 구분합니다.
정확한 Work·리비전의 읽을 수 있는 산출물을 검토합니다.
REPORT_JSON="PASTE_EXACT_selected_report.json_path"
REPORT_PDF="PASTE_EXACT_selected_report.pdf_path"
shasum -a 256 "$REPORT_JSON" "$REPORT_PDF"제품 인수을 암묵적으로 바꾸지 않고 원래 PoC 질문에 답합니다.
필수 결과를 보존하고 리소스를 합의한 상태로 남깁니다.
자신의 PoC에는 빈 파일을 사용합니다. 작성 예제는 별도로 표시했습니다.
평가 기준과 수정된 기준 기록은 현재 워크북을 사용하세요.
새 작성 예제는 계획·증거 검토·비용 적용·미해결 문제·최종 사람 메모까지 동일 기준을 따릅니다.
작성 예제 열기 →과거 기록이 일반적인 허가는 아닙니다. 해당 실습에는 별도 승인이 있었고 정상 실행 허용 절차가 그 작업을 평가했습니다. 제출 전에 자신의 필수 준비 상태·권한을 해결합니다.
아닙니다. 문서 패키지이며 등록된 페이로드·설치된 Pack·권한 부여·제품 실행이 아닙니다.
이 등록 작업은 구조화된 로컬 감사 산출물을 만듭니다. 임의의 첨부 내용을 점검하지 않습니다.
키·요청 맥락을 보존하고 동일 설치·계정에서 원래 Work를 대조합니다. 대체 제출·자동 재시도를 하지 마십시오.
아닙니다. 별도 수정된 작업 전용 후보·일회성 대상을 사용했습니다. Golden 변경·고객 초기 설정·승계된 운영 기능이 아닙니다.
버전·단계·기대/관찰 동작·시각·민감정보를 제거한 사유와 필요한 최소 Work/보고서 참조를 보냅니다. 자격 증명·원시 보고서·비공개 경로·전체 로그·고객 페이로드는 제외합니다.
평가할 AI 작업 흐름 하나와 대상 실행 경계·승인 요건을 정리하세요. 기록된 로컬 R234 사례와 비교하거나 구조화된 PoC 평가 순서를 따르고, 2026년 10월 18일 영문·한국어 기술 백서를 참고하세요.
연락 경계 안내: “평가 문의”를 클릭하면 로컬 메일 프로그램이 다음 수신 주소로 열립니다: support@vibepackr.com 로 구조화된 문의 양식이 열립니다. 이메일 전송만으로 지원 사례가 등록되거나 어플라이언스가 구성되지는 않습니다. 자격 증명·개인정보·기밀 로그를 포함하지 마십시오.