carve-harness
AGENTS.md16 starsChanged 2 months agoMITView on GitHub
이 파일은 모든 코딩 에이전트(Claude Code·Cursor·Codex·Aider·Gemini CLI 등)에 적용되는 공통 규칙이다. Claude Code는 CLAUDE.md + .claude/CLAUDE.md + PreToolUse 훅으로 이 규칙 일부를 *자동 강제*하지만, 훅이 없는 에이전트는 아래 규칙을 *스스로 준수*해야 한다. 규칙의 권위는 강제 수단이 아니라 이 문서에 있다. 스택별 세부 규칙은 .claude/rules/에 있다 — 해당 파일도 함께 읽어라. 사용자 신호를 정확히 해석하라. 불필요하게 되묻지 마라. 다음은 자율 판단 금지 → 진행 전 에스컬레이션: - 아키텍처 변경 · 반복 실패 · 스펙 충돌 · 비가역 작업(덮어쓰기·삭제·퍼블리시). - 정본 소스가…
In this repository12 other files it gives its agents.
- .claude/CLAUDE.mdCLAUDE.md
- CLAUDE.mdCLAUDE.md
- anti-ai-slopSkill
- carve-guideSkill
- carve-harness-createSkill
- changelogSkill
- checklist-loopSkill
- eval-goldensetSkill
- eval-initSkill
- handoffSkill
- theme-factorySkill
- version-changelogSkill
The file
Files
AGENTS.md — 에이전트 표준 (크로스 에이전트 가드레일)
이 파일은 모든 코딩 에이전트(Claude Code·Cursor·Codex·Aider·Gemini CLI 등)에 적용되는 공통 규칙이다. Claude Code는
CLAUDE.md+.claude/CLAUDE.md+ PreToolUse 훅으로 이 규칙 일부를 자동 강제하지만, 훅이 없는 에이전트는 아래 규칙을 스스로 준수해야 한다. 규칙의 권위는 강제 수단이 아니라 이 문서에 있다. 스택별 세부 규칙은.claude/rules/에 있다 — 해당 파일도 함께 읽어라.
0. 절대 금지 (언어·에이전트 무관, 강제)
- 시크릿 하드코딩 금지 → 환경변수/시크릿 매니저. 코드·커밋·로그·에러메시지·URL에 시크릿/PII 노출 금지.
- 위험 git 금지:
push --force,reset --hard, 히스토리 재작성,commit --no-verify. - 기존 마이그레이션 수정 금지 → 새 버전만 추가(체크섬/이력 보존).
- 파괴적 DB 작업 금지:
WHERE없는DELETE/UPDATE,DROP/TRUNCATE, 볼륨 삭제 — 승인 없이 금지. - 미검증 완료 선언 금지 → 완료는 검증 가능한 완료기준(SC)으로만 증명한다.
eval/new Function/exec에 외부 입력 전달 금지, 미검증 HTML 렌더 금지(XSS).
1. 커뮤니케이션 · 에스컬레이션
사용자 신호를 정확히 해석하라. 불필요하게 되묻지 마라.
- 오타는 맥락으로 해석하고 되묻지 않는다.
- 사소한 분기(파일명·포맷 등)는 기본값으로 진행하고 1줄 고지한다.
- 같은 지적을 두 번 받으면 즉시 규칙으로 정착시킨다. 세 번째는 없다.
- 해석이 여럿이면 모두 제시하라 — 말없이 하나 고르지 마라.
다음은 자율 판단 금지 → 진행 전 에스컬레이션:
- 아키텍처 변경 · 반복 실패 · 스펙 충돌 · 비가역 작업(덮어쓰기·삭제·퍼블리시).
- 정본 소스가 불명확하거나 요구 범위가 서로 충돌할 때.
- 작업 결과가 기존 산출물을 퇴행시킬 것으로 예상될 때.
- 입력이 비어 있거나 대상이 실재하지 않을 때 → 멈추고 먼저 보고(빈 데이터 분석한 척 금지).
에스컬레이션 포맷:
[ESCALATION]
- 상황: / 막힌 지점: / 시도한 것: / 필요한 결정:4. 외과적 변경
꼭 필요한 것만 건드려라. 네가 만든 것만 정리하라.
- 인접 코드·주석·포맷을 "개선"하지 마라. 안 망가진 것 리팩터 금지.
- 네 방식과 달라도 기존 스타일을 따르라.
- 무관한 죽은 코드는 언급만, 삭제 금지(요청받지 않는 한).
- 변경으로 고아가 된 import/변수/함수만 정리하라.
- 지정 범위 밖 파일·섹션은 읽되 쓰지 마라. "다른 건 건들지 말고"가 항상 암묵적으로 붙어 있다고 가정.
- 덮어쓰기 전 현재 상태를 읽어라 — 기존 삭제 내역 되살아남 방지. 부분 패치로 될 걸 전체 덮어쓰지 마라.
- 이전 버전보다 나빠졌으면 변명 없이 즉시 롤백.
- 판별 기준: 변경된 모든 줄은 사용자 요청으로 거슬러 올라갈 수 있어야 한다.
6. 역할 (생성/검증 분리)
- 생성(Generator)과 검증(Evaluator)은 분리한다 (Self-Eval Blindspot 방지).
- Planner: 작업 분해·SC 정의 / Generator: 구현 / Evaluator: 타입·보안·예외·상태 검증.
- 출력은 SC 대비 자기 점검 후 제출.
7. 시각 산출물 게이트
- 금지: 그라데이션 일체, 색 그림자,
blur>=20px, 글래스모피즘, hover/load 장식, 무관한 배경 장식, 카드 상단 컬러바, 한쪽 테두리 radius, 이모지 불릿, 뱃지/pill 남발, 마케팅 상투어. - 강제: 무채색 베이스 + 액센트 1색(색은 의미에만), 그림자는 중성 회색 1단계 또는 없음,
border-radius0~8px, 폰트 의도적 선택, 흰 배경엔 진한 텍스트. - 시각 작업 전 설치된 UI 스킬/린터를 먼저 발동하고, 자동 검사기가 있으면 통과할 때까지 재작성.
8. Git 워크플로
main직접 푸시 금지. feature/develop 브랜치 → PR → 사용자가 머지.- 커밋 메시지: Conventional Commits 영어(
feat:·fix:·refactor:…), 제목 50자 이하. - 커밋·푸시·PR은 명시 요청 시에만 실행.
- 버그는 증상 패치 말고 공통 경로의 근본 원인 한 곳을 고쳐라.
- 비자명 변경: 계획 제시 → 승인 → 구현. 단계별 완료 확인 후 다음 단계.
9. 스택 감지 · 도메인 규칙
**/*.java→.claude/rules/java-spring/·**/*.ts,tsx→.claude/rules/react-next/·**/*.py→.claude/rules/python/·**/*.go→.claude/rules/go/·**/*.rs→.claude/rules/rust/(설치된 언어팩만 존재) · 공통 →.claude/rules/common/· 스택 표준 상세본 →docs/rules/code-convention/(자동 로드 아님 — 필요 시 해당 스택 파일만 읽어라). 스택별 검증 게이트·포맷·채점 어댑터는.claude/stacks/<pack>.sh한 파일이 정의한다.- 프로젝트 도메인 불변식·금지사항은
CLAUDE.md에 추가한다(예: "주문 금액 음수 불가", "결제 승인 없이 배송상태 변경 금지"). 다른 에이전트는 그 규칙도 준수.
10. 언어
| 대상 | 언어 |
| 내부 추론·계획 | English |
| 코드·변수명·주석·로그·에러메시지 | English |
| Git 커밋 메시지 | English (Conventional Commits) |
| 사용자 응답·설명·요약·질문 | 한국어 |
| 에러 보고 | 한국어 설명 + 원문 에러는 English |
이 AGENTS.md가 규칙 정본이다. CLAUDE.md(루트)는 진입점 — 하네스 3기둥·절대 금지 요약·응답 언어 프로토콜·도메인 규칙만 담는다. .claude/CLAUDE.md는 Claude Code 고유 지침만 담는다. 규칙 수정은 여기서 하고, 두 파일에는 중복 조항을 만들지 마라.
</content>
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
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.

