Communitygithub.com

dubbl-a/house-rules

저장소에 House 설정을 처음으로 구성합니다. house.json 매니페스트, 벤더 규칙, CLAUDE.md 스켈레톤을 제안하며, 기본적으로 드라이 런(dry run)으로 실행됩니다. 'bootstrap house' 또는 'adopt house here'에 사용합니다.

house-rules란 무엇인가요?

이 스킬은 아직 House 규칙을 사용하지 않는 저장소를 House 소비자로 전환하는 부트스트랩(Bootstrap) 프로세스를 제공합니다. 저장소를 분석하여 `house.json` 매니페스트를 제안하고, 사용자의 승인(`--apply`) 후에 벤더 규칙, 템플릿, CLAUDE.md 스켈레톤 파일을 작성합니다. 기존 CLAUDE.md를 덮어쓰지 않으며, 동일한 매니페스트 위에서 두 번 실행되지 않도록 설계되어 있습니다. Claude Code, Cursor 등 AI 코딩 에이전트와 함께 사용할 수 있으며, House 규칙 생태계에 저장소를 안전하게 온보딩하려는 개발자에게 필수적인 첫 단계입니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dubbl-a/house-rules/tree/HEAD/plugins/house/skills/bootstrap

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

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

문서

부트스트랩

Bootstrap은 관리되지 않는 저장소를 House 소비자로 전환합니다. 저장소를 조사하여 house.json을 제안하고, --apply가 사용되면 벤더 규칙, 템플릿, CLAUDE.md 스켈레톤을 작성합니다. 기존 CLAUDE.md를 절대 편집하지 않으며, 동일한 매니페스트 위에서 두 번 실행되지 않습니다. CLAUDE.md의 House 부분만 별도의 스켈레톤 파일로 작성하며, 코드베이스에서 파생된 부분은 Harness의 자체 init 명령어에 맡깁니다. Harness는 시작용 CLAUDE.md를 생성하거나 이미 존재하는 CLAUDE.md에 개선 사항을 제안합니다.

이 스킬은 디스크에 부수 효과(side effects)를 발생시키므로, 자체적으로 실행되지 않습니다. 요청이 있을 때만 실행하세요.

기본 경로

  1. 드라이 런: 저장소를 조사하고 제안된 house.json을 출력합니다. 아무것도 작성하지 않습니다.
  2. 스킬을 실행하는 사람에게 제안을 보여주고 적용 여부를 묻습니다.
  3. 적용: house.json을 작성한 다음, 규칙, 템플릿, 스켈레톤을 렌더링합니다.
  4. 아래 와이어링 블록을 출력하여 사람이 package.json, CI, 터미널에 붙여넣을 수 있도록 합니다.

2단계를 건너뛰지 마세요. 사람이 본 적 없는 제안은 제안이 아니라 놀라움입니다.

매니페스트가 존재하면 거부

조사하기 전에 house.json이 저장소 루트에 이미 존재하는지 확인합니다.

존재한다면 거부합니다. 저장소에 이미 매니페스트가 있다고 출력하고 /house-rules:sync를 대신 가리킵니다. 드라이 런에서도 마찬가지입니다. bootstrap은 첫 번째 제안 위에 두 번째 제안을 초안하지 않습니다. 저장소는 정확히 한 번만 부트스트랩됩니다.

저장소 조사

제안에 필요한 내용을 수집하기 위해 드라이 런에서 CLI를 실행합니다:

node ${CLAUDE_PLUGIN_ROOT}/scripts/house init --repo <path>

조사는 읽기만 하고 쓰지 않습니다:

  • 스택: package.json의 존재, 스크립트, 루트의 프레임워크 설정 파일.
  • 기본 브랜치: git symbolic-ref refs/remotes/origin/HEAD, 실패 시 현재 브랜치로 대체.
  • 최상위 디렉터리: 어떤 선택적 모듈이 적용될지 추측합니다 (db/는 database 제안, 배포 설정은 deployment 제안 등).
  • .claude/rules/ 또는 브랜치 가드 훅이 이미 존재하는지 확인하여, bootstrap이 추가할 항목과 저장소가 이미 가지고 있는 항목을 제안에 명시할 수 있도록 합니다.
  • 저장소의 현재 문서 스캔이 아카이브 계층을 제외하는지 확인하여, 추측이 아닌 관찰된 동작에서 scanArchive를 시드합니다.
  • git check-ignore가 House 쓰기 대상(.claude/rules/house/, .house/)을 무시하는지 확인합니다. 검사기는 git ls-files를 사용하므로, 무시된 규칙 파일은 검사기에 보이지 않으며 첫 번째 실행에서 얻을 수 없는 0을 출력합니다. 조사는 경고하고 수정 방법을 알려줍니다: .claude/나 .house/가 아닌 .claude/settings.local.json만 무시하세요.

house.json 제안

조사에서 배제할 수 없는 모든 모듈은 true나 false가 아닌 "detect"로 제안에 포함됩니다. "detect"는 저장소가 스킬의 추측이 아닌 렌더링 시점에 결정함을 의미합니다. 핵심 모듈(docs, engineering, github, claude-code)은 항상 켜집니다. 요약이 아닌 전체 제안된 house.json 본문을 출력하여, 검토하는 사람이 모든 필드를 읽을 수 있도록 합니다.

적용: 매니페스트, 규칙, 스켈레톤 작성

