Communitygithub.com

dubbl-a/house-rules

현재 세션의 핸드오프 스냅샷(SHA, 트리 상태, 출시된 PR, 주요 발견 사항, 다음 단계)을 출력하고, 다음 주기 작업에 대해서만 실제 이슈를 열며, 결정에 의해 연기된 사항은 해당 결정이 있는 곳에 기록합니다. '마무리' 또는 '핸드오프'에 사용하세요.

house-rules란 무엇인가요?

이 스킬은 AI 에이전트 세션이 종료될 때 다음 세션이 읽을 고정된 형태의 스냅샷을 생성합니다. Git SHA, 작업 트리 상태, 출시된 PR, 주요 발견 사항, 다음 주기 작업 목록, 결정에 의해 연기된 항목 등을 포함한 스냅샷을 출력하며, 스냅샷 자체는 파일로 저장하지 않고(재구성 가능하므로) 다음 주기 작업에 대해서만 GitHub 이슈를 생성하거나 기존 이슈와 연결합니다. 결정에 의해 연기된 사항은 CHANGELOG나 코드 주석 등 해당 결정이 이미 존재하는 위치에 이유를 기록하고, 그런 위치가 없을 때만 이슈를 생성하여 종료합니다. 이 스킬은 Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있으며, 사용자가 명시적으로 요청할 때만 실행되도록 설계되었습니다.

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

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

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

문서

핸드오프

핸드오프는 스냅샷을 출력합니다. 다음 세션이 가장 먼저 읽게 될 고정된 형태의 요약입니다. 스냅샷 자체를 위해 아무것도 파일링하지 않는데, 스냅샷은 기본 브랜치, 병합된 PR, 릴리스 노트에서 다시 도출할 수 있으며, 그것을 단순히 반복하는 상시 이슈는 노이즈에 불과하기 때문입니다. 누군가가 실제로 수행할 작업에 대해서만 이슈를 엽니다. 각 다음 주기 항목은 하나의 이슈가 되며, 먼저 열려 있는 이슈와 대조합니다. 결정에 의해 연기된 모든 사항은 그 이유가 이미 존재하는 결정 위치(예: CHANGELOG, 결정 기록, 해당 사이트의 코드 주석)에 기록되는데, 그 이유는 다음 세션이 스스로 재구성할 수 없는 유일한 정보이기 때문입니다.

하네스는 이미 --continue 또는 --resume으로 세션의 전체 기록을 재개하고 시스템 로컬 자동 메모리를 유지하므로, 스냅샷은 이들이 담을 수 없는 것, 즉 다른 머신이나 사람이 저장소나 이슈에서 찾아야 하는 다음 단계와 결정만 전달합니다. 게이트 판정과 카운트 테이블은 의도적으로 포함되지 않습니다. 둘 다 기록된 SHA에 대해 몇 초 만에 다시 실행되며, 다시 실행된 숫자는 복사된 숫자처럼 조작될 수 없기 때문입니다.

이 스킬은 이슈를 열고 닫을 수 있으므로, 스스로 실행되지 않습니다. 요청받았을 때만, 그리고 세션이 실제로 종료되는 시점에만 실행하세요.

기본 경로

  1. 트리 상태 수집: SHA, 정리 상태, 작업 트리, 열린 PR.
  2. 마지막 릴리스 태그 이후(태그가 없으면 세션 시작 이후) 출시된 항목 나열.
  3. 하나의 주요 발견 사항과 그 증거를 명시.
  4. 다음 주기 목록 작성: 순서가 있고 구체적이며, 각 항목에 이유를 함께 제시.
  5. 각 다음 주기 항목에 대해, 이미 해당 항목을 다루는 열린 이슈가 있는지 확인하고, 없을 때만 새 이슈를 열고 그 번호를 기록.
  6. 결정에 의해 연기된 사항에 대해, 그 이유를 결정이 이미 존재하는 위치(CHANGELOG, 결정 기록, 해당 사이트의 코드 주석)에 기록하고, 그러한 위치가 없을 때만 '계획되지 않음'으로 종료된 이슈를 파일링. 단순히 완료되지 않은 작업에 대해서는 이 작업을 수행하지 않음. 그런 작업은 다음 주기 항목으로 남거나 조용히 사라짐.
  7. 레거시 정리: "Session carryover"라는 제목의 열린 이슈가 있으면, 그 내용이 분할된 이슈를 가리키는 설명과 함께 닫음.
  8. 스냅샷을 응답에 출력: 오래됨 경고, 트리 상태, 출시된 항목, 주요 발견 사항, 이슈 번호가 포함된 다음 주기 목록, 결정에 의해 연기된 항목과 각각이 기록된 위치.

트리 상태 수집

저장소의 기본 브랜치에서 다음 명령을 실행하세요. 세션이 현재 작업 중인 브랜치가 아닙니다.

git rev-parse HEAD
git status --short
git worktree list
gh pr list --state open

정확한 SHA, 트리가 깨끗한지 여부, 작업 트리 수, 열린 PR 수를 기록하세요. "상태가 좋다"와 같은 모호한 표현은 트리 상태가 아닙니다. SHA는 다음 세션이 그 아래에서 아무것도 이동하지 않았음을 확인할 수 있게 해주는 사실이며, 모든 게이트와 카운트가 다시 실행되는 기준이기도 합니다. 이것이 바로 그러한 결과가 어디에도 파일링되지 않는 이유입니다.

출시된 항목 나열

