MACCHA: Claude Code가 기억하게 만드는 파일 기반의 교차 에이전트 브레인

MACCHA는 파일 기반의 7계층 메모리 시스템을 통해 Claude Code의 콜드 스타트 (cold-start) 문제를 해결합니다. 데몬 (daemon) 없이도 세션 전반에 걸쳐 선호도, 프로젝트 규칙 및 학습 내용을 유지하는 데 사용하세요.

핵심 요약 (Key Takeaways)

The .claude Folder: A 10-Minute Setup That Makes AI Code Smarter | by ...

MACCHA는 파일 기반의 7계층 메모리 시스템을 통해 Claude Code의 콜드 스타트 (cold-start) 문제를 해결합니다.
데몬 (daemon) 없이도 세션 전반에 걸쳐 선호도, 프로젝트 규칙 및 학습 내용을 유지하는 데 사용하세요.

변경 사항: 데몬 없는 교차 에이전트 지속성 메모리

모든 Claude Code 세션은 제로 상태에서 시작됩니다. 터미널을 열고 claude를 실행하면, 이 에이전트는 당신이 npm보다 pnpm을 선호하는지, Tailwind를 싫어하는지, 혹은 어제 WebSocket 핸들러의 레이스 컨디션 (race condition)을 디버깅하는 데 3시간을 보냈는지 전혀 알지 못합니다. 당신은 다시 설명하고, 다시 프롬프트를 입력하고, 다시 가르쳐야 합니다.

MACCHA (Multi Agent Continuous Context Harness)는 Claude Code — 그리고 Antigravity, OpenCode 및 기타 모든 로컬 AI 에이전트 — 에게 파일 시스템에 존재하는 공유된 지속성 "브레인 (brain)"을 제공함으로써 이 문제를 제거합니다. 클라우드도, 데몬 (daemon)도, 24/7 서버도 필요 없습니다. 그저 어떤 에이전트든 읽고 쓸 수 있는 구조화된 마크다운 (markdown) 파일만 있으면 됩니다.

아키텍처는 간단합니다: 7계층 컨텍스트 계층 구조를 가진 ~/.maccha/ 디렉토리입니다:

core/: 당신의 정체성, 선호도 및 타협 불가능한 규칙 (예: "항상 pnpm을 사용하고, npm은 절대 사용하지 말 것")
projects/: 아키텍처 결정 및 제약 사항을 포함한 프로젝트별 컨텍스트
sessions/: 주요 결정 및 결과가 포함된 최근 세션 로그
knowledge/: 도메인 특화 지식, API 문서 및 당신이 학습한 패턴
tasks/: 상태 및 의존성이 포함된 현재 및 대기 중인 작업
memory/: 벡터 임베딩 (vector embeddings), 신뢰도 감쇠 (confidence decay) 및 의미론적 충돌 탐지 (Memanto를 통해 수행)를 포함한 작업 메모리 (working memory)
archive/: 참조를 위한 압축된 과거 컨텍스트

Claude Code가 시작될 때, MACCHA의 init 스크립트는 이 계층 구조에서 가장 관련성이 높은 파일들로 에이전트의 컨텍스트 (context)를 채웁니다. 세션이 종료되면, save 스크립트가 주요 결정 사항, 선호도, 그리고 학습된 교훈들을 추출하여 신뢰도 점수 (confidence scores)와 함께 메모리를 업데이트합니다.

사용자에게 주는 의미: 더 이상의 콜드 스타트 (Cold Starts) 없음

Claude Code를 일주일 이상 사용해 보셨다면, 자신의 선호도를 다시 가르쳐야 하는 좌절감을 경험해 보셨을 것입니다. MACCHA는 이를 단 한 번의 설정으로 만들어 줍니다.

일일 워크플로 (workflow)에 미치는 구체적인 영향:

