model-citizen

Model Citizen은 코딩 에이전트를 위한 제어 플레인으로, 사용하는 규칙 라이브러리나 오케스트레이션 계층 아래에 위치하도록 설계되었습니다. 규칙, 스킬, 역할, 스탠스를 한 번 정의한 뒤 Claude Code와 Codex에 투영하고, 훅으로 이를 강제하며 각 세션이 무엇을 했고 얼마를 지출했는지 원장에 기록합니다. 주요 기능은 다음과 같습니다: - **판단이 있는 가드레일**: 훅은 셸 명령 등급화(읽기 전용부터 비가역까지), 저장소의 게이트가 빨간색일 때 턴 중지, 최신 컨텍스트 검토, 시크릿 탐지, 신뢰할 수 없는 도구 출력 무력화, 샌드박싱 같은 결정적 검사를 처리합니다. - **되돌릴 수 있는 설정**: 동기화에는 드라이 런이 있고, diff는 드리프트를 보여주며, 소유권 저널이 변경을 기록하고, 제거는 채택한 것을 복원합니다. 공유 프리미티브는 한 곳에 존재하고 각 런타임의 네이티브 설정으로 동기화됩니다. - **비용 및 사용량 가시성**: 비용 자세(절약, 균형, 최대)는 역할별 모델, 노력, 소프트 예산을 설정합니다. 모델 계층화는 역할을 특정 모델이 아니라 역량 등급(프런티어, 강력, 표준, 경량)에 할당합니다. 사용량 피드는 턴 및 서브에이전트 비용을 보고하고, 결정 로그는 훅 결정을 기록합니다. - **읽기 쉬운 출력**: 보이스 스탠스(간결, 답변 카드, 스캔 가능)가 출력을 형성합니다. Review Card 계획은 한 화면 카드로 시작해 빌드 게이트에서 멈춥니다. 서브에이전트 반환은 발견 사항과 단어 수 제한으로 제한됩니다. - **측정 가능한 규칙**: 모든 규칙은 트랜스크립트에 대한 결정적 탐지기를 명명하거나 결정할 수 없는 이유를 설명합니다. 그렇지 않으면 린트가 커밋을 실패시킵니다. 사용량 보고서는 각 규칙이 얼마나 자주 발동했는지 보여줍니다. - **선호도 스위치**: 아홉 가지 스탠스 차원(자율성, 위임, 테스트, 비용, 보이스, 커밋, 계획, 라이선싱, 구축 대 구매)이 각각 이름 있는 변형과 함께 제공됩니다. 기본값을 설정하고 저장소나 세션별로 재정의하며, 자신만의 스탠스 차원을 Markdown 폴더로 작성할 수 있습니다. Claude Code CLI(macOS, Linux)를 qualified로 지원하며, Codex CLI 및 기타 클라이언트는 unqualified 또는 계획 상태입니다. 이 하네스는 LLM API 게이트웨이나 모델 제공자가 아니며, 모델 접근과 네이티브 권한은 Claude Code와 Codex가 계속 담당합니다. 설치는 한 줄 스크립트 또는 수동 클론으로 가능합니다. sync, doctor, uninstall 명령이 구성과 소유권을 관리합니다. 이 프로젝트는 MIT 라이선스이며 기여를 환영합니다.