[📦자료] 바이브킷 1.1 업데이트 공유

[서벌먕먕이(kwo1256)]

servaltullius/vibe-kit-seed: 바이브킷 배포 용

바이브코딩 팁 - 바이브킷 제작기 - 특이점이 온다 마이너 갤러리

오늘자 바이브섹스 근황 - 특이점이 온다 마이너 갤러리

위 2개 글을 기반으로 한 

커스텀 바이브킷입니다.

1.0에서   기존 글을 다시 재점검 분석하여

개선한 1.1 업데이트 입니다.

1) 이 레포는 “배포/설치”용입니다 (중요)

• vibe-kit-seed는 앱(UI/아키텍처) 스타터 템플릿이 아닙니다.
• 이 레포를 서브모듈/의존성으로 “도입”하는 방식이 아니라, GitHub Releases에 올라간 산출물(시드/설치기/체크섬) 을 받아서 내 레포(target repo) 에 설치하는 방식입니다.
• 목적은 “기술스택 고정”이 아니라, 내 레포에 맞게 커스텀 가능한 repo-local 도구(vibe-kit) 를 심는 것입니다.

2) 배포 모델 (권장)

• Source of truth: GitHub Releases (버전 태그 + immutable assets)
• Mirror: Google Drive(선택). 편의용 미러이며 항상 SHA256으로 검증합니다.

3) 설치 흐름 (target repo에서)

GitHub Releases의 같은 릴리즈에서 아래 3개 파일을 내려받습니다:

• VIBEKIT_SEED-<version>-<sha256>.md
• vibekit_seed_install.py
• SHA256SUMS

검증:

• Linux/macOS: sha256sum -c SHA256SUMS
• Windows(PowerShell): Get-FileHash .\\VIBEKIT_SEED-...md -Algorithm SHA256 (값을 SHA256SUMS와 비교)

설치(권장: dry-run → apply):

• dry-run: python3 vibekit_seed_install.py install VIBEKIT_SEED-...md --root . --expected-seed-sha256 <sha256>
• apply: python3 vibekit_seed_install.py install VIBEKIT_SEED-...md --root . --expected-seed-sha256 <sha256> --apply

설치 결과(요약):

• target repo에 .vibe/ + scripts/vibe.py 등이 파일로만 설치됩니다.
• 설치기는 기본적으로 어떤 스크립트도 자동 실행하지 않습니다.
• 런타임 산출물은 .vibe/db/, .vibe/reports/ 등에 생성되며 보통 gitignore를 권장합니다.

vibe-kit 주요 기능 (설치 후, target repo에서 사용)

설치 후에는 target repo에서 아래처럼 사용합니다:

• (권장) 레포 자동 설정(한 번): python3 scripts/vibe.py configure --apply
• 진단/요약 생성: python3 scripts/vibe.py doctor --full
  • 출력: .vibe/context/LATEST_CONTEXT.md, .vibe/reports/* (gitignore 권장)
• 변경 감시(선택): python3 scripts/vibe.py watch
• 컨텍스트 DB 검색: python3 scripts/vibe.py search "<query>"
• 영향도(간단) 분석: python3 scripts/vibe.py impact <path>
• (설계/경계 점검) 아키텍처 경계 위반 체크: python3 scripts/vibe.py boundaries (config-driven)
• (설계/디커플링 도움) 변경 결합(change coupling): python3 scripts/vibe.py coupling
  • (옵션) 리네임/이동 보정: python3 scripts/vibe.py coupling --detect-renames
  • (옵션) 포맷팅/대량 수정 커밋 노이즈 완화: python3 scripts/vibe.py coupling --max-churn-per-commit 5000
  • playbooks 문서: .vibe/reports/decoupling_suggestions.md
• 에이전트에 주기 위한 요약팩: python3 scripts/vibe.py pack --scope=staged|changed|path|recent --out .vibe/context/PACK.md
• Git hook(선택): python3 scripts/vibe.py hooks --install (pre-commit에 .vibe/brain/precommit.py 연결)
• 레포별 커스텀(선택): .vibe/config.json에서 exclude_dirs, include_globs, quality_gates, checks 등을 조정

4) 레포별 커스텀의 핵심

• vibe-kit은 “우리 레포 구조/스택”에 맞게 설정을 바꿔 쓰는 것이 전제입니다.
• 기본 커스텀 포인트:
  • 스캔 범위: exclude_dirs, include_globs
  • 품질 게이트: quality_gates.*
  • 커맨드 기반 체크: checks.doctor, checks.precommit
  • 경계 규칙(금지 의존성): architecture rules (예: domain이 infra를 직접 import 못 하게)

5) (유지보수자용) 새 릴리즈 만드는 법

이 레포에서 릴리즈 산출물 생성:

• python3 scripts/make_release_assets.py <version> --out-dir dist/<version> --force

그 다음:

• GitHub Release를 만들고(태그 포함) 위 3개 파일을 assets로 업로드
• SHA256SUMS 내용을 릴리즈 노트에 그대로 붙여 넣기
• Drive 미러를 쓸 경우: Drive는 미러, GitHub Release SHA256이 검증 기준임을 공지 (자세한 템플릿은 RELEASE_CHECKLIST.md)