agentleFS
uzysjunguzysjung/uzys-agent-harness/.claude/CLAUDE.md

uzys-agent-harness

CLAUDE.md3 starsChanged 9 days agoMITView on GitHub

전역 ~/.claude/CLAUDE.md 의 *6원칙이 기준선*이다 — 여기 복제하지 않는다(같은 사실을 두 곳에 두면 한쪽이 썩는다). 이 파일은 그 위에 얹는 *이 리포 고유분*만 담는다. 6원칙 중 *원칙 4 의 위임 리뷰*를 이 리포의 레인 구성으로 구체화한다 — 누가 만들고 누가 판정하는가. 설계는 무엇이 완료인지 정하고, 착수 전에 *작성자가 아닌 레인*이 그 기획서·SPEC·계획을 읽는다. 완료 기준을 실행 가능한 형태로 만든 테스트는 누가 쓰든 리뷰어가 검증한다 (사용자 확정 2026-07-26 — 작성 분리는 기각, 분리 요구는 리뷰에 건다). *구현*은 원칙 6 대로 시간·…

The file

Files
CLAUDE.md

Uzys-agent-harness

전역 ~/.claude/CLAUDE.md 의 6원칙이 기준선이다 — 여기 복제하지 않는다(같은 사실을 두 곳에 두면 한쪽이 썩는다). 이 파일은 그 위에 얹는 이 리포 고유분만 담는다.

대원칙 — 만든 레인은 자기 산출물을 판정하지 않는다

6원칙 중 원칙 4 의 위임 리뷰를 이 리포의 레인 구성으로 구체화한다 — 누가 만들고 누가 판정하는가. 설계는 무엇이 완료인지 정하고, 착수 전에 작성자가 아닌 레인이 그 기획서·SPEC·계획을 읽는다. 완료 기준을 실행 가능한 형태로 만든 테스트는 누가 쓰든 리뷰어가 검증한다 (사용자 확정 2026-07-26 — 작성 분리는 기각, 분리 요구는 리뷰에 건다). 구현은 원칙 6 대로 시간· 품질 이득이 조정 비용을 넘을 때 implementer 에이전트에 위임하고(없으면 범용 서브에이전트에 같은 계약으로), 위임하지 않은 구현도 머지 전 독립 검증이 걸리는 변경이면(문턱 = test-policy §시점별 검증) 검증 레인은 가른다. 검증은 코드를 쓰지 않은 레인이 구현 보고를 읽는 대신 직접 다시 돌려 증거를 얻는다. 구현 중 드러난 경계 때문에 구현자가 테스트를 추가할 때는 검증 레인이 음성 대조로 그것이 무는지 증명한다 — 초록불이 무는지부터 확인한다(원칙 5 가 소유 · 구 룰 정리 = ADR-060).

판정이 갈리거나 확신이 없을 때는 틀렸을 때의 비용으로 가른다. change-management 의 Major CR(AC 의 Pass/Fail · 다른 Phase 의 입출력 · Non-Goals 경계 · DO NOT CHANGE) · 보안 경계 · 공유 상태를 건드리는 결정이면 독립 리뷰어들의 적대적 다면 리뷰로 결론을 낸다. 그 밖에는 증거가 더 좋은 쪽을 골라 넘어간다 — 사소한 것에 패널을 돌리면 비용이 판단의 가치를 넘는다. ("npm 게시 여부"는 이 리포에서 상수라 판별자로 쓰지 않는다 — 산출물이 전량 배송 계약이다.)

이 원칙을 세운 사고 기록 6건 = ADR-054 Context 표.

수정이 실패하면 — 경우를 덧대지 않는다

같은 가정 위에서 세운 수정이 두 번 실패하면 세 번째를 붙이기 전에 그 가정부터 시험한다. 오류는 드러난 곳이 아니라 처음 생긴 곳에서 고치고, 가드는 그것이 다루는 상태가 정당하게 생길 수 있을 때만 수정이다. 배포 앵커 §5 와 같은 결정이다(ADR-120 — 이 리포가 겪은 회차 소모가 근거).

입력이 없으면 — 지어내지 않는다

작업이 기대는 입력(데이터 · 파일 · 자격 증명 등)이 없으면 무엇이 없고 무엇이 막히는지 보고한다. 진짜처럼 보일 대체 결과를 만들지 않는다. 배포 앵커 §1 과 같은 결정이다(ADR-121 — #513 확인 실행이 근거).

의사결정 및 컨펌 요청 시

형식은 user-centered-explanation 스킬의 기본 표(맥락 · 문제점 · 해결방안 · 추천방안, 각각 이유와 함께)가 SSOT 다(사용자 확정 2026-09-15, #465) — 이 리포 번들이라 templates/skills/user-centered-explanation/ 에서 바로 읽는다(ADR-062. 설치·네트워크 불요).

ASIS→TOBE 를 덧붙일 때는 "그 결과를 안고 사는 사람" 자리에서 쓴다(사용자 확정 2026-08-16) — 영향받는 역할(설치받는 사용자 / 운영자 / 리뷰어 / 다음 유지보수자)을 지목해 전에는 못 하던 무엇을 할 수 있게 되는가 또는 무엇이 더는 안 일어나는가로 적고, 표의 항목이 installer.ts 로 시작하면 그 자체가 다시 쓰라는 신호다.

Phase/작업 완료 시

  • Non-Goals 침범 없음 확인 — 6원칙이 안 덮는 축이라 남긴다(원칙 5 는 미검증 보고를 덮지만 범위 침범은 다른 축이고, SPEC 에 Non-Goals 절이 실재한다 — ADR-055 Consequences ⓐ).

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.