MarketingOS 사이트 플래너
비즈니스 브레인이 이미 알고 있는 정보와 짧은 인터뷰, 실제 연구를 바탕으로 누군가가 구축할 수 있는 웹사이트 계획(브리프, 의도 맵, 페이지별 사양)을 만듭니다. 계획이 결과물입니다. 이 스킬은 승인된 계획에서 멈춥니다: 페이지를 구축하거나, 최종 카피를 작성하거나, 리디렉션을 설정하거나, 시각 디자인을 선택하지 않습니다.
MarketingOS 컨텍스트 및 전제 조건
권장 순서: mos-design-authentication → EmDash 프로젝트 설정 → mos-design-site-planner → mos-atomic-design-system. 각 단계가 엄격한 전제 조건은 아닙니다. 이전 단계가 실행되지 않은 경우 한 번 알리고 계속 진행합니다.
현재 세션과 그 기록에서 활성 비즈니스 브레인과 웹사이트 프로젝트를 확인합니다. 질문하기 전에 브레인의 BRAIN.md 또는 에이전트 지침, CONTEXT.md 및 business/(브랜드, 음성, 잠재고객, 오퍼, 전략, 증거, 경쟁사)를 읽습니다. mos CLI를 사용할 수 있다면 mos context show --json은 각 컨텍스트 필드 뒤에 있는 파일을 알려줍니다. 각 비즈니스의 컨텍스트는 분리하여 유지합니다. MarketingOS가 없으면 사용자가 제공한 파일을 기준으로 작업하고 나머지는 모두 격차로 처리합니다.
번들 스크립트에는 Bun을 사용합니다. Bun이 없으면 사용자에게 https://bun.com/docs/installation을 안내합니다. $SKILL을 이 SKILL.md가 포함된 실제 디렉토리로 확인합니다. 설치 위치는 에이전트마다 다릅니다.
호출: Claude Code에서는 /mos-design-site-planner, Codex에서는 $mos-design-site-planner입니다. Claude Code에서는 AskUserQuestion으로, Codex에서는 번호가 매겨진 질문과 알파벳 옵션으로 질문합니다. 하나의 초기 프롬프트가 전체 워크플로우를 구동하며, 모든 승인은 동일한 대화 내에서 유지됩니다.
증거 레이블
모든 연구 결과와 모든 의도 주장에는 하나의 레이블이 포함됩니다:
- 측정됨(measured): 도구 또는 내보내기(Search Console 클릭, 키워드 볼륨, 크롤링 횟수)의 숫자로, 수치와 날짜가 포함된 출처 ID가 함께 제공됩니다.
- 관찰됨(observed): 특정 날짜에 직접 확인되었지만 집계되지는 않음(자동완성 제안, 결과 페이지, People Also Ask, 경쟁사 사이트맵, AI 답변). 날짜가 포함된 출처 ID가 함께 제공됩니다.
- 가정됨(assumed): 추론 또는 사용자의 말에 근거하며, 그 이유가 기록됩니다.
출처가 없는 결과는 가정된 것으로 간주되거나 생략됩니다. 도구 접근, 키워드 볼륨, People Also Ask 질문, 비즈니스 사실은 실제 실행에서 생성된 경우에만 보고됩니다.
워크플로우
각 단계 후에 <project>/site-plan/state.json에 진행 상황을 저장하여 이후 세션이 중단된 지점에서 재개할 수 있도록 합니다. 파일 형식, 템플릿 및 상태 스키마: references/output-format.md.
1. 사전 점검
브레인, 웹사이트 프로젝트(docs/project.md 또는 이에 상응하는 프로젝트 노트) 및 기존 사이트 URL(있는 경우)을 확인합니다. site-plan/state.json이 존재하면 해당 단계를 보고 그곳에서 재개합니다. 이 세션에서 실제로 작동하는 연구 도구를 감지합니다: Search Console 내보내기 또는 연결된 도구, DataForSEO 키, 크롤러(Scrapling 또는 일반 fetch), 웹 검색. 각각을 테스트합니다. 테스트 호출에 실패하는 환경의 키는 사용할 수 없습니다. 감지 단계: references/research.md. 아직 웹사이트 프로젝트가 없으면 저장 위치를 한 번 묻습니다. 브레인의 outputs/YYYY/MM-Mon/YYYY-MM-DD-site-plan/이 기본 위치입니다.
브레인, 프로젝트, 저장 위치, 기존 URL(또는 "새 사이트") 및 작동하는 도구 목록이 state.json에 기록되면 완료됩니다.
2. 내가 이미 알고 있는 정보
브레인에서 카드를 작성합니다: 비즈니스, 서비스, 위치 및 서비스 지역, 잠재고객, 오퍼, 음성, 증거 및 주요 행동. 각 항목은 출처 파일을 명시하고 확인됨(브레인에 명확히 명시됨), 추론됨(행간 읽기) 또는 누락됨으로 표시됩니다. 이를 표시하고 사용자가 수정할 수 있도록 합니다. 카드 형식: references/interview.md.
사용자가 카드를 확인하거나 수정하면 완료됩니다.
3. 격차 전용 인터뷰
카드에서 추론됨 또는 누락됨으로 표시된 항목에 대해서만 묻습니다. 배치 단위로, 각 질문에는 권장 답변과 그 이유가 함께 제공됩니다. 질문 은행은 목표, 수익 서비스, 서비스 지역, 새 사이트 대 리뉴얼, 기능, 증거 자료, 경쟁사 및 제약 조건을 다룹니다: references/interview.md. 디자인 참조는 mos-atomic-design-system 및 디자인 스킬에 속하므로 여기서는 제외합니다.
모든 브리프 필드가 답변되거나 GAP으로 기록되면 완료됩니다.
4. 브리프 확정
브리프를 한 화면에 재생합니다: 출처가 있는 사실, 격차, 연구 계획 및 예상 비용이 포함된 유료 호출. 연구 시간이나 비용을 지출하기 전에 동의를 구합니다.
사용자가 브리프를 승인하면 완료됩니다. decisions.md에 기록합니다.
5. 연구
사전 점검에서 작동하는 것으로 확인된 각 방법을 실행합니다: 기존 사이트 크롤링 및 URL 인벤토리, Search Console 쿼리 및 랜딩 페이지, 키워드 볼륨(키가 있으면 DataForSEO, 그렇지 않으면 볼륨이 없는 것으로 표시된 자동완성), 결과 페이지 및 People Also Ask, 경쟁사 사이트맵, 선택적 AI 답변 확인. 누락된 선택적 출처는 연구 격차 목록에 추가되고 작업은 계속됩니다. 방법, 대체 방안 및 비용 보고: references/research.md. 모든 출처는 research/sources.md에 날짜가 포함된 행으로 기록됩니다.
각 방법이 레이블이 지정된 결과 또는 격차 항목을 생성하면 완료됩니다.
6. 페이지 결정
쿼리를 의도별로 클러스터링한 후 페이지 규칙을 적용합니다: 의도당 한 페이지, 수익 서비스당 하나의 서비스 페이지, 고유한 콘텐츠가 있는 서비스 지역에만 위치 페이지, 명시적인 캐니벌라이제이션 확인, 트래픽 또는 링크가 있는 모든 기존 URL에 대한 유지/병합/리디렉션/폐기 결정. 브레인의 기존 오퍼와 포지셔닝을 프레임으로 사용합니다. 규칙 및 테스트: references/page-rules.md.
모든 의도가 이유와 함께 한 페이지 또는 none에 매핑되고, 트래픽 또는 링크가 있는 모든 기존 URL에 마이그레이션 작업이 있으면 완료됩니다.
7. 모든 페이지 사양 작성
각 페이지에 대해: URL, 제목 태그, H1, 목적, 대상 의도 및 그 증거, 섹션 개요, 기본 CTA, 브레인의 실제 증거(또는 GAP: 표시), 내부 링크 및 스키마 유형. 그런 다음 site-plan.md와 sitemap.csv를 작성하고 드래프트 모드에서 검증기를 실행합니다:
bun $SKILL/scripts/check-site-plan.ts <project>/site-plan --draft
드래프트 검사가 통과되면 완료됩니다.
8. 승인 루프
사이트맵 트리를 보여준 다음 페이지 사양을 3~4개씩 배치로 보여줍니다. 사용자가 승인, 편집 또는 제거하는 각 페이지에 대해 편집을 적용하고 드래프트 검사를 다시 실행한 후 변경 사항을 표시합니다. 모든 결정을 날짜와 함께 decisions.md에 기록합니다. 사용자가 전체 계획을 승인할 때까지 반복합니다.
모든 페이지의 최신 결정과 계획 자체가 approved이면 완료됩니다.
9. 저장 및 인계
최종 파일(site-plan.md, decisions.md, sitemap.csv, research/)을 작성하고 state.json을 approved로 설정한 후 전체 검사를 실행합니다:
bun $SKILL/scripts/check-site-plan.ts <project>/site-plan
프로젝트 노트(docs/project.md 또는 이에 상응하는 파일, 생성 전에 한 번 물어봄)에 날짜가 포함된 항목을 추가합니다: 무엇이 계획되었는지, 저장 위치, 검사 결과 및 다음 단계(일반적으로 mos-atomic-design-system). 웹사이트 프로젝트가 이미 git 저장소인 경우 명시적 경로로 계획 파일을 스테이징하고 커밋합니다. 비밀, .env 파일 또는 원시 도구 응답은 절대 스테이징하지 않으며 푸시하지 않습니다. 커밋 규칙: references/output-format.md.
다음 항목으로 종료합니다: 변경된 사항, 검사 출력, 미해결 격차 및 차단 요소, 정확한 다음 작업. 검사가 통과했다고 보고하려면 이 세션에서 실제로 실행되고 통과했을 때만 가능합니다.
참조 맵
| 파일 | 읽어야 할 때 |
|---|---|
references/interview.md | 2~4단계: 카드, 질문 은행, 배치 및 브리프 재생 |
references/research.md | 1단계와 5단계: 도구 감지, 각 연구 방법, 대체 방안 및 비용 |
references/page-rules.md | 6단계: 의도 클러스터링, 위치 페이지, 캐니벌라이제이션, 마이그레이션 맵 |
references/output-format.md | 7~9단계: 검증기가 적용하는 형식, 상태, 결정 및 커밋 |
assets/ | 모든 출력 파일의 시작 템플릿 |
scripts/check-site-plan.ts | --help; 7~9단계에서 실행 |
scripts/test-check-site-plan.ts | 검증기가 각 중단된 계획을 실패시키는 증명 |
관련 스킬
MarketingOS GEO 팩(mos-geo-skills)의 선택적 후속 스킬, 여기에 이름이 명시되어 있으며 별도로 설치됩니다: mos-geo-topic-clusters (6단계 전에 대규모 Search Console 또는 Ahrefs 내보내기를 클러스터링), mos-geo-brand-360 (AI 답변 확인), mos-geo-fan-out-map (사이트가 라이브된 후).