01 · 아키텍처 관찰·작성 보조·AI 실행 중 필요한 경로 선택
GAPE는 범위가 정해진 아키텍처 사실을 관찰하고 정합합니다. 구현된 R1 경로는 선언된 커밋 소스 입력을 읽어 AI 제공자를 호출하지 않고 결정적인 투영을 만듭니다. 이 GAPE 작업 자체를 수행하는 데 Vertex AI 연결이 필요한 것은 아닙니다.
AI 보조 도구로 승인된 public-safe 투영을 읽거나 통합 문서 초안을 작성할 수 있습니다. 허용된 자료를 제공하고 제안된 해석을 검토하세요. AI의 답변이 제품 Contract나 실행 권한으로 바뀌지는 않습니다.
VibePackr의 Vertex AI 연동은 별도의 제품 실행 경로입니다. 프로젝트·리전·모델·승인된 서비스 계정 선택과 제품의 런타임 바인딩·실행 허용 확인이 필요합니다. GAPE 다이어그램이나 에이전트 프롬프트가 이 경로를 설정하지는 않습니다.
| 목표 | 경로 | 첫 산출물 |
|---|---|---|
| 구조 이해 | GAPE 관찰 → 제공된 public-safe 투영 | 승인된 읽기용 내보내기. |
| 연동 준비 | 사람 + AI 보조 도구 → 검토한 문서 | status.read 예제. |
| 제품에서 AI 작업 실행 | 승인 제품 요청 → 설정된 런타임 → Vertex AI | 지원 바인딩·설정과 실제 Cloud 계정. |
02 · 같은 작은 사례를 에이전트별로 준비
서비스 상태 읽기 연습 파일을 내려받으세요. 가상의 요청·응답 하나로 필드 구분을 연습할 수 있습니다. Contract, Document, Helper 요청, 관찰한 API 응답, 동작하는 통합 파일은 아닙니다.
이 파일과 공개 Integration Helper 가이드를 조직이 허용한 에이전트에 제공하세요. 아래에서 작업에 맞는 절차를 선택하세요. 이 연습은 텍스트 검토만 요청하며 새 커넥터·MCP 서버·provider 호출·제품 설치가 필요하지 않습니다.
기대 산출물은 근거가 있는 검토표 또는 수정 초안입니다. 인용한 필드를 제공한 파일과 대조하세요. 에이전트가 필드·엔드포인트·자격증명·성공 실행·승인을 만들어 냈다면 그 주장을 받아들이지 말고 필요한 정보를 표시하도록 요청하세요.
프롬프트는 작업 지시이며 강제 수단이 아닙니다. 승인된 클라이언트 설정을 사용하고 실제 동작을 확인하세요. 이 절차는 고객 에이전트 설치에서 실행하지 않았으며 이 가이드는 특정 클라이언트 버전을 인증하지 않습니다.
동일한 상태 조회 사례의 설명용 값입니다. Helper 요청이나 관측 응답이 아닙니다.
{
"case": "service-status-reading-exercise",
"operation": "status.read",
"input": {
"service": "demo-service"
},
"illustrative_response": {
"service": "demo-service",
"healthy": true
},
"instruction": "Fictional reading exercise only. This is not a Contract, Document, Helper request, agent configuration, observed response or product success record."
}
기계 형식 검토에는 실제 CUSTOM_API 문서도 내려받습니다. 가상 요청·응답 연습과 기계 문서는 별도 파일로 유지하며 같은 status.read 사례의 필드를 설명합니다.
03 · 에이전트별 절차·검증 범위
승인된 보조 도구로 제공 문서를 검토하는 방법입니다. VibePackr 인증 커넥터 목록이 아닙니다. 자체 시험 전에 클라이언트 버전을 기록하세요. 확인 가능한 공급자 설정 문법은 2026-10-03에 대조했습니다.
| 에이전트 | 제공할 자료 | 출력 검토 | 증거 범위 |
|---|---|---|---|
| Codex | 공개 가이드와 가상 서비스 상태 읽기 연습 | 관찰한 필드·누락된 공개 스키마 정보·다음 로컬 확인·미실행 사항 | 클라이언트 버전 미검증 · 텍스트 검토 절차 |
| Claude Code | 실제 비밀 제거 Helper 오류와 대응하는 공개 문제 해결 절 | 근거가 있는 설명과 최소 수정 제안 · 적용하지 않음 | 클라이언트 버전·설정 미검증 · 텍스트 검토 절차 |
| Cursor | 허용된 원본·대상 선언 사본과 공개 필드 참조 | 미확정 정보를 드러낸 필드 매핑 검토 | 클라이언트 버전 미검증 · 공급자 MCP 문법은 별도 확인 |
| 일반 MCP 클라이언트 | 승인된 서버에서 이전에 확보하고 비밀을 제거한 initialize/tools-list 관찰 | 관찰 목록과 호환성 확인 질문 | 클라이언트·서버·프로토콜 리비전 기록 필요 · 연결 호환성 미검증 |
04 · Codex: 목적별 검토 절차
- 공개 가이드와 가상 서비스 상태 읽기 연습
- 작업 문맥에 두 파일을 제공하고 Codex 검토 프롬프트를 붙여 넣으세요. 인용 필드를 입력과 대조하세요.
- 관찰한 필드·누락된 공개 스키마 정보·다음 로컬 확인·미실행 사항
텍스트 검토용이며 특정 클라이언트 버전·연결을 인증하지 않습니다.
Review the attached service-status-reading-exercise.json and the approved public Integration Helper guide.
This is a documentation review task; do not run commands, install tools, open network connections, or edit files.
1. Separate the example's operation, request fields, and response fields.
2. Explain the role of Contract, Document, and Integration Helper using only the supplied guide.
3. List which exact input fields require a supplier-approved schema before a Helper request can be built.
4. For every conclusion, cite the input filename and JSON key or guide section.
5. Label any missing fact UNKNOWN. Do not invent contract IDs, endpoints, registry entries, credentials, or success output.
Return four headings: Observed input; Missing input; Proposed next local check; Not executed.
This prompt does not register, submit, execute, or approve any product operation.
검토 수락 기준: 입력 service , 설명용 응답 service/healthy 를 구분하고 제공 키를 인용하며, 실제 제공되지 않은 대상 Contract 값은 미확인으로 남깁니다. 그럴듯하게 새로 만든 요청은 기대 결과가 아닙니다.
05 · Claude Code: 목적별 검토 절차
- 실제 비밀 제거 Helper 오류와 대응하는 공개 문제 해결 절
- 허용된 오류·문맥만 제공하고 Claude Code 오류 검토 프롬프트를 붙여 넣으세요. 수정 제안을 검토하기 전에 인용한 stage·reason을 확인하세요.
- 근거가 있는 설명과 최소 수정 제안 · 적용하지 않음
텍스트 검토용이며 특정 클라이언트 버전·연결을 인증하지 않습니다.
Review only the supplied redacted Helper error text and the approved public troubleshooting guide.
Do not execute commands, read other project files, install packages, contact a provider, or edit configuration.
Quote the exact error stage and reason if present; write UNKNOWN for missing fields.
Explain what the error establishes and what it does not establish.
Propose the smallest correction to the supplied input as a draft for human review; do not invent schema fields.
If the required public schema is missing, list the missing schema/version rather than constructing a replacement.
Finish with a table: Observation | Evidence | Suggested correction | Verification still needed.
Do not claim that a proposed correction has been executed or that registration/execution succeeded.
기록된 SCHEMA_INCOMPATIBLE 예제 와 누락된 uptime 속성 설명을 제공합니다. 실제 필요한 원시 타입 속성을 정의하거나 required에서 제거하는 제안이 유용합니다. 에이전트가 Helper를 다시 실행했다고 주장하지 않는지 확인하세요.
06 · Cursor: 목적별 검토 절차
- 허용된 원본·대상 선언 사본과 공개 필드 참조
- 파일을 검토 문맥으로 제공하고 매핑 프롬프트를 붙여 넣으세요. 필드·자료형 표를 확인하고 편집 전에 텍스트 수정안을 검토하세요.
- 미확정 정보를 드러낸 필드 매핑 검토
텍스트 검토용이며 특정 클라이언트 버전·연결을 인증하지 않습니다.
Review the two supplied copies of the service-status declaration/example and the approved public field reference.
Stay in review mode: do not edit files, run a terminal command, enable MCP tools, or contact any service.
Build a mapping table: source field | target field | type | mapping supported by the supplied reference | open question.
For example, determine whether service is actually declared on both sides; do not assume similar names are compatible.
Keep missing required fields visible. Do not supply guessed credentials, contract identifiers, or endpoint paths.
Show a proposed textual diff only if the reference establishes the correct field; otherwise explain what information is needed.
End with Not executed: no Helper command, registration, provider call, or product operation.
처음에는 설명용 매핑 표를 사용합니다. 실제 대상 문서는 지원 패키지에서 받아야 합니다. 대상이 없을 때 올바른 검토는 호환성 미확인을 표시하며 대상 열을 추측한 이름으로 채우지 않습니다.
07 · Generic MCP client: 목적별 검토 절차
- 승인된 서버에서 이전에 확보하고 비밀을 제거한 initialize/tools-list 관찰
- 프롬프트로 저장된 관찰을 검토하세요. 실제 프로토콜·도구 스키마를 기록하고 Helper가 지원하는 입력 리비전과 대조하세요. 빈틈을 채우기 위해 tools/call을 호출하지 마세요.
- 관찰 목록과 호환성 확인 질문
텍스트 검토용이며 특정 클라이언트 버전·연결을 인증하지 않습니다.
First label the supplied transcript SYNTHETIC_EXAMPLE or CAPTURED_OBSERVATION based on its stated provenance; use UNKNOWN if not supplied.
Review the supplied MCP initialize and tools/list transcript. If captured, identify the separately approved server from the supplied record; if synthetic, preserve that label.
Do not connect to a server or call a tool. Do not infer an endpoint or authentication method from these files.
Record the observed protocol version, server name/version, offered tool names, and inputSchema fields.
Mark missing, incomplete, paginated, or redacted observations explicitly.
Check that each required field and its type is described; do not call tools/call to discover behavior.
Explain which facts are observations and which compatibility checks remain pending for the supplied Helper release.
An advertised tool does not prove that it is authorized, callable, safe, or supported by VibePackr.
Return a review table, not a fabricated successful tool response.
다운로드할 합성 기록 으로 서버 연결 없이 읽기 연습을 할 수 있습니다. 확인할 내용은 리비전 2025-03-26, 도구 status.read , 선언한 원시 필드 형태입니다. 합성 자료임을 표시하세요. 실제 관측이면 협상 리비전과 클라이언트·서버 버전을 보존하며 읽기 연습에서 tools/call 을 호출하지 않습니다.
08 · GAPE: 구조 관찰 후 제공된 투영 설명
검토용으로 제공된 승인된 public-safe 내보내기 파일만 사용하세요. public-safe 뷰어와 JSON에는 익명 구성요소·관계·정합 상태가 들어 있습니다. 엔지니어링 스냅샷·매니페스트·소스 참조는 다른 산출물이며 이 연습에 포함되지 않습니다.
에이전트에게 표시된 관계를 나열하고 구성요소 또는 관계 ID를 근거로 달도록 요청하세요. 관찰과 해석을 별도 열로 나누고 UNRESOLVED, STALE, CONSISTENT 같은 상태는 원문 그대로 유지하세요.
UNRESOLVED는 비교가 아직 해결되지 않았다는 뜻이며 기능 부재라는 뜻이 아닙니다. CONSISTENT는 실제 연결·실행 권한·릴리스 준비를 입증하지 않습니다. 가려진 이름을 복원하거나 모르는 상태를 가정으로 채우도록 요청하지 마세요.
소스에서 확인한 GAPE CLI 명령은 운영자 참조입니다. 대응하는 입력 패키지가 필요하며 public-safe 읽기 파일을 전체 요청이나 스냅샷 대신 사용할 수 없습니다. 이 매뉴얼이 고객용 즉시 실행 GAPE 패키지를 입증하지는 않습니다.
승인된 읽기용 내보내기에 사용하며 원시 snapshot·제품 실행은 다루지 않습니다.
Explain the supplied, approved GAPE public-safe projection for a first-time reader.
Use only the supplied public-safe JSON or viewer content. Do not search for engineering exports or resolve redacted names.
List anonymous components and the relationships explicitly shown. Preserve each reconciliation state exactly.
Separate what the source projection says from your interpretation. For each interpretation cite the component or edge ID.
An UNRESOLVED state is an unanswered comparison; CONSISTENT is not runtime or authorization proof.
Do not infer hidden owners, credentials, endpoint addresses, live connectivity, execution permission, or release readiness.
Return: Observed relationships; Unanswered questions; Suggested documentation checks; Not executed.
기대 검토: 구성 요소·관계 ID → 명시된 관계 → 해석 → 남은 질문 순서입니다. 승인된 내보내기가 없으면 프롬프트를 템플릿으로 보관하세요. 매뉴얼은 아키텍처 snapshot을 만들어 내지 않습니다.
09 · GAPE 운영자 참조: 입력 종류 구분
소스에서 확인한 문법이며 이번 작업에서 실행하지 않았습니다. 운영자는 맞는 도구와 승인된 입력 패키지를 이미 갖춰야 합니다. Marketplace 설치 절차가 아닙니다.
packr-gape validate request.json
packr-gape project request.json new-output-folder
packr-gape snapshot manifest.json new-output-folder
packr-gape validate-snapshot gape-architecture-snapshot.json
packr-gape compare before-snapshot.json after-snapshot.json| 작업 | 입력·해석 |
|---|---|
validate / project | R0 요청. project는 선언한 산출물도 기록합니다. |
snapshot | 커밋 소스 관찰용 R1 매니페스트. 새 출력 디렉터리를 사용합니다. |
validate-snapshot | 전체 R1 snapshot이며 public-safe 읽기 JSON이 아닙니다. |
compare | 전체 snapshot 두 개. 차이가 런타임 변경·릴리스 승인을 뜻하지 않습니다. |
R1 내보내기는 기존 출력 디렉터리를 거부합니다. 이전 결과를 지우지 말고 새 디렉터리를 선택하세요. 실패 명령은 stderr에 decision: FAIL 인 JSON을 쓰고 1로 종료합니다. 오류를 보존하고 다른 종류의 입력으로 대체하지 않습니다.
10 · Vertex AI: 계정·바인딩·첫 제한 호출
- AI 준비 입력지에 프로젝트 ID·지원 리전·정확한 모델 ID·서비스 계정 책임자·허용할 프롬프트 데이터·시험 예산을 적으세요. 입력지는 제품 설정 파일이 아닙니다.
- 클라우드 관리자가 API·결제 상태, 실제 VM 부착 계정, 추론 권한, VM 접근 범위, 모델·리전 정책, 송신 네트워크 경로를 확인하도록 하세요. 광범위 관리자 역할이 실제 추론 계정 확인을 대신하지는 않습니다.
- 정확한 릴리스에 대해 공급자가 지원하는 바인딩·설정 절차를 확인하세요. 최초 Linux 고객 설정 경로의 전체 검증은 대기 중입니다. 설정 파일을 만들어 내거나 macOS 인증 명령을 VM에 적용하지 마세요.
- 제품이 승인된 런타임 바인딩을 해석하고 적격성·실행 허용을 확인합니다. 선택값 저장은 provider 호출이 아닙니다. 적격 런타임이 없다면 다른 provider를 조용히 사용하는 대신 설정·준비 상태 문제로 유지해야 합니다.
- 구현된 Linux 경로에서 어댑터는 메타데이터 서비스를 통해 VM 부착 서비스 계정의 토큰을 얻고 generateContent 요청을 외부로 전송합니다. macOS 경로는 기존 application-default credentials를 사용합니다. 토큰을 가이드나 입력지에 붙여 넣지 마세요.
- 지원되는 설정과 권한이 갖춰진 뒤 첫 호출에는 Reply with exactly: onboarding-check 같은 비민감 프롬프트를 사용할 수 있습니다. 실제 결과·정확한 모델과 리전·제품 검증 결과를 기록하세요. 이 가이드는 그 호출을 실행했다고 보고하지 않습니다.
비밀정보 없는 준비 항목이며 설정 파일이나 접근 권한 부여가 아닙니다.
AI connection worksheet — planning only; not a VibePackr configuration file.
Fill in non-secret values with your cloud administrator before a connected test.
Cloud project ID: <YOUR_PROJECT_ID>
Location supported by your chosen model: <YOUR_LOCATION>
Exact model ID: <YOUR_MODEL_ID>
Runtime service identity: <SERVICE_ACCOUNT_EMAIL>
Identity owner: <TEAM_OR_ROLE>
Vertex AI API enabled and billing available: <CONFIRMED / PENDING>
Inference permission checked: aiplatform.endpoints.predict <CONFIRMED / PENDING>
VM access scope and IAM both checked: <CONFIRMED / PENDING>
Chosen model/location allowed by organization policy: <CONFIRMED / PENDING>
Metadata and outbound Google API connectivity checked: <CONFIRMED / PENDING>
Approved prompt data class: <DATA_CLASS>
Allowed test prompt: Reply with exactly: onboarding-check
Approved test budget and retry limit: <LIMITS>
Supplier-supported binding/setup procedure and version: <REFERENCE / PENDING>
Do not paste tokens, API keys, private keys, credential files, or customer data here.
Completing this worksheet does not configure the product or authorize a provider call.
11 · Vertex 요청 예제와 결과 해석
별도 AI 런타임을 이해하기 위한 공개 제공자 요청 형태입니다. VibePackr 설정 파일이나 인증이 완성된 요청이 아닙니다. 프로젝트·리전·모델은 지원 배포 절차에서 제공된 뒤 바꾸며 이 가이드는 기본 모델을 선택하지 않습니다.
https://<LOCATION>-aiplatform.googleapis.com/v1/projects/<PROJECT_ID>/locations/<LOCATION>/publishers/google/models/<MODEL_ID>:generateContent제공자 API 형태만 설명하며 요청 미실행·기본 모델 미선택입니다.
{
"contents": [
{
"role": "user",
"parts": [
{
"text": "Reply with exactly: onboarding-check"
}
]
}
]
}
| 자리표시자 | 의미 |
|---|---|
PROJECT_ID | 승인된 AI 작업에 선택한 프로젝트. |
LOCATION | 선택한 모델이 지원하고 정책이 허용하는 리전. |
MODEL_ID | 정확한 모델 식별자. 이용 가능 여부는 별도 확인. |
제품 어댑터가 실행 자격증명을 얻고 자체 요청 제어값을 더합니다. 이 예제로 해당 제어값을 사용자 설정으로 노출하지 않습니다. 이 경로의 고객 프롬프트 내용은 VM에서 선택한 Google API로 전송되므로 허용된 데이터만 사용합니다. 위 에이전트 연습에는 별도 데이터 공유 정책이 적용될 수 있습니다.
이후 승인된 첫 호출에서는 선택 모델·리전, 실제 호출 전송 여부, 반환 텍스트나 민감정보 제거 오류, 제품 검증 결과를 기록하세요. 요청한 onboarding-check 는 기록된 응답이나 보장된 모델 답변이 아닙니다. HTTP 성공만으로 제품 검증이 끝나지 않습니다.
12 · AI 연결 실패: 다음 확인 지점
검토한 어댑터·선택 동작의 범주를 설명합니다. 캡처한 고객 응답이나 공개 응답 필드 철자 보장이 아닙니다. 실제 민감정보 제거 오류를 바탕으로 진단하세요. PIN 선택은 다른 제공자로 조용히 전환되지 않습니다.
| 관찰된 유형 | 의미 | 다음 확인 |
|---|---|---|
AuthenticationRequired | 제공자 호출 전에 VM 메타데이터 자격증명 획득 실패. | 관리자가 부착 계정·메타데이터 접근을 확인. |
UnauthorizedIdentity (before provider call) | 설정된 자격증명 참조가 거부됨. | 제공 바인딩·참조 대조. 토큰으로 대체하지 않음. |
HTTP 401 | 인증 거부. | 실제 OS에 맞는 지원 계정 절차 사용. |
HTTP 403 | 요청 거부. 반환 상세로 원인 확인. | 실제 주체·추론 권한·정책·모델·리전 확인. |
HTTP 404 / ModelUnavailable | 해당 요청의 모델·경로 사용 불가. | 정확한 모델·지원 리전 확인. |
HTTP 429 / BudgetExhausted | 자원 소진·제한 범주. 금전 예산 때문이라고 단정하지 않음. | 할당량·호출 제한 상세와 합의한 재시도 한도 확인. |
HTTP 408/504 / timeout | 성공 완료 관측 없음. | 시간 초과·네트워크와 추가 유료 호출 권한 확인. |
MalformedResponse | 기대 파서가 응답을 허용하지 않음. | 최소 민감정보 제거 오류 보존. HTTP 상태만으로 부족. |
NO_ELIGIBLE_RUNTIME / REQUESTED_RUNTIME_NOT_DISCOVERED | 선택 가능한 적격·요청 런타임 없음. | 지원 런타임 발견·바인딩 확인. 대체 실행을 가정하지 않음. |
13 · 선택 참조: 활성 설정 밖에서 MCP 문법 읽기
Codex와 Cursor는 MCP 서버 연결 설정 형식을 공개합니다. 제공한 템플릿은 이 공급자 문법만 설명합니다. 예약된 .invalid 주소를 사용하고 자격증명이 없습니다. VibePackr 서버 등록이 아니며 이 연습에서는 활성 설정 밖에 보관해야 합니다.
Codex 템플릿은 명시적으로 비활성화되어 있습니다. Cursor 템플릿은 비활성 서버 동작을 가정하지 않은 참조 JSON입니다. 실제 사용 전에 관리자가 승인된 실제 서버·전송 방식·인증 절차·정확한 클라이언트 버전을 지정해야 합니다.
Integration Helper가 특정 MCP initialize/tools-list 관찰을 읽을 수 있다는 사실은 상시 MCP 서버로 동작하거나 임의 URL로 VibePackr를 등록할 수 있다는 뜻이 아닙니다. 별도로 문서화된 서버 구현 없이 일회성 Helper CLI를 STDIO 서버 명령에 넣지 마세요.
공급자 문법만 설명합니다. 활성 설정 밖에 보관하며 .invalid는 의도적으로 서비스 주소가 아닙니다.
# Vendor syntax reference only. No VibePackr MCP endpoint is supplied or verified.
# Keep disabled until your approved server address and access procedure are known.
[mcp_servers.approved_example]
url = "https://approved-server.invalid/mcp"
enabled = false
공급자 문법 참조입니다. 활성 설정 밖에 보관하며 이 파일의 비활성 상태를 가정하지 않습니다.
{
"mcpServers": {
"approved_example": {
"url": "https://approved-server.invalid/mcp"
}
}
}
Codex는 TOML의 mcp_servers 를, Cursor는 프로젝트 .cursor/mcp.json 과 사용자 ~/.cursor/mcp.json을 문서화합니다. 아래 공식 참조와 문법을 대조했으며 읽기·다운로드로 설치되지 않습니다. 이후 연결 전에 승인된 실제 엔드포인트·전송·계정 절차·클라이언트 버전·기대 발견 결과를 기록합니다.
14 · 버전 기록과 셀프서비스 인수 조건
재현 가능한 연결 예제에는 클라이언트·도구 버전, 제품 버전, 입력 리비전, 전송 방식, 정확한 승인 설정 절차, 긍정·부정 검사, 기대 출력, 정리 방법이 필요합니다. 여기의 절차는 클라이언트 버전을 인증하지 않습니다. Codex·Cursor 설정 문서는 2026-10-03에 확인했으며 Claude 설정 문서는 가져오지 못해 미확인 설정·CLI 플래그를 제공하지 않습니다.
다음 표준 제공물: 완전한 고객 요청 예제, 지원 설치 경로, 승인된 GAPE 읽기 내보내기 또는 운영자 패키지, Linux AI 바인딩·설정 경로, 버전별 실제 연결 에이전트 시험입니다. 남은 제품·문서 표준화 항목이며 고객별 맞춤 스크립트 지시가 아닙니다.
실전 예제 확인 지점 이나 고객 AI 준비로 돌아갑니다.
고객 환경에서 통제된 작업 흐름 하나를 평가하십시오.
평가할 AI 작업 흐름 하나와 대상 실행 경계·승인 요건을 정리하세요. 기록된 로컬 R234 사례와 비교하거나 구조화된 PoC 평가 순서를 따르고, 2026년 10월 18일 영문·한국어 기술 백서를 참고하세요.
연락 경계 안내: “평가 문의”를 클릭하면 로컬 메일 프로그램이 다음 수신 주소로 열립니다: support@vibepackr.com 로 구조화된 문의 양식이 열립니다. 이메일 전송만으로 지원 사례가 등록되거나 어플라이언스가 구성되지는 않습니다. 자격 증명·개인정보·기밀 로그를 포함하지 마십시오.