정의

Domain Knowledge as Agent Infrastructure는 팀 구성원의 머릿속에 있는 프레임워크 선택, 아키텍처 규칙, 리뷰 기준, 반복 실수, onboarding 지식을 CLAUDE.md, REVIEW.md, skills, docs, comments, memories, CI, lint rules 같은 실행 가능한 인프라로 전환하는 방식이다.

AI agent 시대에는 도메인 지식이 문서에만 머물면 병목이 된다. Agent가 codebase에 들어와 일하려면 매번 prompter가 맥락을 설명하는 것이 아니라, repository 자체가 agent에게 필요한 규칙과 판단 기준을 제공해야 한다.

핵심 속성

  • 머릿속 지식의 외부화: “이 팀에서는 이렇게 한다”는 암묵지를 파일과 자동화로 바꾼다.
  • agent-ready onboarding: 새 engineer, designer, non-engineer contributor, agent가 zero additional context로 작업할 수 있게 만든다.
  • one-off fix의 제거: agent가 같은 문제를 볼 때마다 고치는 대신 lint rule, CI step, routine, skill로 class-level 해결을 만든다.
  • review 자동화: framework 선택, architecture pattern, style violation 같은 반복 리뷰 코멘트를 사전에 잡는다.
  • token efficiency: 반복 설명과 반복 수정에 쓰는 token을 durable rule과 automation으로 전환한다.

적용 예시

  • Code review에서 반복되는 지적을 REVIEW.md와 verifier check로 옮긴다.
  • Agent가 자주 놓치는 architectural pattern을 CLAUDE.md에 명시한다.
  • 반복 버그는 agent prompt가 아니라 lint rule이나 test로 고정한다.
  • 팀 내부 도메인 용어와 product constraints를 skill 또는 docs로 만든다.

연결

출처

클리핑 · X/Twitter