🪴 Soo.Y

하네스 엔지니어링

4 min read

Created at : 2026-03-28 21:13
Auther: Soo.Y

📝메모

Context Meangment

  • Context 관리 : 작업(Task)은 매번 달라짐 → 최적의 Best Context 구성이 필수적

  • Context : Claude Code의 중요 참조 지식

  • Context의 “질적 우수함”이 곧 성공 코딩에 “결정적” 하지만 context는 제한적임

  • Oh-my-opencode : 23명 축구선수에서 11명을 선출해야 함

컨텍스트 최적화가 필요한 이유

  • LL : 최대한 256K 안쪽으로 사용하도록 하자
  • Opus 4.6 기준
    • 256k → 정확도 93%
    • 1M → 정확도 76%
    • 무조건 컨텍스트가 길게 사용하면 안됨 → 정확도 하락 원인

Context의 구성은 매번 달라져야 하나?

  • 공통으로 지켜야 할 RULE은 존재(=변하지 않는 RULE은 고정으로 Load)

결국 “고정된 지식”을 줄여야 함(단 내가 필요한 지식은 포함하면서)

고정된 지식

  • System Pompt(3k tokens)
  • System Tools(~11k tokens)
    • Bash, 파일 편집, 검색 등 Claude code가 기본적으로 제공
  • Memory Files(CLAUDE.md 계층 구조)
    • ~/.claude/CLAUDE.md : 전역(모든 프로젝트) / 개인 선호 설정
    • ./CLAUDE.md : 프로젝트 루트 / Git으로 팀 공유
    • ./CLAUDE.local.md : 프로젝트(개인) / .gitignore 처리 권장
    • 부모 디렉토리 CLAUDE.md : 상위 경로 전체 / 계층적으로 모두 로딩

/init : init를 하게 되면 CLAUDE.md를 재작성하게 된다.

  • Skill 만들기 : CLAUDE.md 만들어주고 → 반영할 것이 있으면 구조화된 CLAUDE.md를 재구성

.claude/rules/*.md : 조건부 로딩

  • backend
  • frontend
  • db
  • design
  • git
  • infra
  • langchain
  • security
  • testing
  • tools

Auto Memory(~/.claude/projects/…/MEMORY.md)

  • 200줄 제한
  • Why? → 명시적으로 클로드가 실수한 것들을 claude.md에 반영을 안한다. memory.md는 자동으로 클로드가 기록하는 메커니즘이다.
  • 전역변수 메모리
  • 프로젝트 메모리
claude.md = 전부서 공지사항  
rules = 각 부서 공지사항  
memory = 사고사례전파

그럼 저 세개가 충돌 나면 memory가 가장 우선순위로 동작하나요?

----> 일단 프롬프트가 오염되었다.

ADR : Architecture Decision Records

Custom Agent .claude/agents/...

Memory

  • Auto Memory 활성화
  • /memory를 열고 Auto-memory on 설정
  • 200줄 제한 ⇐- Root에 있는 Memory.md 파일
  • 자동으로 저장하거나 memory.md 문설르 수정가능(OpenClaw의 SOUL.md 역할)

Subagnet Memory - Agent-memory(신규)

  • Subagent 정의 파일에 memory 필드를 설정하면, scope에 따라 세 가지 위치 중 하나에 persistent 디렉토리가 생성
  • frontmatter에 memory 설정

Plan 파일을 Review

headless 모드

brainstorming skill(superpowers) Interview skill 만들기

  • AskUserQuestion 도구를 활용해서 나에게 질문 10개 물어봐줘

Skill vs Agents

📜출처(참고 문헌)

🔗연결 문서

Graph View