Agnostic AI: 모든 클라이언트를 위한 하나의 AI 코딩 하네스

하나의 하네스로, 모든 클라이언트에게.

Agnostic AI는 AI 코딩 하네스를 위한 운영 체제입니다. 여기에는 비밀 정보와 파괴적인 명령을 차단하는 가드 후크(guard hooks), 작동 규칙(working agreement/rules), 온디맨드 컨텍스트 모듈, 서브 에이전트(subagents), 저장된 워크플로우, Mods (함수-후크 플러그인), 운영자 도구(operator tools), 예약 작업(scheduled jobs), 그리고 사건을 규칙으로 전환하는 학습 루프가 포함됩니다. 이 시스템은 사용자가 사용하는 클라이언트(Claude Code)에 링크 형태로 설치되고, 그곳에서 기기상의 다른 모든 클라이언트(Codex, Gemini CLI, Cursor 및 16개 이상의 클라이언트)의 방언에 맞춰 포팅됩니다. 사용자의 신원 정보, 개인 규칙, 메모리, 그리고 기기 설정은 사용자만의 작은 사설 오버레이(private overlay)에 유지됩니다.

이것은 오후 만에 설계된 스타터 키트가 아닙니다. 일상적인 사용을 통해 규칙 하나하나씩 성장해 왔으며, 대부분의 기능은 무언가가 먼저 고장 났기 때문에 존재합니다. 모든 가드 뒤에는 사건(incident)이 있고, 모든 문서는 단어 제한(word ceiling)이 있으며, 모든 검사는 처리한 개수를 보고하고, 한 번도 발생하지 않은 실패하는 검사는 '검증됨'으로 간주되지 않습니다.

이 저장소는 처음 공유되었던 이름인 ucsandman/claude-harness로도 게시되었습니다. 둘 다 푸시되는 내용이 같으며, 동일한 커밋을 공유합니다.

• 설치(Install)
• 내부 구성 요소(What is inside)
• 작동 방식(How it fits together)
• 가드(Guards)
• 규칙 및 컨텍스트 모듈(Rules and context modules)
• Mods
• 서브 에이전트 및 워크플로우(Subagents and workflows)
• 도구(Tools)
• 예약 작업 및 학습 루프(Scheduled jobs and the learning loop)
• 20개 클라이언트로 포팅하기(Porting to twenty clients)
• 상태 검사(Health checks)
• 공유되는 것과 사적인 것(What is shared, what stays private)
• 명령어(Commands)
• 문서화(Documentation)
• 저장소 레이아웃(Repository layout)
• 개발(Development)
• 보안(Security)
• 관련 자료(Related)
• 라이선스(License)

git clone https://github.com/ucsandman/Agnostic-AI.git && cd Agnostic-AI
npm run setup # 핵심 가드 연결, 표면 링크, CLAUDE.md 조립, 포팅, 진단(doctor)

Node 18+와 git만 있으면 됩니다. setup은 다음을 수행합니다:

• core/rules를
  ~/.claude/agnostic-rules.md로 컴파일하고,
• 이를 가져오는 CLAUDE.md를 생성하며,
• 핵심 가드를 settings.json에 연결하고,
• ~/.claude/{hooks,tools,mods,agents,workflows}를 링크합니다.

