ICM is a framework for building structured, multi-stage AI workflows out of markdown files and folder conventions. Each workspace gives AI agents the right context at each stage of a task, and gives humans clear edit surfaces between stages.
model-workspace-protocol/
├── CLAUDE.md (you are here)
├── README.md (project overview)
├── LICENSE
├── _core/ (shared conventions and templates)
│ ├── CONVENTIONS.md (source of truth for all patterns)
│ ├── placeholder-syntax.md (how {{VARIABLES}} work)
│ └── templates/ (blank starting points for new workspaces)
└── workspaces/
├── script-to-animation/ (content idea -> animated video)
├── course-deck-production/ (unstructured material -> course PowerPoints)
└── workspace-builder/ (builds new MWP workspaces)
| You want to... | Go to |
|---|---|
| Create content with script-to-animation | workspaces/script-to-animation/CLAUDE.md |
| Build course slide decks from source material | workspaces/course-deck-production/CLAUDE.md |
| Build a new workspace for any domain | workspaces/workspace-builder/CLAUDE.md |
| Read the full MWP specification | _core/CONVENTIONS.md |
| Understand the placeholder system | _core/placeholder-syntax.md |
| Use a template for a new workspace | _core/templates/ |
| Keyword | Action |
|---|---|
setup |
Run onboarding in whatever workspace you are in |
status |
Show pipeline completion for the current workspace |
Each workspace is self-contained with its own CLAUDE.md. Navigate into a workspace folder and that workspace's CLAUDE.md takes over. You do not need to read this root file once you are inside a workspace.