01-개념

01. 개념 — 트리가 곧 프롬프트다

모델은 ls부터 한다

Claude Code 같은 에이전트는 새 작업을 시작하면 거의 항상 디렉터리 구조부터 본다. Glob/ls/tree의 결과 자체가 컨텍스트의 일부가 된다. 폴더 이름이 한국어라면 한국어 의도가, 영어라면 영어 의도가 모델에게 전달된다.

HumanLayer는 progressive disclosure — 점진적 공개 의 자리를 다음처럼 권한다.

“Store specialized guidance in separate markdown files (agent_docs/...) with file references.”

의역: “전문 지침은 agent_docs/... 같은 별도 마크다운 파일에 저장하고 파일 참조로 연결하라.”

이 패턴이 작동하려면 파일 이름이 파일의 내용을 정직하게 말해야 한다. notes_v3_final_FINAL.md는 모델에게 아무것도 알려주지 않는다.

Long-running 에이전트의 약속된 파일들

Anthropic의 “Effective Harnesses for Long-Running Agents”는 두 종류의 에이전트가 서로 합의된 파일을 통해 통신한다고 말한다.

Initializer Agent

• init.sh — 개발 환경 셋업 스크립트.
• claude-progress.txt — 이전 작업 기록.
• 첫 git 커밋 — 베이스라인.

Coding Agent

이후 세션은:

• 진행 파일과 git 로그를 읽고
• 한 번에 하나의 기능에만 손대고
• 설명 있는 메시지로 커밋하고
• 코드를 항상 production-ready 상태로 둔다.

이 파일들이 어디에 있는지가 디렉터리 구조의 책임이다. claude-progress.txt가 루트에 있으면 매 세션 시작 첫 줄에 모델이 자연스럽게 본다. internal/notes/sessions/2026-04/progress.txt라면 못 본다.

본 위키의 자기 시연

이 위키 CLAUDE.md 마지막 줄:

“이 프로젝트는 자기 시연(self-demonstrating). 위키가 가르치는 OMC 패턴을 빌드 자체가 사용해야 한다.”

wiki/, sources/, .omc/, PRD/라는 4개의 최상위 폴더가 곧 권한·역할·라이프사이클을 표현한다. CLAUDE.md “디렉토리 권한” 표가 그대로 트리에 매핑된다. 사람도 모델도 같은 멘탈 모델로 본다.