jahidulislamseo/antigravity-ai-skills

브리프 관리 (Brief Management)

브리프(Brief)는 로컬 SEO 업무를 위한 지속적인 작업 상태입니다. 위치당 하나의 브리프가 생성됩니다. 멀티로케이션 작업을 위한 브랜드 롤업(brand rollup)을 지원합니다. 예약된 작업 출력물이 브리프를 시간이 지남에 따라 확장하여, 각 비즈니스에 대한 모든 스캔, 감사, 보고서, 발견 사항의 복합적인 히스토리를 구축합니다.

---

구조

briefs/
  {brand}/
    _brand.brief.md          ← 설정 + 모든 위치에 대한 롤업
    reports/                 ← 브랜드 수준 롤업 보고서
    {location}/
      location.brief.md      ← 항상 최신 상태, 항상 간결함
      reports/               ← 주간, 월간, 분기별(QBR) 보고서
      scans/                 ← 지오그리드 스캔, 인용 감사, 페이지 감사
      drafts/                ← GBP 게시물, 승인 대기 중인 리뷰 응답
      alerts/                ← 모니터링 알림

---

최초 실행 감지

이 섹션이 가장 중요합니다. 사용자가 특정 비즈니스를 언급했지만 기존 브리프가 없는 경우, 아직 요청을 처리하지 마십시오. 먼저 설정을 실행한 후, 사용자가 요청한 작업으로 돌아가십시오.

감지

특정 비즈니스에 대한 작업을 수행하기 전에 기존 브리프가 있는지 확인하십시오:

• Claude Code: briefs/{brand-slug}/{location-slug}/location.brief.md 파일을 찾으십시오.
• Claude Project: Project 지식 베이스에서 이 비즈니스에 대한 브리프 파일을 확인하십시오.
• 찾은 경우: 브리프에서 재개 로 이동
• 찾지 못한 경우: 최초 실행 설정 으로 이동

최초 실행 설정

사용자에게 다음과 같이 말하십시오:

"[Business Name]에 대한 브리프가 아직 없습니다. 앞으로 모든 것을 추적할 수 있도록 몇 가지 세부 정보를 먼저 알려주세요. 약 2분 정도 소요됩니다."

그런 다음 아래 질문을 한 번에 하나씩 물어보십시오. 한꺼번에 모두 묻지 마십시오:

Q1: "순위를 올리고 싶은 주요 키워드는 무엇인가요? (예: 'plumber buffalo ny')"

Q2: "웹사이트 URL은 무엇인가요?"

Q3: "서비스 지역 범위는 어느 정도인가요? (예: 5마일, 20마일)"

Q4: "이 작업을 클라이언트를 위해 관리하고 계신가요, 아니면 본인 사업인가요?"

• 클라이언트인 경우: "보고서를 받을 클라이언트의 이메일은 무엇인가요?"
• 본인 사업인 경우: 건너뜀

Q5: "Slack 채널로 알림과 보고서를 보내드릴까요?" (선택 사항, 아니라고 하면 건너뜁니다)

이것으로 충분합니다. 명확히 모호한 경우가 아니라면 이것보다 더 많이 묻지 마십시오.

질문 후

1. 브리프 폴더 구조 생성:

   • briefs/{brand-slug}/{location-slug}/location.brief.md
   • briefs/{brand-slug}/{location-slug}/reports/
   • briefs/{brand-slug}/{location-slug}/scans/
   • briefs/{brand-slug}/{location-slug}/drafts/
   • briefs/{brand-slug}/{location-slug}/alerts/
   • briefs/{brand-slug}/_brand.brief.md

2. 답변 및 대화 컨텍스트에서 Identity 섹션 채우기

3. Q4/Q5 답변을 기반으로 _brand.brief.md 승인 블록 구성

4. 초기 감사를 자동으로 실행합니다. 허가를 묻지 마십시오:

   • LocalSEOData local_audit
   • LocalSEOData business_profile + profile_health
   • LocalSEOData geogrid_scan (7x7, 주요 키워드, 명시된 반경)
   • LocalSEOData citation_audit
   • LocalSEOData review_velocity + google_reviews
   • LocalSEOData competitor_gap

5. 감사 결과에서 Findings 섹션 채우기

6. Next Action을 가장 우선순위가 높은 단일 수정 사항으로 설정

7. 예약 작업 설정 제안:

   "브리프가 생성되었고 초기 감사가 완료되었습니다. [중대한 이슈 X개, 중요한 이슈 Y개]를 발견했습니다. [한 문장으로 요약된 최우선 발견 사항].

   자동 모니터링을 설정하시겠습니까? 주간 순위 스캔, 리뷰 모니터링, GBP 변경 감지, 월간 보고서를 자동으로 실행하도록 구성할 수 있습니다."

   예인 경우: tasks/README.md의 작업 목록을 살펴보고, 감사 결과에 따라 추천한 후 /schedule로 구성 아니오인 경우: 원래 요청으로 진행