사람이 적용을 승인한 후에만:

node ${CLAUDE_PLUGIN_ROOT}/scripts/house init --repo <path> --apply
node ${CLAUDE_PLUGIN_ROOT}/scripts/house render --repo <path> --apply

init --apply는 house.json을 작성합니다. render --apply는 벤더 규칙 파일, 템플릿, .house/check.mjs, .house/lock.json, .house/INDEX.md, 그리고 추가 파일 하나를 작성합니다:

  • 저장소에 CLAUDE.md가 있으면, 그 옆에 CLAUDE.md.house-skeleton을 작성합니다. 기존 CLAUDE.md를 열거나 편집하지 마세요.
  • 저장소에 CLAUDE.md가 없어도 CLAUDE.md 자체가 아닌 CLAUDE.md.house-skeleton을 작성합니다. Bootstrap은 저장소의 루트 파일을 절대 생성하지 않습니다. 사람이 스켈레톤을 수동으로 병합합니다.

어느 경우든, 기존 CLAUDE.md는 모든 bootstrap 실행 전후로 바이트 단위로 동일합니다. 이것이 이 스킬이 지켜야 할 제어입니다: 적용 전에 diff를 확인하고, 적용 후에 다시 diff를 확인하여 무언가 변경되었다면 성공을 보고하지 말고 중단하세요.

스켈레톤은 저장소당 한 번 제공됩니다: render는 .house/lock.json의 scaffolds 아래에 기록하므로, CLAUDE.md에 병합되고 삭제된 후에는 더 이상 스켈레톤을 다시 작성하지 않습니다. render --apply --scaffold는 다시 요청하는 방법입니다.

저장소의 .gitignore에 .claude/worktrees/와 .superpowers/가 포함되어 있는지 확인하고, 누락된 줄을 추가합니다. git status에 나타나는 도구 스크래치 파일은 git add -A만으로 커밋될 수 있습니다.

와이어링 출력

성공적인 적용 후, 이 블록을 그대로 출력하여 일반 터미널에 복사하여 붙여넣을 수 있도록 합니다. 아무것도 채우지 마세요; 사람이 자신의 package.json과 워크플로 파일에 맞게 조정합니다.

package.json 스크립트에 추가:
  "check:docs": "node .house/check.mjs --only=drift,todo"
  "check:house": "node .house/check.mjs"

다음을 실행하는 CI 단계 추가:
  node .house/check.mjs

머신당 한 번 플러그인 설치:
  claude plugin marketplace add dubbl-a/house-rules
  claude plugin install house-rules@house-rules --scope user

클론당 한 번 git 훅 설정 (render --apply와 모든 세션 시작도 이 작업을 수행합니다):
  git config core.hooksPath "$(pwd)/.githooks"

core.hooksPath는 .git/config에 저장되며, 어떤 클론이나 PR에도 전달되지 않으므로, 벤더링된 .githooks/ 트리는 무언가 설정하지 않는 한 새 체크아웃에서는 비활성 상태입니다. render --apply와 플러그인의 SessionStart 훅 모두 이를 설정합니다; 위의 줄은 둘 다 없는 클론을 위한 것입니다. 이들도 사람도 다른 도구가 이미 소유한 core.hooksPath를 덮어쓰지 않아야 합니다.

저장소에 .claude/settings.local.json이 없으면 출력에 명시하세요. 이 파일은 저장소별로 House 모듈이나 훅을 옵트아웃하는 위치이며, 이 파일이 없으면 저장소가 기본값으로만 실행되고 있음을 의미합니다.

부트스트랩 후

사람에게 아직 완료되지 않은 작업을 알립니다: 스켈레톤을 CLAUDE.md에 수동으로 병합한 후 삭제해야 하며(다시 작성되지 않음), 와이어링 블록을 아직 붙여넣어야 하며, node .house/check.mjs는 첫 번째 커밋 전에 로컬에서 실행할 가치가 있습니다. 저장소가 상속된 실패가 아닌 깨끗한 게이트에서 시작하도록 말이죠. 렌더링된 파일을 먼저 경로별로 스테이징하세요(house.json .house/ .claude/rules/house/ 및 scripts/house/는 렌더가 해당 디렉터리에 파일을 나열한 경우에만 추가, git은 일치하는 항목이 없는 경로를 거부하므로): 스테이징될 때까지 매니페스트 패밀리는 파일당 [untracked] 경고를 출력하고, 전체 .claude/ 또는 .house/ 무시는 [gitignored] 결과를 초래합니다. git이 볼 수 없는 파일은 패밀리 검사 대상이 아니기 때문입니다. 이 중 어떤 것도 이 스킬이 대신 수행할 작업이 아닙니다; bootstrap은 렌더링에서 중단됩니다.

금지 사항

  • 드라이 런 중에는 house.json이나 렌더링된 파일을 작성하지 마세요. 드라이 런은 출력만 합니다.
  • 기존 CLAUDE.md를 어떤 플래그 아래에서도 덮어쓰거나 추가하지 마세요.
  • 이미 house.json이 있는 저장소에 다시 제안하지 마세요. /house-rules:sync로 안내하세요.
  • 조사가 모호할 때 모듈을 켜거나 끄는 것으로 추측하지 마세요. "detect"를 제안하고 저장소가 결정하도록 하세요.

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

관련 스킬