이 체크아웃 디렉토리로 이동합니다 (실제 디렉토리는 옆으로 옮겨지며 절대 삭제되지 않음). 이 하네스를 다른 모든 설치된 클라이언트로 포팅하고 doctor를 실행합니다 (CLAUDE_CONFIG_DIR

(홈을 이동시킴). 계속 사용하는 세 가지 명령어:

npm run sync # 규칙이 변경되었거나 링크가 누락된 경우: recompile, relink, reassemble CLAUDE.md
npm run port # 하네스를 다른 모든 설치된 클라이언트로 푸시
npm run doctor # 드리프트(drift), 두 번째 작성자, 깨진 링크, 오래된 경로, 공개 코드 내의 비공개 경로

템플릿으로 사용하려면: 이 템플릿 사용을 클릭하고, 클론한 다음, npm run setup을 실행합니다.

.
core/port.json

소스 클라이언트를 선택하거나, 대상을 제한하거나, 이유와 함께 후크(hook), 스킬(skill) 또는 MCP 서버를 제외합니다.

연구: Mods 스프린트 레코드, 분리된 빌더, 프로세스 원장, 토큰 흐름 감사. engine/의 어떤 것도 이것에 의존하지 않습니다 |
4 |
examples/ |
참고용으로 설치된 하네스 | 1 |
harness/, storage/ |
캡처된 번들 및 런타임 상태가 모두 gitignore 됩니다.

의존성 방향은 한 가지입니다: core

→ engine

→ 설치된 서피스(surfaces)

→ 클라이언트 홈. 오버레이는 세 개의 이름 붙은 파일을 통해 읽힙니다. 생성되는 파일은 작성자가 하나이며, 두 번째 작성자를 가진 경우 도커(doctor)가 실패합니다.

flowchart LR
core["core/<br/>rules, modules, targets.json,<br/>guards.json, port.json"] --> engine["engine/<br/>sync, setup, doctor, context graph,<br/>hooks, Mods, harness port"]
overlay["overlay/ (private)<br/>profile.md, context-graph.json, gates.json"] -. read by sync .-> engine
...

**캡처(Capture)**는 사용자가 사용하는 클라이언트를 클라이언트 중립적인 번들로 읽어 들입니다: 모든 @import 규칙이 인라인 처리되고, 훅은 하나의 방언에 포함되며, 스킬, 에이전트, 명령어, MCP 서버, 권한 등이 포함됩니다. 토큰처럼 보이는 값은 ${NAME}으로 바뀌며 무엇을 내보내야 하는지 알려줍니다.**적용(Apply)**은 이 번들을 다른 클라이언트의 방언으로 렌더링합니다. 훅은 복사되지 않습니다: 모든 클라이언트는 심(shim)을 통해 동일한 스크립트를 가리킵니다. 스킬들은 연결됩니다.아무것도 파괴되지 않습니다. 생성된 파일에는 포트의 헤더가 포함되며, 사용자가 소유한 파일은 표시된 영역이 생기고 그 외는 보존됩니다. 모든 덮어쓰기는 백업됩니다.--check

드리프트(drift) 시 1로 종료됩니다.모든 변화는 설명됩니다 (npm run explain)를 통해, core/port.json으로부터.

전체 구조와 저장소 레이아웃 및 어댑터 계약을 포함한 세 곳은 docs/architecture.md입니다.

engine/hooks/

에는 41개의 훅이 있습니다: Node 38개, Python 2개, PowerShell 1개. 이들은 Claude Code의 이벤트(PreToolUse, PostToolUse, UserPromptSubmit, Stop, SessionStart, SubagentStart, PreCompact)에서 실행되며, engine/hooks/shim.cjs를 통해 다른 모든 클라이언트에서도 실행됩니다. 하나의 파일인 core/safety/guards.json

,은 모든 가드(guard)가 읽는 정책입니다: 비밀 경로는 항상 차단되고, 하드 스톱 명령어에는 인간의 개입이 필요하며, 누락된 정책은 닫힘(fail closed)으로 작동합니다.

| 세션 상태 | session-count, creds-resolve, correction-tracker, precompact-extract, compaction-ledger, post-edit-diagnostics, skill-telemetry.py, sync-main-checkout.py |
라이브 세션 수 계산, 로컬 볼트에서 .env 채우기, 수정 기록, 압축 전 상태 유지, 구문 검사된 파일, 기술 사용 기록 |
| 거버넌스 | dashclaw-guard, dashclaw-setup |
선택 사항: DashClaw에서 원격 승인을 위해 위험한 호출 보류 |
| 클라이언트 어댑터 | adapters/codex-rewrite, adapters/codex-delegate-guard, universal-adapter |
Codex 페이로드를 Claude 방언으로 변환하고 다시 되돌리기; 각 클라이언트 런타임이 무엇을 할 수 있는지 선언함 |

모든 가드에는 자신이 작성되지 않은 경우를 위한 재정의 마커가 있으며, engine/hooks/tests/ 아래에 의도적으로 실패하게 만드는 프로브가 있습니다. 마커가 있는 명단은 docs/guards.md입니다. 이벤트당 측정 비용은 docs/hook-latency.md입니다.

core/rules/global-rules.md는 모든 클라이언트가 받는 작업 합의서입니다: 협상 불가 사항(비밀, 하드 스톱), 작동 방식, 통신, 완료 정의, 메모리. npm run sync는 이를 (core/traits/traits.md와 함께) 기본 클라이언트 규칙 파일로 컴파일하고; npm run port는 이를 모든 곳으로 가져갑니다.

상황별 텍스트(Situational text)는 독립적인 프롬프트가 아니라 모듈입니다. 모듈은 context: 블록(키워드, 경로 및 명령어 트리거; requires와 suggests 간선)이 있는 마크다운 파일로, 해당 프롬프트, 수정된 파일 또는 명령어가 적용된다고 말할 때, 의존성 순서에 따라 예산 내에서 이유가 첨부되어 로드됩니다.

그래프가 선택하고, 해결하며, 패킹하는 방법: docs/context-graph.md.
당신 자신의 섹션의 CLAUDE.md

은 overlay/profile.md로부터 오며,
절대로 이 리포지토리 안으로 들어오지 않습니다.

engine/mods/는 Claude Code의 후크 엔진 내부에서 프로세스 생성 없이 실행되는 함수-후크 플러그인들을 담고 있습니다: claude-runtime (런타임 어댑터: 이벤트, 판단(judgments), 스냅샷)과 harness-mods (라우팅, 컨텍스트 너지(context nudges), 비밀 마스킹(secret redaction), 서브에이전트 회계(subagent accounting), 읽기 캐시). canary.cjs와 shadow-report.cjs는 클래식 후크로부터 이들을 검증하며, universal-adapter.cjs는 이러한 기능들 중 각 클라이언트가 어떤 것을 가지고 있는지 기록하여, 포트가 사칭하는 대신 Mods 전용 아티팩트를 이유와 함께 떨어뜨리게 합니다. 그 배경 연구 기록은 labs/claude-mods/에 있습니다.

모든 스폰(spawn)은 모델 이름을 지정하고 모든 팬아웃(fan-out)은 그 한계를 선언하며, 가드들이 이를 강제합니다. 계약: core/rules/modules/delegation-and-model-routing.md

.

의존성 없는 Node 및 PowerShell로 구성되며, 각각 자체 디렉터리에 README 또는 자신이 무엇을 하는지 설명하는 헤더가 있습니다.