--- name: tk-prototype description: "[user/auto] 비교가 필요한 일회성 UI 또는 로직 prototype을 만들고 실행합니다. production 구현이나 대화형 아이디어 탐색에는 사용하지 않습니다." disable-model-invocation: false argument-hint: "" metadata: tigerkit: kind: hybrid origin: tigerkit relationship: native --- ## 공통 저작 품질 관문 이 스킬에서 질문·메시지·설명·보고서·Markdown·HTML·대본·자막·문서·스킬 본문 등 사람이 읽는 텍스트를 **새로 작성하거나 의미·표현을 수정하기 전에**, 설치된 `tk-writing`의 [모든 저작의 공통 관문](../tk-writing/references/authoring-gate.md)과 [명확한 글쓰기](../tk-writing/references/clear-writing.md)를 이번 작업에서 읽고 적용합니다. 최종 산출물을 인계하기 전에 같은 기준으로 원고를 검사하고 문제를 수정합니다. 이미 읽은 기준을 반복 로드하거나 별도 재작성 스킬·에이전트·승인 라운드를 추가하지 않습니다. 코드·명령·식별자·기계 판독 형식·인용과 고정 문구는 보호하며, 이 참조로 변경·전송·발행 권한이 생기지 않습니다. 이 스킬이 작성 작업을 수행하지 않는 경우에는 추가 읽기가 필요하지 않습니다. # 비교 prototype ## 공통 참조 분기 조건에 해당하는 기준은 현재 설치된 소유자에게서 읽습니다. 소유자나 자원이 없거나 일치하지 않으면 해당 행동을 중단합니다. 기억, 다른 설치본이나 승인받지 않은 설치로 대신하지 말고 `tk-setup-skills`를 사용합니다. 읽기는 워크플로나 변경 권한을 부여하지 않습니다. - 사용자 소유 결정·누락된 승인·미충족 선행 조건을 질문이나 질문 도구 입력으로 제시하기 직전에 [질문 라운드](../tk-questioning/references/questions.md)를 이번 작업에서 읽었는지 확인하고 누락했으면 먼저 읽습니다. 독립적인 결정과 승인은 각각 별도 질문으로 두며, 승인 선택지를 결정 질문에 섞지 않습니다. - 사용자에게 완료를 보고하거나 산출물 경로를 인계하거나 채팅에서 여러 속성을 비교하기 전에 [채팅 전달](../tk-writing/references/delivery.md)을 읽습니다. 작업의 구체적인 출력 계약이 우선합니다. ## 승인 연속성 동일 작업에 유효한 승인을 턴과 하위 단계(변경 전 기준/변경 후 포함)에 걸쳐 재사용하고, 기존 소유자를 통해 승인된 작업만 계속합니다. 하위 단계·변경 전 기준의 근거를 반환하고 승인된 소유자 작업을 재개합니다. 단계 상태는 완료가 아닙니다. 새로운 중요 결정, 범위·권한 변경 또는 사용자만 제공할 수 있는 입력의 누락이 있을 때만 묻습니다. 호출과 복원된 산출물은 권한을 부여하지 않습니다. 원격 작업과 파괴적 작업에는 명시적인 행동·대상 승인이 필요하며 로컬 승인에서 추론하지 않습니다. 입력으로 `prompt`, 아이디어, 스크린샷, `spec`, `ticket`, 코드 또는 디자인 참조를 받습니다. 독립 산출물은 `.tigerkit/prototypes//` 아래에 둡니다. 단, 아래의 [호스트 인라인 전달](#host-inline-delivery) 조건을 충족하는 채팅 전용 HTML 시제품은 해당 호스트가 지정한 출력 경로에 둘 수 있습니다. 저장소에 파일을 쓸 때는 Git이 `.tigerkit/`을 실제로 무시하고 그 아래 경로가 추적되지 않음을 먼저 입증합니다. 유효 규칙은 디렉터리별 설정, 로컬 exclude 또는 사용자 수준 exclude 설정에서 올 수 있습니다. ignore 적용이 없으면 산출물 경로 설정을 사용하고 쓰기 전에 다시 점검합니다. 호스트 인라인 전달 분기 외에는 외부 임시 작업 공간으로 대체하지 않습니다. 선택한 런타임에 필요한 경우에만 저장소 고유 route/harness를 허용하며 실행 소유 파일만 기록하고 정리합니다. ## 워크플로 1. `hypothesis/success criteria`: 아이디어, 참조와 검증 질문에서 측정 가능한 기준을 도출합니다. 2. `temporary path/boundary`: 저장소 경로를 사용할 때는 저장소 사전 점검을, 호스트 인라인 경로를 사용할 때는 호스트 출력 계약과 지정 경로 점검을 수행합니다. 기존 도구 체계·UI 스택·구성 요소·토큰, 임시 경로, 산출물 소유권과 `fake | real` 통합 경계를 선택합니다. 3. `variants/harness`: 비교에 답하는 데 필요한 대안만 만들거나 현실적인 예시 I/O를 사용하는 `harness`를 만듭니다. 4. `run`: 선택한 `variant`/`harness`를 실행하고 실제 출력 또는 스크린샷과 명령 결과를 수집합니다. 각 실행을 `## Tested` 아래에 다음 receipt 필드로 기록합니다. 명령을 요약하지 말고 실제 실행한 값을 정확히 기록합니다. ```text Command: CWD: Provider: Exit code: Output: Artifact: ; ownership: run-owned | pre-existing Screenshot: ; actual inspection: yes | no | N/A ``` 웹 실행의 `Provider`는 `tk-browser-verify`가 반환한 실제 제공자와 근거에 연결합니다. 검증기를 거치지 않았거나 선택한 제공자에서 임의로 전환했다면 해당 웹 검증은 `Unverifiable`입니다. `playwright-cli`라는 이름만 기록하거나 Chrome 직접 캡처가 성공했다는 이유로 `Pass`를 부여하지 않습니다. 기존 PNG/GIF와 직접 확인한 이미지 내용은 보존하며, 캡처·이미지 확인·미디어 생성과 웹 비교 검증의 완료를 구분합니다. 5. `compare`: 근거를 기준에 대응시키고 검증된 차이, 미검증 항목과 다음 결정을 요약합니다. 상위 계약에 이미지 `PR evidence: required`가 기록되어 있고 비교가 `Pass`이며 직접 확인한 스크린샷이 이를 바로 입증하면, 실행 소유 절대 경로 `Screenshot: `와 실제 이미지 확인 내용을 `## Tested` 아래에 보존하고 발행 측에서 소비하는 것과 같은 생성 주체에 종속되지 않는 manifest를 제공합니다. `evidence_required: true`, `evidence_kind: visual-change`, `verification_status: Pass`, 기준, 비교, 한계와 함께 역할, 절대 경로, origin이 없는 정확한 `display_route`, 상태/영역, viewport가 있는 직접 확인한 산출물을 포함합니다. `tk-browser-verify`가 반환한 메타데이터를 사용하고 파일명, 원시 URL 또는 생성 주체의 식별 정보에서 도출하지 않습니다. 이는 prototype 비교를 입증하며 공식 제품 런타임 인수 판정은 아닙니다. `Fail | Blocked | Unverifiable`이면 소유한 실패 산출물을 보존하고 실제 상태를 반환하되 `verification_status: Pass` 발행 manifest를 내보내지 않습니다. 필수 이미지 발행을 충족할 수 없으면 해당 발행 요구사항을 차단 또는 검증 불가로 보고합니다. 6. 비교가 후속 구현에 영향을 주면 [선택된 prototype 인계](../tk-engineering/references/selection-handoff.md)를 읽고 해당 선택 기록을 기존 결과에 반환합니다. 7. `terminal summary`: 아래 출력 계약에 해당하는 절을 표시합니다. 별도의 출처·상태 블록을 추가하지 않습니다. 미해결 UI 비교에서는 결정에 관련된 차원만 바꿉니다. 색상, 대비 또는 상태 식별이 질문인 경우 색상만 다른 대안도 유효하며 해당 비교에서 레이아웃과 동작은 유지합니다. 아키텍처, 흐름 또는 탐색은 그것이 실제 질문일 때만 바꿉니다. 로직에는 예시 입력/출력과 최소 어댑터를 사용하는 작은 순수 harness를 우선합니다. 웹 prototype에서 저장소를 사용할 때는 저장소 실행 명령, 설치된 UI 스택, 구성 요소와 디자인 토큰을 확인합니다. 의존성을 추가하거나 manifest/lockfile을 바꾸지 않고 안전하게 격리된 route/harness를 재사용합니다. 호스트 인라인 전달만 사용할 때는 해당 호스트 출력 계약과 독립 HTML의 렌더링 제약을 확인합니다. 저장소·참조 디자인 토큰이 없는 독립 HTML에는 공통 테마 자산과 가독성·렌더링 요구사항을 위해 [HTML 출력](../tk-writing/references/html-output.md)을 읽습니다. 비교별 디자인 토큰과 prototype 탐색 예외를 유지합니다. 안전한 route/harness가 없고 사람에게 전달하는 한 페이지 비교 화면이 필요하면 `tk-writing`의 공용 한 페이지 빌더(`scripts/build_page.py`)로 조립합니다. 상호작용은 `[[figure:이름]]` 조각에 필요한 `