Communitygithub.com

cogni-work/insight-wave

이 스킬은 cogni-website 프로젝트의 진행 상황을 요약하고, 작업을 재개하거나 상태를 확인합니다. 세션 간 웹사이트 작업으로 복귀하는 기본 진입점이며, 사용자가 "웹사이트 계속", "웹사이트 재개", "웹사이트 상태", "어디까지 했지", "Website fortsetzen", "Website-Status", "weiter mit der Website", "was fehlt noch", "이어서 작업", "웹사이트 상태 확인"과 같은 표현을 사용하거나, 기존 웹사이트 프로젝트와 관련된 세션을 열 때 트리거되어야 합니다.

insight-wave란 무엇인가요?

`insight-wave`는 웹사이트 프로젝트의 현재 상태를 감지하고 진행 상황을 시각화한 후, 적절한 다음 스킬로 안내하는 인텔리전트 진입점 역할을 합니다. `website-project.json` 파일을 스캔하여 프로젝트의 설정 완료 여부, 페이지 계획 수립, 빌드 진행률, 법적 페이지 생성 상태 등을 분석합니다. 또한 콘텐츠 소스의 변경 사항(새 마케팅 아티클, 포트폴리오 제품 등)과 상류(upstream) 데이터 소스의 변화(추세 보고서, 연구 프로젝트 등)를 감지하여 프로젝트 계획을 최신 상태로 유지하도록 돕습니다. Claude Code, Cursor, Codex 등 AI 에이전트 환경에서 작동하며, 사용자의 짧은 명령어(예: "계속", "재개", "상태 확인")를 인식하여 적절한 행동을 추천합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cogni-work/insight-wave/tree/HEAD/cogni-website/skills/website-resume

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

웹사이트 재개

웹사이트 프로젝트의 현재 상태를 감지하고, 진행 상황을 표시하며, 적절한 다음 스킬로 안내합니다.

워크플로우

1. 웹사이트 프로젝트 찾기

website-project.json을 다음 경로에서 스캔합니다.

  • 현재 디렉토리
  • cogni-website* 또는 *-website 패턴과 일치하는 직계 하위 디렉토리

찾을 수 없는 경우 사용자에게 알리고 website-setup을 제안합니다.

2. 프로젝트 상태 평가

사용 가능한 파일을 읽고 프로젝트 단계를 결정합니다.

파일 존재 여부단계상태
website-project.json만 있음설정 완료계획 필요
+ website-plan.json계획 완료빌드 필요
+ output/website/index.html빌드 완료미리보기 가능
+ output/website/css/style.css + 페이지들완전히 빌드됨배포 가능

다음 항목을 계산합니다.

  • 계획된 페이지 수 (website-plan.json에서)
  • 빌드된 페이지 수 (output/website/ 내 HTML 파일)
  • 누락된 페이지 (계획되었으나 빌드되지 않음)
  • 콘텐츠 소스 최신 상태 (소스 파일 날짜와 빌드 날짜 비교)

3. 상태 표시

웹사이트 프로젝트: {slug}

  단계:           {현재 단계}
  회사명:         {회사 이름}
  테마:           {테마 이름}
  언어:           {언어}

  계획된 페이지: {N}
  빌드된 페이지: {M} / {N}
  누락된 페이지: {목록 (있는 경우)}

  법적 사항:
    법적 관할권: {관할권 또는 "아직 설정되지 않음"}
    법적 페이지: {3/3 생성됨 | 0/3 누락됨 | ⚠ legal_config 없음}
    미해결 TODO: {n개의 미완성 «TODO: ...» 마커}

  마지막 수정일: {날짜}

법적 상태를 평가할 때 website-project.json에서 legal_config.jurisdiction을 읽고, website-plan.json에서 legal-* 페이지 항목을 스캔하며, content/legal/*.md에서 «TODO: 마커를 grep으로 검색합니다.

4. 다음 행동 추천

상태에 따라:

상태추천
설정 완료, 계획 없음→ /website-plan — 페이지 구조 계획하기
계획 완료, 빌드 없음→ /website-build — 웹사이트 생성하기
빌드 완료→ /website-preview — 웹사이트 검토하기
빌드가 오래됨 (소스가 빌드보다 최신)→ /website-build — 웹사이트 업데이트 (소스 변경됨)
부분 빌드 (일부 페이지 누락)→ /website-build — 누락된 페이지 생성하기

5. 콘텐츠 변경 감지

사이트가 이미 빌드된 경우, 마지막 빌드 이후 소스 콘텐츠가 변경되었는지 확인합니다.

  • 소스 파일의 수정 시간 (website-plan.json의 source_files)과 출력 HTML 파일 비교
  • 소스가 빌드된 HTML보다 최신인 페이지 플래그 지정
  • 부분 재빌드(변경된 페이지만) 또는 전체 재빌드 제공

6. 상류(Upstream) 변경 감지

website-setup과 동일한 glob을 사용하여 콘텐츠 발견을 다시 실행하고 website-project.json에 저장된 content_discovery 개수와 비교합니다.

  • 새로운 엔터티: 예: 포트폴리오에 새 제품이 추가되거나 새 마케팅 아티클 게시 → 재계획을 위해 업데이트 제안
  • 제거된 엔터티: 계획에서 참조된 소스 파일이 더 이상 존재하지 않음 → 오래된 계획 경고
  • 새로운 상류 플러그인: 프로젝트 생성 시 존재하지 않았던 **/tips-project.json 및 **/output/draft-v*.md를 glob으로 찾음(즉, sources.trends_project 또는 sources.research_projects가 null/비어 있지만 이제 프로젝트가 존재함) → 새 콘텐츠 소스를 발견하기 위해 setup 재실행 제안

변경 사항 표시:

마지막 빌드 이후 변경 사항:

  새 콘텐츠:
    ✚ 새 마케팅 아티클 2개
    ✚ 포트폴리오에 새 제품 1개

  사용 가능한 새 콘텐츠 소스:
    ✚ 추세 보고서 발견됨 (이전에는 포함되지 않음)

  추천: /website-setup을 다시 실행하여 새 소스를 통합하세요

추천 표에 추가:

상태추천
새 콘텐츠 소스 발견됨→ /website-setup — 새 소스 통합 후 다시 계획 수립
기존 소스에 새 엔터티 발견→ /website-plan — 페이지 구조 업데이트
legal_config.jurisdiction이 설정되었지만 계획에 legal-* 페이지 없음→ /website-legal — 필수 페이지 생성
legal_config.jurisdiction이 null→ /website-legal — 법적 관할권 설정 및 필수 페이지 생성
content/legal/*.md에 미완성 «TODO: ...» 마커 있음→ /website-legal — 누락된 필드 보완

관련 스킬