8. 그런 다음 사용자가 원래 요청한 작업으로 돌아갑니다:

   "이제 [원래 요청]을 진행하겠습니다..."

Claude Project / 브라우저 사용자용

파일 시스템 접근 권한이 없는 경우: 동일한 대화 및 감사를 실행한 후, 설정이 끝나면 브리프를 형식화된 텍스트로 출력합니다:

"다음은 브리프입니다. 이 내용을 Project 지식 베이스에 추가하시면 다음에 제가 사용할 수 있습니다:" [브리프 내용]

---

브리프를 생성해야 하는 경우 (최초 실행 외)

최초 실행 외에도, 세션 중간에 다음과 같은 경우 브리프를 생성하십시오:

• 브리프가 없는 비즈니스에 대해 도구 호출이 곧 실행될 예정인 경우
• 사용자가 명시적으로 브리프 생성을 요청한 경우

다음의 경우 브리프를 생성하지 마십시오:

• 특정 비즈니스 없이 일반적인 로컬 SEO 질문인 경우
• 도구 또는 스킬에 대한 설명인 경우
• 실시간 데이터 없이 한 질문에 한 답변만 필요한 경우

---

브리프 위치

Claude Code / Cowork:

briefs/{brand-slug}/{location-slug}/location.brief.md

Claude Project: 브리프 파일을 생성 후 Project 지식 베이스에 업로드하십시오. 사용자가 아직 하지 않은 경우 이 작업을 수행하도록 알리십시오.

---

브리프 업데이트 (수동 세션)

모든 세션이 끝날 때마다:

1. Session Log. 한 줄: 날짜 + 수행한 작업
2. Tools Run. 각 도구 호출: 날짜, 도구, 엔드포인트, 한 줄 발견 사항
3. Findings. 새로운 이슈를 Critical / Important / Monitor로 분류
4. Deliverables. 완료된 항목 표시, 새로운 보류 항목 추가
5. Next Action. 가장 중요한 다음 단계 하나로 덮어쓰기

---

예약 작업 출력 수신

예약된 작업이 출력 파일을 작성하는 경우:

1. 출력 파일 읽기
2. Session Log에 한 줄 추가: [DATE] | {작업 유형} → {한 줄 발견 사항} → {출력 경로} 참조
3. 새로운 Critical 발견 사항이 있는 경우: Findings 섹션 업데이트
4. 현재보다 더 높은 우선순위의 작업이 발견된 경우 Next Action 업데이트
5. 이 위치에 대한 _brand.brief.md Locations 테이블 행 업데이트

브리프는 간결하게 유지됩니다. 세부 사항은 출력 파일에 저장됩니다. 브리프는 인덱스 역할을 합니다.

---

브리프에서 재개

사용자가 비즈니스로 돌아오는 경우:

1. 브리프 읽기
2. 각 하위 폴더에서 가장 최근 출력 파일을 읽어 현재 상태 파악
3. 2-3문장으로 요약: 수행된 작업, 주요 발견 사항, 현재 상태
4. Next Action 설명
5. 질문: "여기서 이어서 진행할까요, 아니면 특정 작업을 원하시나요?"

사용자가 요청하거나 데이터가 30일보다 오래되지 않은 경우, scans/에 결과가 있는 도구를 다시 실행하지 마십시오.

---

복합적 가치

몇 달 동안 예약 작업이 브리프에 기록되면, 히스토리를 쿼리할 수 있습니다:

• "3월에 순위가 떨어진 이유는?" → 해당 기간의 scans/ 파일 확인
• "올해 리뷰 추세는 어땠나요?" → reports/의 리뷰 모니터 확인
• "이 경쟁사는 언제 나타났나요?" → 경쟁사 모니터 확인

출력 파일을 절대 삭제하지 마십시오. 폴더가 너무 커지면 보관(archive)하십시오. 히스토리가 곧 가치입니다.

---

교훈 플라이휠 (Lessons Flywheel)

모든 세션(수동 또는 예약) 동안 다음을 주시하십시오:

• 스킬 파일과 모순되는 데이터를 반환하는 도구
• 3개 이상의 위치에서 나타나지만 문서화되지 않은 패턴
• 문서화된 기대치와 다른 GBP, 알고리즘, AI 플랫폼 동작
• 예상치 못한 동작을 보이는 도구 엔드포인트

발견되면 명시적으로 표면화하십시오:

"이 세션 중에 [X]를 발견했습니다. 이 패턴은 스킬 파일에 없습니다. meta/lessons.md에 추가하여 검토하시겠습니까?"

확인을 기다린 후, 교훈을 작성하십시오.

---

멀티로케이션 브랜드

각 위치 세션 후:

• _brand.brief.md Locations 테이블에서 해당 위치의 행 업데이트
• 3개 이상의 위치에서 패턴이 나타나는 경우에만 Brand-Level Notes에 추가

---

슬러그 형식

소문자, 하이픈, 명확해야 함:

• 브랜드: keystone-insurance, mikes-plumbing
• 위치: buffalo, downtown-chicago, pittsburgh-pa