재설명 필요 없음: 오늘 하루의 첫 번째 프롬프트 (prompt)가 어제 마지막 프롬프트만큼이나 효과적입니다. Claude Code는 이미 당신의 기술 스택 (tech stack), 코딩 스타일, 그리고 현재 작업을 알고 있습니다.
프로젝트 간 일관성: 한 프로젝트에서 선호도(예: "pnpm 사용")를 설정하면 모든 곳에 적용됩니다. 또한 MACCHA의 프로젝트별 컨텍스트 (context) 덕분에 React 프론트엔드와 Go 백엔드에 대해 서로 다른 규칙을 가질 수도 있습니다.
멀티 에이전트 이식성 (Multi-agent portability): Antigravity에서 복잡한 리팩토링 (refactor)을 시작하고, Claude Code에서 이를 이어갈 수 있습니다. 두 에이전트 모두 동일한 MACCHA 브레인 (brain)을 읽고 씁니다.
백그라운드 오버헤드 없음: Hermes Agent나 OpenClaw와 달리, MACCHA는 데몬 (daemon)을 실행하지 않습니다. 그저 파일일 뿐입니다. 에이전트는 시작할 때 파일을 읽고, 종료할 때 파일을 씁니다. 코딩을 하지 않을 때는 CPU 사용량이 제로입니다.
충돌 인지 메모리: MACCHA의 Memanto 엔진은 의미론적 충돌 (semantic conflicts)을 감지합니다. 만약 오래된 메모리에는 "v1 엔드포인트 사용"이라고 되어 있는데 현재 코드베이스 (codebase)가 v2를 사용하고 있다면, 오래된 컨텍스트를 조용히 적용하는 대신 충돌을 알립니다.

지금 바로 시도해 보세요: Claude Code를 위한 MACCHA 설정

# 리포지토리 (repository) 클론
git clone https://github.com/KarelTestSpecial/real-agent-setup.git ~/.maccha

...

당신의 첫 번째 MACCHA 세션:

평소처럼 claude를 실행합니다. MACCHA의 초기화 스크립트가 당신의 핵심 정체성(core identity), 현재 작업, 그리고 관련 프로젝트 컨텍스트(context)를 프롬프트에 주입합니다.
평소처럼 작업합니다. 작업이 끝나면 maccha-save를 실행하여 새로운 학습 내용과 결정 사항을 영구적으로 저장합니다.
다음 세션: Claude Code가 업데이트된 컨텍스트를 로드합니다. 다시 설명할 필요가 없습니다.

프로필 커스터마이징:

타협할 수 없는 규칙들을 ~/.maccha/core/profile.md 파일에 편집하여 작성하세요:

# Developer Profile
- Package manager: pnpm
- CSS: Dark mode, no Tailwind, use CSS modules
...

이 규칙들은 모든 Claude Code 세션에 자동으로 주입됩니다.

향후 전망: MACCHA의 다음 단계

MACCHA는 아직 초기 단계(Hacker News 4점, 최소한의 커뮤니티 채택)이지만, 이 아키텍처는 Anthropic이나 다른 어떤 AI 에이전트 벤더도 제대로 해결하지 못한 실제 문제를 해결합니다. 파일 기반 접근 방식은 도구에 구애받지 않기(tool-agnostic) 때문에 우아합니다. 즉, Claude Code의 API나 특정 독점 형식에 의존하지 않습니다.

앞으로 다음과 같은 변화를 기대할 수 있습니다:

커뮤니티 CLAUDE.md 생성기: MACCHA 프로필을 팀을 위한 CLAUDE.md 파일로 변환해 주는 도구
MCP 서버 통합: MACCHA가 파일 주입 대신 모델 컨텍스트 프로토콜 (Model Context Protocol, MCP)을 통해 컨텍스트를 제공할 수 있도록 지원
충돌 해결 UI: 여러 에이전트가 서로 충돌하는 기억을 작성할 때를 위한 사용자 인터페이스

현재로서는 MACCHA는 사용하면 할수록 Claude Code를 더 똑똑하게 만드는 단순하고 강력한 도구입니다. 설치하고, 당신의 선호도를 한 번만 가르쳐 두면, 다시는 콜드 스타트(cold-start)를 겪을 필요가 없습니다.

출처: github.com

원문 게시지: gentic.news