altair823-org/kebab
0
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 45 Wiki Activity

docs(claude): 머신 용량/성능 + stale /build 경로를 전역·메모리로 이전 #210

Merged
altair823 merged 1 commits from docs/claude-md-machine-cleanup into main 2026-06-24 05:44:33 +00:00
Conversation 0 Commits 1 Files Changed 1 +11 -11
altair823 commented 2026-06-24 01:44:57 +00:00
Owner
Copy Link

요약

repo CLAUDE.md 에 섞여 있던 머신-specific 내용을 머신-레벨 global ~/.claude/CLAUDE.md(codex/gemini 심링크) + 프로젝트 메모리로 이전하고, repo 에는 프로젝트-specific 정책만 남긴다. 동기: 머신 용량/성능 수치와 stale 경로가 repo 의 agent-guidance 계약을 오염시키고 있었음(특히 /build/dogfood 는 이 머신에 존재조차 안 하는 가공 경로였다).

변경

  • 머신 용량/성능 → global 로 이전: target/ balloon GB 수치, "disk space is tight", cargo clean 루틴, -j1 의 RAM 고갈 사유 → global ~/.claude/CLAUDE.md 의 신규 "빌드 산출물·스크래치 데이터 정리" 절에 프로젝트-무관 일반 규칙으로. repo 에는 프로젝트 사실(무거운 dep 링크→-j1, dev/test 프로파일 트림, 머지 후 cargo clean)만 남기고 머신 제약은 global 포인터로 위임.
  • stale /build/dogfood/ 데이터 보관소 섹션 제거: /build 는 이 머신에 미존재. 실제 store(large_data/out/kebab-dogfood, kebab-ab)는 머신-로컬이라 global §디스크 + 프로젝트 메모리(dogfood-data-store-location)로 이전. repo 에는 경로-무관 분류 정책(corpus/<format>/<category> 등)만 유지. 옛 username 경로(/home/altair823/KnowledgeBase) 등 stale forbidden 목록 삭제.
  • crate 수 정정: "~21"/"18 crates" → 실제 24.

비범위

  • 코드 변경 없음(문서만). 빌드/테스트 불변.
  • global ~/.claude/CLAUDE.md 와 프로젝트 메모리는 repo 밖 머신-로컬 파일이라 이 PR 에 미포함(이미 반영됨).

검증

  • repo CLAUDE.md 에 stale 마커(/build, altair823/KnowledgeBase, GB 수치, "18 crates", "exhausts memory") 0건 — grep 확인.
  • global 신규 절은 프로젝트-무관(kebab 미언급) — grep kebab = 0.
  • 도그푸딩 trigger/결과기록 등 프로젝트 정책 섹션은 보존.
## 요약 repo `CLAUDE.md` 에 섞여 있던 머신-specific 내용을 머신-레벨 global `~/.claude/CLAUDE.md`(codex/gemini 심링크) + 프로젝트 메모리로 이전하고, repo 에는 프로젝트-specific 정책만 남긴다. 동기: 머신 용량/성능 수치와 stale 경로가 repo 의 agent-guidance 계약을 오염시키고 있었음(특히 `/build/dogfood` 는 이 머신에 존재조차 안 하는 가공 경로였다). ## 변경 - **머신 용량/성능 → global 로 이전**: `target/` balloon GB 수치, "disk space is tight", cargo clean 루틴, `-j1` 의 RAM 고갈 사유 → global `~/.claude/CLAUDE.md` 의 신규 "빌드 산출물·스크래치 데이터 정리" 절에 프로젝트-무관 일반 규칙으로. repo 에는 프로젝트 사실(무거운 dep 링크→`-j1`, dev/test 프로파일 트림, 머지 후 cargo clean)만 남기고 머신 제약은 global 포인터로 위임. - **stale `/build/dogfood/` 데이터 보관소 섹션 제거**: `/build` 는 이 머신에 미존재. 실제 store(`large_data/out/kebab-dogfood`, `kebab-ab`)는 머신-로컬이라 global §디스크 + 프로젝트 메모리(`dogfood-data-store-location`)로 이전. repo 에는 경로-무관 분류 정책(`corpus/<format>/<category>` 등)만 유지. 옛 username 경로(`/home/altair823/KnowledgeBase`) 등 stale forbidden 목록 삭제. - **crate 수 정정**: "~21"/"18 crates" → 실제 24. ## 비범위 - 코드 변경 없음(문서만). 빌드/테스트 불변. - global `~/.claude/CLAUDE.md` 와 프로젝트 메모리는 repo 밖 머신-로컬 파일이라 이 PR 에 미포함(이미 반영됨). ## 검증 - repo `CLAUDE.md` 에 stale 마커(`/build`, `altair823/KnowledgeBase`, GB 수치, "18 crates", "exhausts memory") 0건 — grep 확인. - global 신규 절은 프로젝트-무관(kebab 미언급) — grep `kebab` = 0. - 도그푸딩 trigger/결과기록 등 프로젝트 정책 섹션은 보존.
altair823 added 1 commit 2026-06-24 01:44:58 +00:00
docs(claude): 머신 용량/성능 + stale /build 경로를 전역·프로젝트 메모리로 이전 b453881086 
repo CLAUDE.md 에 섞여 있던 머신-specific 내용을 정리:

- 머신 용량/성능(target balloon GB 수치, "disk space is tight", cargo clean
  루틴, `-j1` 의 RAM 고갈 사유)을 머신-레벨 global `~/.claude/CLAUDE.md`
  (codex/gemini 심링크)로 일반 규칙화해 이전. repo 에는 프로젝트-specific
  사실(무거운 dep 링크 → `-j1`, dev/test 프로파일 트림, 머지 후 cargo clean)만
  남기고 머신 제약은 global 포인터로 위임.
- stale `/build/dogfood/` 데이터 보관소 섹션 제거 — 이 머신에 `/build` 는
  존재하지 않았다(가공 경로). 실제 도그푸딩 store(`large_data/out/kebab-dogfood`,
  `kebab-ab`)는 머신-로컬이라 global §디스크 + 프로젝트 메모리로 이전하고,
  repo 에는 경로-무관 분류 정책(corpus/<format>/<category> 등)만 유지. 옛
  username 경로(`/home/altair823/KnowledgeBase`) 등 stale forbidden 목록 삭제.
- crate 수 표기 정정: "~21"/"18 crates" → 실제 24.

repo CLAUDE.md 는 이제 머신 경로/용량 수치를 하드코딩하지 않는다(전부 global +
프로젝트 메모리 참조). global 은 프로젝트-무관 유지(kebab 미언급).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012Mc6W1fgsrbFKTsqA6P8La
altair823 merged commit 22478a1126 into main 2026-06-24 05:44:33 +00:00
altair823 deleted branch docs/claude-md-machine-cleanup 2026-06-24 05:44:34 +00: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
altair823 claude-reviewer-01
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: altair823-org/kebab#210
Delete Branch "docs/claude-md-machine-cleanup"

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?