공유 카드, 파비콘, 앱 아이콘
배포된 앱(https://{name}.grok.me)은 1200x630 크기의 카드로 미리보기가 제공되며, 모든 앱(미리보기 포함)은 탭에 파비콘을 표시합니다. 공유 카드 <meta> 태그는 __root.tsx에서 작성되지 않습니다 — 인젝터(scripts/grok-pwa-shared.mjs)가 모든 HTML 응답에 대해 og:* 및 twitter:card를 덮어씁니다. 식별 정보만 작성하면 패스가 모든 것을 처리합니다. 사용자는 아무것도 시드하지 않습니다:
src/lib/og/site.json— 사전 시드되지 않으며, 필요한 경우에만 생성됩니다:{ "title", "type"?: "x:game", "card"?: "custom", "color"?: "RRGGBB" };title은 기본적으로 호스트 슬러그 값입니다.public/og.jpg— 커스텀 1200x630 카드 (선택 사항, 없으면 기본 플레이스홀더 사용)public/x-banner.jpg— 게임 전용: 50:11 (1200x264) X 피드 카드public/favicon.svg— 루트head()에서 링크됨; 패스가 적용되기 전까지 탭에는 브라우저 기본값이 표시되며, 이는 아무 문제를 일으키지 않습니다.
__root.tsx를 확장하고, 완전히 교체하지 마십시오 (인증 SSR, 재설계, 스킬 발췌 등): 파비콘 링크를 제거하면 로컬 검사로는 감지되지 않는 빈 탭 아이콘이 배포됩니다.
결정: 이 앱에 어떤 카드를 사용할지
기본값: 커스텀 카드 — 모든 종류의 게임 및 렌더링 기술(Canvas/WebGL 및 DOM 보드, 카드, 단어, 퍼즐, 퀴즈: div로 구성된 틱택토 그리드도 게임입니다), 기발한 앱, 창의적인 도구, 콘텐츠 및 브랜드 중심 페이지에 사용됩니다. 의심스러우면 커스텀 카드를 만드십시오.
단순 유틸리티 앱만 (변환기, CRUD 추적기, 대시보드, 노트/관리 — 데이터가 얼굴인 앱) 기본 og.grok.me 플레이스홀더를 유지합니다: public/og.jpg를 생성하지 않습니다. 해당 URL, "color" 조정 및 이름 변경 규칙: references/placeholder-card.md를 참조하십시오.
게임의 og:type
모든 종류의 게임은 src/lib/og/site.json에 "type": "x:game"을 포함합니다 — 패스가 이 파일을 소유하며 작성합니다. 호스트 이름은 포함하지 않으며, 커스텀 카드가 있어야만 하는 조건도 없고, website, 베어 game, twitter:card 또는 임의의 x:type으로 "수정"되지 않습니다: X의 파이프라인은 이 정확한 값에 의존합니다. 게임이 아닌 경우 이 값을 생략합니다. 확인은 사용자의 몫이지만 편집은 아닙니다 — 값이 없거나 커스텀 카드가 존재하는데 public/x-banner.jpg가 없으면 브랜드 경고가 발생합니다.
브랜드 자산 패스: 항상 서브 에이전트, 절대 기다리지 않음
task 도구를 사용할 수 있습니까? 이 패스를 서브 에이전트로 전달하고 직접 카드 아트를 생성하지 마십시오 — 인라인으로 처리하면 생성 지연 시간이 사용자 앞에 몇 분 동안 발생합니다. 이름과 색상 팔레트가 결정되는 즉시(AGENTS.md § "병렬 작업"), 다음 프롬프트를 그대로 전달하십시오. 이 프롬프트는 완전합니다. 아래 참조 문서를 열어 내용을 보강하지 마십시오. 패스가 직접 읽습니다:
당신은 브랜드 자산 패스입니다.
og스킬을 따라 시작 위치를 확인하십시오. 앱<NAME>,og:type<TYPE>, 팔레트<PALETTE>.public/브랜드 자산과src/lib/og/site.json을 전적으로 소유합니다.
계속 빌드하십시오. 사용자가 아트를 직접 지시하거나 재사용할 아트가 아직 존재하지 않는 경우에만 순차적으로 진행하십시오.
절대 기다리지 마십시오. wait_tasks 금지, 그리고 브랜드 태스크에 대해 절대 get_task_output을 사용하지 마십시오: 태스크의 출력을 읽으면 해당 출력이 소비되고, 소비된 태스크는 완료 알림을 보내지 않으므로 카드의 결과(실패 포함)가 아무에게도 도달하지 않습니다. 앱이 렌더링되는 즉시 답변하십시오. 패스가 나중에 당신을 깨우며, 그 턴은 최대 한 문장입니다 — 재배포를 요청하는 문장입니다. public/og.jpg는 빌드에 포함되어 배포되며, 배포 후에 도착한 카드는 라이브 앱에 자동으로 적용되지 않기 때문입니다: "공유 카드가 추가되었습니다. 이미 배포했다면 다시 배포하십시오." / "카드 생성에 실패했습니다. 기본 카드가 적용됩니다."
패스가 /workspace/.grok/og-pending을 최신 상태로 유지하는 동안 브랜드 검사는 카드에 대해 아무것도 말하지 않습니다: 진행 중인 작업은 결과로 간주되지 않습니다. 마커는 10분 후에 유효하지 않게 되므로 매우 긴 패스는 경고를 통과시킬 수 있습니다. 하지만 실행 중 브랜드 경고가 발생하더라도 작업을 다시 수행해야 한다는 신호는 아닙니다.
task 도구가 없습니까? 그러면 당신이 패스입니다 — 지금 자산을 빌드하십시오; 다른 누구도 하지 않습니다. 실행하는 사람이 해당 마커를 요청하고, 파일을 /workspace/.grok/ 아래에 준비합니다 — vite build가 배포된 앱에 그대로 복사하는 public/ 디렉토리 안에는 절대 넣지 마십시오 — scripts/write-atomic.mjs를 사용하여 빌드가 JPEG의 절반만 읽는 일이 없도록 하고, node scripts/brand-check.mjs --game을 사용하여 자체 점검합니다.
자산 빌드 — 패스는 이것을 읽고, 부모는 읽지 않음
서브 에이전트를 전달했습니까? 열지 마십시오 — 위 프롬프트는 완전합니다. 한 번 읽으면 이 절차가 이후 모든 턴의 컨텍스트에 유지되는 동안 서브 에이전트가 실제로 작업을 수행합니다.
당신이 패스입니까? references/brand-pass.md에서 시작한 다음, 생성해야 할 각 자산에 대한 참조 문서를 읽으십시오: public/og.jpg는 references/custom-card.md, 게임 전용 public/x-banner.jpg는 references/x-banner.md, public/favicon.svg와 PWA 래스터 아이콘은 references/favicon-and-icons.md — PWA 아이콘은 사용자가 설치 가능/PWA를 요청한 경우에만 생성하며, 절대 매니페스트를 임의로 만들지 마십시오. SVG는 직접 코드로 작성하고 imagine_text_to_image를 사용하지 마십시오: 16px에서도 선명하게 유지되어야 합니다. 게임에 대해 site.json을 작성해야 합니까? references/og-type-contract.md에서 X가 거부하는 표기법을 설명합니다.
이름을 변경하거나 중요한 식별 정보(앱 이름, site.json의 title, 카드에 포함된 제목)가 변경되면 자산을 다시 생성하십시오. imagine_text_to_image나 xAI Images API를 사용할 수 없는 경우 og.grok.me 카드를 유지하십시오. 손상된 og:image URL을 배포하지 마십시오.
지원되지 않는 기능
/api/og 경로, 런타임 이미지 렌더러, 경로별 카드 등은 없습니다 — 카드는 하나의 정적 사이트 전체 이미지(public/og.jpg 또는 플레이스홀더 서비스)입니다. robots.txt를 추가하는 경우, 절대 포괄적인 Disallow: /를 사용하지 마십시오: 크롤러는 태그를 읽기 위해 /를 가져와야 합니다.