마지막 릴리스 태그(없으면 세션 시작)부터 현재 HEAD까지 병합된 모든 PR을 한 줄씩 나열하세요: 번호와 수행한 작업. 병합된 항목이 없으면 이 제목 아래에 "없음"이라고 작성하세요. 목록이 비어 있다고 해서 제목을 생략하지 마십시오. 섹션이 없으면 "아무도 확인하지 않았다"는 의미로 읽히지 "출시된 것이 없다"는 의미로 읽히지 않습니다.

주요 발견 사항 명시

발생한 모든 일에 대한 요약이 아닌, 증거가 뒷받침되는 결정으로서 하나의 발견 사항을 명시하세요. 이번 세션에서 그 기준에 부합하는 것이 없으면, 사소한 관찰을 부풀려 슬롯을 채우기보다 "이번 세션의 주요 발견 사항 없음"이라고 작성하세요.

다음 주기 목록 작성 및 각 항목을 이슈로 전환

구체적인 다음 조치의 순서 목록으로, 각 항목에는 이를 동기부여하는 한 줄짜리 이유가 함께 명시되어야 합니다. "여기서 시작"은 첫 번째 항목이 실제로 다음 세션이 시작해야 할 위치임을 의미하며, 단순히 떠오르는 첫 번째 것이 아닙니다.

각 항목에 대해, 새 이슈를 열기 전에 열린 이슈를 검색하세요.

gh issue list --search "<항목 요약>" --state open

열린 이슈가 이미 해당 항목을 다루고 있으면 해당 이슈의 번호를 사용하세요. 그렇지 않으면 새 이슈를 엽니다.

gh issue create --title "<항목>" --body "<한 줄짜리 이유>"

이슈는 누군가가 수행할 작업을 위해 존재합니다. 이슈가 되지 못한 다음 주기 항목은 다음 세션이 신뢰해야 하는 산문 목록일 뿐이며, 행동할 수 있는 트래커가 아닙니다.

결정에 의해 연기된 사항을 결정이 존재하는 곳에 기록

이번 세션이 의도적으로 수행하지 않기로 선택한 것은 단순히 이번 세션에 도달하지 못한 것과 다릅니다. 첫 번째 종류만 그 이유와 함께 결정이 이미 존재하는 장소(CHANGELOG 항목, 결정 기록, 해당 사이트의 코드 주석)에 기록됩니다. 스냅샷에서 그 장소를 가리키세요. 그러한 장소가 없을 때만 다음과 같이 종료된 이슈로 파일링하세요.

gh issue create --title "<항목>" --body "결정에 의해 연기됨: <이유>"
gh issue close <N> --reason "not planned"

이유는 다음 세션이 스스로 재구성할 수 없는 한 줄입니다. 단순히 완료되지 않은 사항은 기록이 필요 없습니다. 그것은 여전히 다음 주기 항목이거나 결코 약속되지 않았기 때문입니다.

레거시: 열린 캐리오버 이슈 정리

이 관행이 변경되기 전부터 "Session carryover"라는 제목의 이슈가 여전히 열려 있으면 영원히 열어두지 말고 닫으세요.

gh issue list --search "Session carryover" --state open
gh issue close <N> --comment "Retired: split into <이 핸드오프의 이슈 번호들>."

더 이상 그러한 이슈가 없으면 이 단계를 건너뛰세요.

스냅샷 출력

오래됨 경고로 시작하세요. 정신은 다음과 같습니다. "여기에 있는 모든 것은 사용 전에 확인하세요. 이는 스냅샷이며 저장소는 계속 변합니다." 그런 다음 순서대로: 트리 상태, 출시된 PR, 주요 발견 사항, 각 항목의 이슈 번호가 포함된 다음 주기 목록, 결정에 의해 연기된 항목과 각각이 기록된 위치. 응답에 이것을 출력하세요. 파일링되지 않습니다.

탈출구

  • gh CLI가 없거나 인증되지 않은 경우. 그래도 스냅샷과 다음 주기 및 결정에 의해 연기된 항목을 출력하고, 이슈를 열 수 없다고 말한 후 사람이 수동으로 파일링하도록 하세요.
  • 출시된 항목 없음, 주요 발견 사항 없음, 다음 주기 항목 없음, 또는 결정에 의해 연기된 항목 없음. 해당 섹션에서 생략하거나 부풀리지 않고 명확히 언급하세요.

하지 말아야 할 것

  • 스스로 실행하지 마세요. 이슈를 열고 닫을 수 있으며 요청 시에만 실행됩니다.
  • 게이트 판정이나 카운트 테이블을 스냅샷에 복사하지 마세요. 기록된 SHA에서 다시 실행되며, 독자는 복사본이 아닌 다시 실행된 결과를 신뢰합니다.
  • 이미 해당 항목을 다루는 이슈가 있는지 확인하지 않고 다음 주기 항목에 대한 이슈를 열지 마세요.
  • 단순히 완료되지 않은 작업에 대해 이슈를 열지 마세요. 그것은 결정에 의해 연기된 것과 다릅니다.
  • 세션이 최신 상태라고 느껴진다고 해서 오래됨 경고를 생략하지 마세요. 다음 독자는 그것이 명시되지 않으면 알 방법이 없습니다.
  • 주요 발견 사항이 없거나 출시된 목록이 비어 있을 때 스냅샷을 더 실질적으로 보이게 하기 위해 부풀리지 마세요.
  • 이 핸드오프가 실행된 후에도 "Session carryover" 이슈를 열어두지 마세요.

Individual skills in this repo

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

관련 스킬