Repolode
coldteadotai

coldteadotai/abide

결정 모델로 모든 수정과 턴을 검사하고 위반 사항을 에이전트가 고치도록 요청해 프로젝트의 AI 에이전트 지침을 준수하게 합니다.

스타
623
포크
47
열린 이슈
5
마지막 커밋
27일 전

어떤 프로젝트인가요?

Abide는 Claude Code, Codex, OpenCode, Pi 같은 코딩 에이전트를 위한 도구입니다. AGENTS.md나 CLAUDE.md 같은 프로젝트 지침 파일에는 "원시 오류가 사용자에게 노출되지 않게 할 것"처럼 린터로 검사할 수 없는 규칙이 들어 있습니다. Abide는 각 규칙을 질문으로 바꾸고, 수정이 끝날 때마다 또는 턴이 끝날 때 Jev(TypeSafe의 결정 모델)에 확률을 묻습니다. Jev는 대화 내용은 보지 않고 규칙과 diff만 확인합니다.

규칙 위반 점수가 기준을 넘으면 에이전트에 위반한 규칙을 알려 주고 같은 턴 안에 코드를 수정하게 합니다. 점수가 중간 정도면 수정 요청은 하지 않고 사용자에게 알림을 표시합니다. 규칙은 읽기 쉽고 커밋에 포함할 수 있는 .abide/rubric.json 파일에 저장되므로, 잘못된 판정이 나오면 규칙의 표현을 바꿔 해결할 수 있습니다. 기존 파일 감사, 커밋되지 않은 변경 사항 검사, 과거 세션 재실행을 위한 명령도 제공합니다.

TypeSafe 또는 Vercel AI Gateway 키를 사용해 npx로 설정합니다. 에이전트별로 훅을 설치하거나 프로젝트에 설치해 팀원이 저장소를 체크아웃할 때 함께 가져가도록 할 수 있습니다.

핵심 기능

  • 01지침 파일의 각 규칙을 기준으로 수정 사항이나 턴을 검사합니다.
  • 02위반한 규칙을 알리고 같은 턴 안에 코드를 수정하도록 에이전트에 요청합니다.
  • 03규칙을 커밋할 수 있는 읽기 쉬운 루브릭 파일에 저장합니다.
  • 04Claude Code, Codex, OpenCode, Pi를 지원합니다.
  • 05기존 파일을 감사하고 커맨드라인에서 커밋되지 않은 변경 사항을 검사합니다.
  • 06파일 glob으로 규칙 적용 범위를 지정하고 .abideignore로 파일을 제외할 수 있습니다.

활용 사례

  • 필수 검증 라이브러리나 린터로 검사할 수 없는 오류 처리 방식 같은 규칙을 강제할 때.
  • 긴 코딩 세션 중 에이전트가 불필요한 추상화나 지나치게 큰 파일을 추가하지 못하게 할 때.
  • 기존 코드베이스가 문서화된 지침을 따르는지 감사할 때.
  • 프로젝트를 체크아웃하는 팀원과 에이전트 규칙을 공유할 때.

빠른 시작

  1. 1

    TypeSafe 또는 Vercel AI Gateway 키를 저장하세요

    npx @coldtea/abide login
  2. 2

    이 컴퓨터의 모든 에이전트에 hooks를 설치하세요

    npx @coldtea/abide init
  3. 3

    평소처럼 에이전트(claude, codex, opencode 또는 pi)를 시작하세요

사용 전 알아둘 점

  • 검사하려면 TypeSafe API 키 또는 Vercel AI Gateway 키와 네트워크 액세스가 필요합니다.
  • Codex에서는 새 hook 항목을 수락하려면 /hooks에서 수동으로 작업해야 합니다.

포함된 컬렉션

토픽

자주 묻는 질문

abide은(는) 무엇인가요?
결정 모델로 모든 수정과 턴을 검사하고 위반 사항을 에이전트가 고치도록 요청해 프로젝트의 AI 에이전트 지침을 준수하게 합니다. Abide는 Claude Code, Codex, OpenCode, Pi 같은 코딩 에이전트를 위한 도구입니다. AGENTS.md나 CLAUDE.md 같은 프로젝트 지침 파일에는 "원시 오류가 사용자에게 노출되지 않게 할 것"처럼 린터로 검사할 수 없는 규칙이 들어 있습니다. Abide는 각 규칙을 질문으로 바꾸고, 수정이 끝날 때마다 또는 턴이 끝날 때 Jev(TypeSafe의 결정 모델)에 확률을 묻습니다. Jev는 대화 내용은 보지 않고 규칙과 diff만 확인합니다.
abide은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
abide은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
abide은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. abide의 마지막 커밋은 2026년 10월 10일입니다.
abide은(는) 어디에 사용할 수 있나요?
필수 검증 라이브러리나 린터로 검사할 수 없는 오류 처리 방식 같은 규칙을 강제할 때. 긴 코딩 세션 중 에이전트가 불필요한 추상화나 지나치게 큰 파일을 추가하지 못하게 할 때. 기존 코드베이스가 문서화된 지침을 따르는지 감사할 때. 프로젝트를 체크아웃하는 팀원과 에이전트 규칙을 공유할 때.
abide는 어떻게 설치하나요?
TypeSafe 또는 Vercel AI Gateway 키를 저장하세요: npx @coldtea/abide login 이 컴퓨터의 모든 에이전트에 hooks를 설치하세요: npx @coldtea/abide init 평소처럼 에이전트(claude, codex, opencode 또는 pi)를 시작하세요
abide은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/coldteadotai/abide

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트