site-architecture

site-architecture 스킬 개요

site-architecture는 무엇을 위한가

site-architecture 스킬은 검색 엔진과 AI 크롤러가 실제로 발견하고 이해할 수 있는 기술적 기반을 설계하거나 점검하는 데 도움을 줍니다. robots.txt, 사이트맵, 메타 태그, 크롤링 접근, Core Web Vitals처럼 실제 사이트 구조에 영향을 주는 요소에 초점을 맞추기 때문에, 가시성이 콘텐츠 품질만으로는 결정되지 않을 때 특히 유용합니다.

어떤 사용자와 작업에 가장 잘 맞는가

새 사이트를 출시하거나, 인덱싱 문제를 고치거나, 콘텐츠가 많은 사이트를 SEO Content 발견에 맞게 준비해야 할 때 site-architecture skill을 사용하세요. 특히 개발자, SEO 리드, 에디터처럼 막연한 SEO 조언이 아니라 명확한 기술 계획이 필요한 사람에게 잘 맞습니다.

무엇이 다른가

이 스킬은 단순히 “SEO”에 관한 프롬프트가 아닙니다. 일반적인 검색 엔진뿐 아니라 GPTBot, ClaudeBot, PerplexityBot 같은 AI 크롤러에서의 발견 가능성, 그리고 Open Graph와 Twitter Cards를 통한 소셜 미리보기까지 함께 다룹니다. 핵심 가치는 아키텍처 결정을 크롤링 가능하고 인덱싱 가능한 페이지로 바꾸고, 숨은 차단 요소를 줄이는 데 있습니다.

언제 적합하고 언제 부적합한가

사이트 전반의 구조, 크롤링 접근, 메타데이터 일관성이 문제라면 매우 잘 맞습니다. 반대로 단발성 메타 설명 하나, 콘텐츠 브리프, 또는 기술적 배포 계층이 없는 디자인 피드백만 필요하다면 적합도가 떨어집니다.

site-architecture 스킬 사용 방법

설치하고 올바른 파일 열기

site-architecture install의 경우, 점검하거나 설정하려는 사이트와 같은 작업 공간에서 이 스킬을 사용한 뒤 먼저 SKILL.md를 여세요. 이 repo는 의도적으로 가볍게 구성되어 있어서, 가장 가치 있는 안내는 그 파일에 들어 있습니다. 의존할 보조 스크립트나 헬퍼 폴더가 없으므로, 규칙을 꼼꼼히 읽고 자신의 스택에 적용해야 합니다.

스킬에 무엇을 입력할 것인가

site-architecture usage 패턴은 사이트 유형, 플랫폼, 현재 제약 조건을 함께 제공할 때 가장 잘 작동합니다. 예를 들면 이렇게 입력할 수 있습니다. “Next.js로 만든 마케팅 사이트의 크롤링 가능성, 사이트맵 범위, AI 봇 접근을 점검해 주세요. 공개 페이지만 인덱싱되면 됩니다.” 이렇게 하면 스킬이 넓은 모범 사례가 아니라, 실제로 쓸 수 있는 기술 권고를 내기 위한 문맥을 얻습니다.

더 나은 출력을 얻는 프롬프트 방법

site-architecture guide는 체크리스트가 아니라 워크플로로 활용하세요. 다음 중 하나를 요청하면 좋습니다.

• 특정 환경에 맞는 robots.txt 초안
• 공개 URL과 비공개 URL을 나눈 사이트맵 전략
• 템플릿과 페이지 유형별 메타데이터 규칙
• 현재 사이트 구조에 대한 크롤링/인덱싱 점검

site-architecture for SEO Content가 필요하다면, 어떤 콘텐츠 페이지가 가장 중요한지, 어떻게 생성되는지, 어떤 페이지를 검색에서 제외해야 하는지까지 알려 주세요. 그래야 스킬이 노출과 제외의 균형을 맞출 수 있는데, 이것이 실제 아키텍처상의 핵심 트레이드오프입니다.

먼저 읽을 파일

다음부터 시작하세요.

• skills/site-architecture/SKILL.md

그다음 자신의 repo에서 아래와 맞닿는 경로를 확인하세요.

