LayerFS: AI 코딩 에이전트를 위한 파일시스템
LayerFS: The filesystem for AI coding agents
TL;DR Highlight
에이전트마다 임시 Workspace를 마운트하고 결과만 커밋하는 파일시스템
Who Should Read
여러 코딩 에이전트를 병렬로 돌리며 작업 공간 충돌과 의존성 재설치 시간에 고민인 백엔드·플랫폼 개발자
Core Mechanics
- 에이전트마다 임시 Workspace를 쓴다
- 각 에이전트가 공유 커밋 이력 위에 쓰기 가능한 Workspace를 마운트한다.
- 작업 후 변경분을 커밋하고 Workspace는 사라진다.
- 툴 호출 하나가 커밋 하나다
- 파일 툴 호출은 Store에 대한 원자적 연산 하나다.
- Bash 호출은 끝날 때 커밋되고, 변경이 없으면 커밋하지 않는다.
- 브랜치 하나에 에이전트 여럿, 충돌은 거부된다
- 같은 파일을 동시에 수정하면 Conflict로 거부되고 merge marker가 남는다.
- blame으로 각 줄을 쓴 단계를 확인할 수 있다.
- fork는 파일을 복사하지 않는다
- fork는 메타데이터만 만들고 파일은 복사하지 않는다.
- 어떤 커밋에서든 재귀적으로 fork할 수 있다.
- 의존성이 마운트와 함께 따라온다
- .gitignore 대상 파일도 모든 커밋에 남는다.
- 원문 비교로 설치 약 5분 대비 마운트 0.05초이고, 측정된 마운트는 5~20ms다.
- 중복 제거와 압축으로 저장량을 줄인다
- 원문 도식 기준 10개 복사본이 dedup 후 1.05개, 압축 후 0.31개 분량이 된다.
- 이 도식은 illustrative라고 표기되어 있다.
- 충돌 규칙 .lww로 락파일은 최신 수정이 이긴다
- 루트의 .lww에 gitignore 스타일로 파일을 지정한다.
- 양쪽에서 바뀐 파일은 더 새로운 수정이 채택된다.
Community Reactions
- 이미 오래전에 나온 아이디어라는 의견
- 16년 전 Apiary 논문, 이후 특허(US8589947B2)로 거의 같은 이름의 선행 사례가 있다는 댓글이 달렸다.
- UnionFS·overlay2 등 layer 파일시스템과 이름이 겹쳐 혼란스럽다는 의견도 있었다.
- btrfs와 뭐가 다르냐는 질문
- 대안 도구를 소개한 댓글
- 현재 시스템의 미러에서 에이전트를 돌리고 효과를 검토·적용·폐기하게 해 주는 binpash/try를 추천했다.
- 비슷한 문제를 풀려고 사내 버전 관리 파일시스템을 만들었다는 글도 공유됐다.
- 사이트와 성숙도에 대한 불만
- 스크롤 가로채기와 지나치게 늘어진 레이아웃이 불편하다는 의견이 있었다.
- 아키텍처 페이지가 준비 중인데 v1이라는 점에 성숙도 판단이 어렵다는 의견도 있었다.
How to Apply
- 지금 쓰는 에이전트 작업 흐름의 충돌 지점 적어 보기
- 오늘 30분 동안 병렬 에이전트가 같은 파일을 건드리는 지점과 의존성 재설치 시간을 기록하라.
- 이 두 가지가 LayerFS가 겨냥하는 문제와 맞는지 확인하라.
- 락파일·빌드 산출물을 충돌 제외 대상으로 분리하기
- 병렬 작업에서 자주 충돌하는 lockfile, build output, cache 목록을 뽑아라.
- LayerFS를 쓴다면 이 목록을 /.lww에 gitignore 스타일로 적어라.
- 도입 전 대안과 비교하기
- binpash/try와 btrfs·overlay 기반 구성이 같은 요구를 충족하는지 먼저 비교하라.
- 원문 벤치마크 수치는 직접 같은 프로젝트에서 재측정하라.
Try It
# Claude/ChatGPT에 붙여넣기 (원문 개념을 프롬프트로 점검하는 간이 버전)
우리 팀은 코딩 에이전트를 병렬로 돌린다. 아래 원칙으로 현재 워크플로를 점검해 줘.
1. 에이전트 하나당 임시 Workspace를 쓰고, 끝나면 변경분만 커밋한다.
2. 툴 호출마다 체크포인트를 남기고, 변경이 없으면 남기지 않는다.
3. 같은 파일 동시 수정은 충돌로 처리하고, lockfile·build output·cache만 최신 수정 우선으로 둔다.
내 워크플로: {{현재 에이전트 작업 방식}}
각 원칙별로 현재 빠진 부분과 바꿀 점을 표로 정리해 줘.
이어서: 충돌이 가장 자주 나는 파일 종류를 알려주고 .lww에 넣을 후보 목록을 만들어 달라고 해 보세요.Terminology
관련 논문
Rust off Rails: 코드 없이 Markdown 60개로 만든 AI 에이전트용 웹 스택
Markdown 규칙 60개로 에이전트가 Rust 웹앱을 짜게 한다는 프레임워크
Launch HN: Alter (YC S25) – 멀티유저 에이전트용 접근 제어
에이전트마다 별도 신원·정책·감사로 API 키 공유 문제를 푼다
Claude로 코드의 공격 표면(attack surface) 줄이기
Claude로 25개 오픈소스를 분석해 불필요하게 열린 코드 493건을 찾았다
WhatsApp 도움말 페이지에 숨겨진 LLM 지시문: 규제기관을 추천하지 말라
WhatsApp 도움말에 화면엔 안 보이는 AI 지시문 102개가 숨어 있었다
같은 시뮬레이션, 다른 근거: 도구 출력을 파일로 넘기면 LLM 에이전트 정확도가 어디서 깎이나
긴 툴 출력을 파일로 넘기자 GPT-5.1은 정확도 11.3%p 하락, 정식 출력 지정하니 회복
가짜 뉴스가 진짜 폭락을: LLM 트레이딩 에이전트 대상 정보 주입 공격
가짜 헤드라인 한 줄로 LLM 트레이딩 에이전트 62%를 조종했다(프롬프트 주입은 14%)
Harness Engineering 101: LLM은 뇌, harness는 몸
에이전트는 JSON 배열을 관리하는 루프이고, 16개 챕터로 직접 만들어 본다
Harness²: 에이전트 harness를 스스로 고쳐 쓰는 재귀 최적화 프레임워크
모델은 고정하고 harness를 재귀로 고쳤더니 벤치마크 점수가 최대 11.8%p 올랐다