touchstone

Touchstone은 GitHub 프로젝트 전반에서 다수의 AI 에이전트를 이끄는 혼자 작업하는 개발자에게 기준점을 제시합니다. 핵심 구성 요소는 두 가지로, 워크플로우 표준(브랜치 우선 생성, 단일 목적 커밋, 필수 발견 문제 해결, 게이트 통과 요건 충족)을 에이전트에 지시하는 가이드 프롬프트와 올바른 GitHub 사용 패턴을 적용하는 푸시 도구(CLI)입니다. 이 시스템은 저장소가 추가 조치 없이도 올바른 상태를 유지하는 '설정 후 자동 관리' 방식으로 개발 흐름을 표준화합니다. CLI는 선언된 프로젝트 체크 유효성을 검증하고, 트래커 주장 확인, GitHub 정책 적용, 네 가지 제한된 PR 작업(개방, 상태 확인, 병합, 응답)을 제공합니다. 코드 스테이징, 커밋, 푸시는 수행하지 않으며 GitHub의 병합 결정을 대체하지 않습니다. 모든 작업에는 문서화된 원시 git/gh 복구 경로가 포함됩니다. Touchstone은 세 가지 원칙에 따라 작동합니다: GitHub 규칙을 통해 기본 브랜치로의 배포를 제한(직접/강제/검토 없이 푸시 거부), 네이티브 GitHub 인터페이스(git, PR, 이슈)를 통해 상태 가시성 확보, 모든 프로젝트와 에이전트에 걸쳐 일관된 규칙 유지. 주요 운영 규칙 중 하나는 규칙 적용이 실제로 적용 가능한 계층에서 이뤄져야 한다는 점입니다(GitHub가 규칙셋/필수 체크를 처리하고 스크립트는 관찰 및 순차 처리만 담당). 병합 게이트는 정확한 헤드 판정 시스템을 구현하며, 리뷰 게이트 워크플로우는 현재 PR 헤드에 바인딩된 신뢰할 수 있는 정밀 판정에 대해서만 성공합니다. 설치는 Homebrew(macOS) 또는 플랫폼 무관 릴리스 스크립트를 통해 이뤄지며, 채택 과정은 프로젝트 사실 선언과 문서화된 명령어를 통한 감사된 GitHub 정책 적용으로 구성됩니다.