• robots.txt
• sitemap.xml 또는 sitemap 생성기
• HTML 템플릿
• public asset 디렉터리

이 스킬 repo 자체에는 추가 지원 파일이 없기 때문에, 구현 품질은 그 규칙을 실제 사이트 구조에 얼마나 정확히 대응시키느냐에 달려 있습니다.

site-architecture 스킬 FAQ

site-architecture는 개발자만 위한 것인가?

아닙니다. site-architecture skill은 SEO 담당자, 콘텐츠 팀, 사이트 오너에게도 유용하지만, 최종 변경은 보통 개발자가 적용합니다. 비개발자는 코드 변경 전에 크롤링 및 인덱싱 정책을 정의하는 단계에서 큰 가치를 얻을 수 있습니다.

일반적인 프롬프트와는 무엇이 다른가?

일반적인 프롬프트는 흔히 “SEO best practices”를 묻고, 그 결과는 지나치게 일반적인 답변이 되기 쉽습니다. site-architecture는 범위가 더 좁아서 크롤링 접근, 발견 가능성, 메타데이터, 기술적 제약에 초점을 맞춥니다. 그래서 문구 제안이 아니라 인덱싱에 영향을 주는 결정을 내려야 할 때 더 적합합니다.

초보자도 쓰기 쉬운가?

네, 사이트를 분명하게 설명할 수 있다면 그렇습니다. 이 스킬은 기술적 문제에 구조를 부여한다는 점에서 초보자 친화적이지만, 플랫폼, 공개/비공개 URL 규칙, 사이트가 인덱싱되어야 하는지 같은 기본 사실은 여전히 필요합니다.

언제 사용하면 안 되는가?

홈페이지 카피 작성이나 제품명 짓기처럼 순수하게 창작적인 작업에는 site-architecture를 쓰지 마세요. 또 사이트에 크롤링이나 인덱싱 관련 고민이 없다면 이 도구는 적절하지 않습니다. 아키텍처 안내 자체가 불필요한 오버헤드가 되기 때문입니다.

site-architecture 스킬 개선 방법

중요한 제약 조건을 먼저 제공하기

가장 좋은 결과는 플랫폼, 호스팅 방식, 인덱싱 목표를 명확히 적어 넣을 때 나옵니다. 정적 호스팅인지, SSR인지, CMS 기반 발행인지, 하이브리드인지, 그리고 어떤 섹션을 크롤러에서 차단해야 하는지도 알려 주세요. 그래야 추측이 줄고, 바로 적용할 수 있는 권고가 나옵니다.

홈페이지뿐 아니라 페이지 유형을 함께 공유하기

site-architecture 결과를 개선하려면 product pages, blog posts, category pages, docs, login pages, admin areas, filtered search pages처럼 주요 URL 분류를 나열하세요. 그러면 스킬이 인덱싱 가능한 템플릿과 제외해야 할 URL을 구분할 수 있고, 그 차이가 깔끔한 아키텍처와 불필요한 크롤링 낭비를 가릅니다.

흔한 실패 모드를 점검하기

가장 흔한 문제는 유용한 페이지를 robots.txt로 막아버리거나, 중복되거나 가치가 낮은 URL을 노출하거나, 템플릿마다 메타데이터를 일관성 없이 발행하는 것입니다. 첫 결과가 너무 일반적으로 느껴진다면 보통 입력이 약한 경우입니다. URL 예시가 부족하거나, 콘텐츠 우선순위가 불분명하거나, 기술 스택의 한계를 언급하지 않은 경우가 많습니다.

근거를 가지고 반복 개선하기

첫 번째 결과를 받은 뒤에는 실제 파일과 로그로 권고안을 검증하세요. 사이트맵 범위를 확인하고, robots.txt를 점검하고, 대표 페이지 몇 개에서 렌더링된 메타데이터를 검토합니다. 그런 다음 “faceted URLs에 맞게 조정해 달라”거나 “staging과 production의 봇 접근을 더 엄격하게 구분해 달라”처럼 깨진 부분만 다시 요청하세요. 이렇게 하면 site-architecture 스킬의 초점을 유지하면서, 두 번째 패스에서 더 나은 기술 결정을 얻을 수 있습니다.