Imported from dhddldid/Agent-setup (
AGENTS.md). Install upstream withnpx skills add dhddldid/Agent-setup. Copyright stays with the author.
Agent-setup
이 저장소는 Codex·Claude Code·Hermes 설치 원본을 실행기별 폴더로 관리한다.
- 작업 전에 README.md와 docs/comparison.md를 읽고, 대상 실행기 폴더의 지침을 따른다.
- 실행기별 원본은 codex/, claude/, hermes/에 있다. 모델·추론·위임·fallback·스킬 발견·설치 방식은 각 폴더에서 관리한다.
- 외부 구성요소(Hermes, OMH, 플러그인, 가져온 스킬 사본)는 각 원본의 최신 정식 릴리스 태그를 기준으로 고정한다. main 브랜치·preview·canary 빌드는 기준으로 쓰지 않는다. 새 정식 릴리스가 나오면
python3 scripts/check_releases.py로 확인하고 고정값·사본·문서를 함께 올린다. - Hermes 본체와 provider-usage 플러그인은 최신 정식 릴리스 위에 이 사용자의 수정 묶음(
hermes/patches/<대상>/<태그>.patch)을 적용해 쓴다. 정식판을 올리면python3 hermes/scripts/apply_local_patches.py로 적용 상태를 확인하고, 새 태그용 패치가 없거나 충돌하면 수정을 새 버전에 옮긴 뒤 그 태그 이름으로 패치를 저장한다. - 현재 실행 중인 에이전트는 자기 실행기의 모델 정책을 쓴다. Hermes 안에서 쓰는 Codex 제공자는 Hermes 정책을 따르고, 외부로 실행한 Codex·Claude Code 프로세스는 각자의 정책을 따른다.
- 설치·업데이트는 요청한 실행기와 프로필에 적용한다. 계정·인증·대화·메모리·브라우저 데이터·DB·로그는 Git 저장소에 넣지 않는다.
- 세 실행기의 전역 지침은
shared/rules/가 원본이다. 고친 뒤python3 scripts/build_rules.py로 codex/instructions/AGENTS.md, claude/templates/global-rules.md, hermes/templates/common-rules.md를 만든다. 공통 스킬 원본은shared/skills/다. Hermes의 Aside·문서 전달 규칙 원본은 hermes/templates/다. - Claude Code는 각 폴더의 CLAUDE.md(
@AGENTS.md한 줄)로 AGENTS.md를 읽는다. 작업 규칙은 AGENTS.md에만 쓴다. - 검사는 Python 3.12 이상에서
python3 scripts/check.py와python3 -m unittest discover -s tests -v로 실행한다.python3가 3.12 미만이면 Homebrew의python3.13이나uv run --no-project --python 3.13 python으로 실행한다. - 현재 지식은 docs/, 보고용 Markdown은 reports/, 상세 검증 결과는 project-records/에 둔다.
- 커밋·원격 생성·push·외부 게시는 사용자가 요청한 범위에서 실행한다.
문서와 응답의 표현
- 문서·지침·사용자 응답은 목적, 실제 동작, 적용 대상을 직접 설명한다.
~가 아니다,~이 아니라,~을 뜻하지 않는다같은 부정·대조 표현은 쓰지 않는다. - 규칙에는 적용 대상, 조건, 수행할 행동을 구체적으로 쓴다.
- 요청하지 않은 상황이나 근거 없는 오해를 가정한 방어·면책 문구를 덧붙이지 않는다. 같은 뜻의 설명은 하나로 합친다.
