gahusb/maplecontest
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore(harness): 토큰 가드 하네스 — 산출물 접근 차단·RULES.md 공유 규칙 #43

Merged
gahusb merged 1 commits from chore/harness-rules into main 2026-06-12 11:01:45 +09:00
Conversation 0 Commits 1 Files Changed 4 +89 -2
gahusb commented 2026-06-12 11:01:39 +09:00
Owner
Copy Link

요약

AI 에이전트 작업 시 ui/DefaultGroup.ui(8.3MB) 등 생성 산출물을 불필요하게 읽어 토큰이 소모되는 문제의 하네스 엔지니어링.

.claude/settings.json (커밋 — 팀 공유)

  • 생성 산출물 3종(ui/DefaultGroup.ui·map/*.map·SlayDeckController.codeblock)에 대해 Claude Code의 Read/Edit/Write 도구를 권한 수준에서 차단
  • 저장소를 열면 자동 적용 — 협업자도 동일 가드
  • 산출물 직접 수정 방지 효과 겸용 (단일 소스 = data/*.json + tools/)

RULES.md (사람·AI 공용 규칙)

  1. 생성 산출물 Read/Edit 금지 + 단일 소스/재생성 명령 표
  2. 산출물 검증은 grep -c 등 카운트만 (codeblock은 한 줄 수만 자 — 내용 출력 시 토큰 폭발)
  3. 탐색은 tools/·data/·docs/ 경로 한정
  4. PR은 tools/git/gitea-pr.mjs (한글 인코딩 사고 방지)
  5. 메이커 reload·공식 RUID 규칙
  6. Lua↔JS 이중 구현 동기화 표

CLAUDE.md

  • @RULES.md 임포트 — Claude Code 세션 시작 시 자동 로드

검증

  • settings.json 스키마 유효, .gitignore에서 settings.json만 커밋 예외 처리 확인
  • deny 규칙은 세션 재시작 시 활성화 (신규 .claude/ 디렉토리는 기존 세션 워처 밖 — 새 세션부터 적용)

🤖 Generated with Claude Code

## 요약 AI 에이전트 작업 시 `ui/DefaultGroup.ui`(8.3MB) 등 생성 산출물을 불필요하게 읽어 토큰이 소모되는 문제의 하네스 엔지니어링. ### `.claude/settings.json` (커밋 — 팀 공유) - 생성 산출물 3종(`ui/DefaultGroup.ui`·`map/*.map`·`SlayDeckController.codeblock`)에 대해 Claude Code의 **Read/Edit/Write 도구를 권한 수준에서 차단** - 저장소를 열면 자동 적용 — 협업자도 동일 가드 - 산출물 직접 수정 방지 효과 겸용 (단일 소스 = `data/*.json` + `tools/`) ### `RULES.md` (사람·AI 공용 규칙) 1. 생성 산출물 Read/Edit 금지 + 단일 소스/재생성 명령 표 2. 산출물 검증은 `grep -c` 등 **카운트만** (codeblock은 한 줄 수만 자 — 내용 출력 시 토큰 폭발) 3. 탐색은 `tools/`·`data/`·`docs/` 경로 한정 4. PR은 `tools/git/gitea-pr.mjs` (한글 인코딩 사고 방지) 5. 메이커 reload·공식 RUID 규칙 6. Lua↔JS 이중 구현 동기화 표 ### `CLAUDE.md` - `@RULES.md` 임포트 — Claude Code 세션 시작 시 자동 로드 ### 검증 - settings.json 스키마 유효, `.gitignore`에서 settings.json만 커밋 예외 처리 확인 - deny 규칙은 세션 재시작 시 활성화 (신규 `.claude/` 디렉토리는 기존 세션 워처 밖 — 새 세션부터 적용) 🤖 Generated with [Claude Code](https://claude.com/claude-code)
gahusb added 1 commit 2026-06-12 11:01:40 +09:00
chore(harness): 토큰 가드 하네스 — 산출물 접근 차단·RULES.md·CLAUDE.md 65ad2fe854 
- .claude/settings.json: ui/DefaultGroup.ui(8.3MB)·map/*.map·SlayDeckController.codeblock
  Read/Edit/Write 도구 차단 (생성 산출물 — 단일 소스는 data/*.json + tools/)
- RULES.md: 협업 공용 하네스 규칙 (카운트 검증·탐색 경로 제한·gitea-pr 절차·이중 구현 동기화)
- CLAUDE.md: RULES.md 임포트로 Claude Code 자동 적용
- .gitignore: .claude/settings.json만 커밋 예외 (local 설정은 계속 제외)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
gahusb merged commit 2a0ec0ef21 into main 2026-06-12 11:01:45 +09:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
No items
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
maple gahusb
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: gahusb/maplecontest#43
Delete Branch "chore/harness-rules"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?