Claude 스킬로, 어떤 프로세스, 아이디어, 문제를 ICM 작업 공간 — 에이전트 아키텍처로서의 폴더 구조**로 설계하거나 기존 폴더, 저장소, 볼트를 하나로 재구성하는 기술입니다.

ICM(해석 가능한 컨텍스트 방법론)은 오케스트레이션 코드를 구조로 대체합니다: 번호가 매겨진 폴더는 순서를 담당하고, 계층 구조는 컨텍스트 범위를, 일반 마크다운 파일은 상태를 나타냅니다. 한 에이전트가 적절한 시점에 적절한 파일을 읽으면 다중 에이전트 프레임워크의 역할을 수행하며, 사람은 어떤 폴더든 열어 시스템이 어떤 상태인지 정확히 확인할 수 있습니다.

작업 공간은 도서관이다. 라우팅 파일은 카탈로그다: 작고 안정적이며 모든 것을 가리키고 거의 아무것도 저장하지 않는다. 한 명의 사서 — 한 명의 모델 — 이 건물을 돌아다니며, 질문이 어느 선반으로 걸어갈지 결정한다.

• 논문: 해석 가능한 컨텍스트 방법론: 에이전트 아키텍처로서의 폴더 구조 (Van Clief & McDermott)
• 커뮤니티: 클리프 노트

그것이 하는 일들

두 가지 모드:

• 빌드 — 이미 작업물을 설명하는 구조(단계, 인간 게이트, 안정적인지 각 런마다 무엇인지)를 추출하고, 여섯 가지 검증된 형태 중 하나를 선택해 가장 작은 작업 공간을 비계로 만듭니다.

icm-architect

An agent skill that designs any process, idea, or problem into an ICM workspace (folder structure as agent architecture), or restructures an existing folder, repo, or vault into one. It follows the open Agent Skills format, so it works in any agent that reads SKILL.md (Codex, Gemini CLI, Hermes Agent, Claude Code, Cursor, GitHub Copilot and others) and in any model you hand the folder to.

ICM (Interpretable Context Methodology) replaces orchestration code with structure: numbered folders carry sequencing, hierarchy carries context scoping, plain markdown files carry state. One agent, reading the right files at the right moment, does the work of a multi-agent framework, and a person can open any folder and see what state the system is in.

• Paper: Interpretable Context Methodology: Folder Structure as Agent Architecture (Van Clief & McDermott)
• Community: Clief Notes

What it does

Two modes:

• Build: extracts the structure already present in how you describe your work (the stages, the checks, what’s stable vs. per-run), picks a form, and scaffolds the smallest workspace that carries it.
• Restructure: audits an existing folder, classifies every file (catalog / contract / factory / product / dead), finds what points at each one, proposes a migration map for approval, then migrates and validates.

Every ICM is built from three primitives: a sequence (numbered steps, each one’s output the next one’s input), a shelf (a folder of same-shaped files), and a catalog (a small file that points down). The forms are recipes over them: Pipeline, Record library, Knowledge bundle (including one built from transcripts and research, with every quote checked against its source), Context map, and System map. They nest.

Every step ends at a check (a person, a script, or a small model) so a wrong turn is caught before the next step amplifies it. Every result is validated with the walk test: an agent with no memory must orient, act, and report status from the files alone.

The workspaces it builds are plain folders and markdown with AGENTS.md as the entry file, the name most agents read by default; tools that look for another name get a one-line pointer to it. Nothing in a workspace depends on one vendor.

Install

Keep the folder named icm-architect: a skill’s name must match its folder.