From e21cc14e5733dd938f240280c9b547714cc5e6ae Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?L=C3=A9on=20Avic=20Simmons?= Date: Wed, 19 Aug 2026 02:07:42 -0400 Subject: [PATCH] docs: complete the MWP -> ICM rename The project was renamed from Model Workspace Protocol to Interpretable Context Methodology, but 14 references to the old name survived, including in the two files that carry the most authority: _core/CONVENTIONS.md:1 "# MWP Conventions" _core/CONVENTIONS.md:3 "The rules for building and maintaining MWP workspaces. This is the canonical source." Pattern 5 (Canonical Sources) gives the smell test for exactly this: "search the repo for a specific phrase. If it appears in more than one file and both instances are meant to be authoritative, one needs to become a pointer." Run that test on the project's own name and it fails. Also in this change: - CLAUDE.md:1 heading read "# Interpreted-Context-Methdology" (two typos: "Interpreted" for "Interpretable", and "Methdology" missing an o). 02ba5d8 fixed the README title but not this one. - CLAUDE.md:8 folder map root was "model-workspace-protocol/". - README.md:254 cited the paper under its old title with a literal "(link-to-paper)" placeholder as the URL, while README.md:5 already carries the real arXiv link. Updated to the published title and URL: "Interpretable Context Methodology: Folder Structure as Agentic Architecture", https://arxiv.org/abs/2603.16021 Verified: 0 remaining matches for MWP / model-workspace-protocol / Model Workspace Protocol, 0 remaining "link-to-paper", and no em dashes introduced (Quality Guardrails). Note for the maintainer: references/conventions-reference.md line 3 is also touched by the /_core/ path fix in the companion PR. If both land, keep the relative path from that PR and the ICM wording from this one. --- CLAUDE.md | 8 ++++---- README.md | 2 +- _core/CONVENTIONS.md | 4 ++-- workspaces/workspace-builder/CLAUDE.md | 6 +++--- workspaces/workspace-builder/CONTEXT.md | 4 ++-- .../workspace-builder/references/conventions-reference.md | 4 ++-- .../references/examples/script-to-animation-summary.md | 2 +- .../workspace-builder/stages/01-discovery/CONTEXT.md | 2 +- .../workspace-builder/stages/05-validation/CONTEXT.md | 2 +- 9 files changed, 17 insertions(+), 17 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index b740a8b..bc8e725 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,11 +1,11 @@ -# Interpreted-Context-Methdology +# Interpretable Context Methodology (ICM) 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. ## Folder Map ``` -model-workspace-protocol/ +Interpretable-Context-Methodology/ ├── CLAUDE.md (you are here) ├── README.md (project overview) ├── LICENSE @@ -16,7 +16,7 @@ model-workspace-protocol/ └── workspaces/ ├── script-to-animation/ (content idea -> animated video) ├── course-deck-production/ (unstructured material -> course PowerPoints) - └── workspace-builder/ (builds new MWP workspaces) + └── workspace-builder/ (builds new ICM workspaces) ``` ## Routing @@ -26,7 +26,7 @@ model-workspace-protocol/ | 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` | +| Read the full ICM specification | `_core/CONVENTIONS.md` | | Understand the placeholder system | `_core/placeholder-syntax.md` | | Use a template for a new workspace | `_core/templates/` | diff --git a/README.md b/README.md index beb5552..380b198 100644 --- a/README.md +++ b/README.md @@ -251,7 +251,7 @@ Every workspace follows 15 patterns defined in [`_core/CONVENTIONS.md`](_core/CO ICM grew out of a [content production system](https://github.com/RinDig/Content-Agent-Routing-Promptbase) that applies separation of concerns to AI context windows instead of code modules. That system runs a full content operation: scripting, animation specs, Remotion builds, brand management. ICM is the general-purpose version -- the structural patterns extracted so anyone can scaffold their own workflows. -For the academic treatment, see [Model Workspace Protocol: Folder Structure as Agent Architecture](link-to-paper) (Van Clief, 2026). +For the academic treatment, see [Interpretable Context Methodology: Folder Structure as Agentic Architecture](https://arxiv.org/abs/2603.16021) (Van Clief, 2026). ## License diff --git a/_core/CONVENTIONS.md b/_core/CONVENTIONS.md index 10f2b01..887ef92 100644 --- a/_core/CONVENTIONS.md +++ b/_core/CONVENTIONS.md @@ -1,6 +1,6 @@ -# MWP Conventions +# ICM Conventions -The rules for building and maintaining MWP workspaces. This is the canonical source. Every workspace follows these patterns. +The rules for building and maintaining ICM workspaces. This is the canonical source. Every workspace follows these patterns. --- diff --git a/workspaces/workspace-builder/CLAUDE.md b/workspaces/workspace-builder/CLAUDE.md index 2e8321f..5760efd 100644 --- a/workspaces/workspace-builder/CLAUDE.md +++ b/workspaces/workspace-builder/CLAUDE.md @@ -1,6 +1,6 @@ # Workspace Builder -This workspace guides you through building a new MWP workspace for any domain -- from understanding the workflow through generating a complete, validated workspace scaffold. +This workspace guides you through building a new ICM workspace for any domain -- from understanding the workflow through generating a complete, validated workspace scaffold. ## Folder Map @@ -15,9 +15,9 @@ workspace-builder/ │ ├── 02-mapping/ (formalize stage contracts and dependencies) │ ├── 03-scaffolding/ (generate the folder tree and files) │ ├── 04-questionnaire-design/ (build the onboarding questionnaire) -│ └── 05-validation/ (verify against MWP conventions) +│ └── 05-validation/ (verify against ICM conventions) └── references/ - ├── conventions-reference.md (pointer to core MWP conventions) + ├── conventions-reference.md (pointer to core ICM conventions) └── examples/ └── script-to-animation-summary.md (completed workspace example) ``` diff --git a/workspaces/workspace-builder/CONTEXT.md b/workspaces/workspace-builder/CONTEXT.md index c0da565..60ccaab 100644 --- a/workspaces/workspace-builder/CONTEXT.md +++ b/workspaces/workspace-builder/CONTEXT.md @@ -1,6 +1,6 @@ # Workspace Builder -Build new MWP workspaces for any domain through a five-stage guided process. +Build new ICM workspaces for any domain through a five-stage guided process. ## Task Routing @@ -16,5 +16,5 @@ Build new MWP workspaces for any domain through a five-stage guided process. | Resource | Location | Contains | |----------|----------|----------| -| MWP conventions | `references/conventions-reference.md` | Pointer to core conventions (the rules for building workspaces) | +| ICM conventions | `references/conventions-reference.md` | Pointer to core conventions (the rules for building workspaces) | | Completed example | `references/examples/script-to-animation-summary.md` | Summary of the script-to-animation workspace | diff --git a/workspaces/workspace-builder/references/conventions-reference.md b/workspaces/workspace-builder/references/conventions-reference.md index a918f4e..d2cd200 100644 --- a/workspaces/workspace-builder/references/conventions-reference.md +++ b/workspaces/workspace-builder/references/conventions-reference.md @@ -1,6 +1,6 @@ -# MWP Conventions Reference +# ICM Conventions Reference -The canonical MWP conventions live at `/_core/CONVENTIONS.md`. Read that file for the full specification. +The canonical ICM conventions live at `/_core/CONVENTIONS.md`. Read that file for the full specification. This file is a pointer, not a copy. Do not duplicate content from CONVENTIONS.md here. diff --git a/workspaces/workspace-builder/references/examples/script-to-animation-summary.md b/workspaces/workspace-builder/references/examples/script-to-animation-summary.md index 725ab20..402a25d 100644 --- a/workspaces/workspace-builder/references/examples/script-to-animation-summary.md +++ b/workspaces/workspace-builder/references/examples/script-to-animation-summary.md @@ -1,6 +1,6 @@ # Example Workspace: Script-to-Animation -A condensed summary of the script-to-animation workspace. Use this as a reference when building new workspaces to understand what a completed MWP workspace looks like. +A condensed summary of the script-to-animation workspace. Use this as a reference when building new workspaces to understand what a completed ICM workspace looks like. --- diff --git a/workspaces/workspace-builder/stages/01-discovery/CONTEXT.md b/workspaces/workspace-builder/stages/01-discovery/CONTEXT.md index ef0998e..e434d48 100644 --- a/workspaces/workspace-builder/stages/01-discovery/CONTEXT.md +++ b/workspaces/workspace-builder/stages/01-discovery/CONTEXT.md @@ -7,7 +7,7 @@ Understand the domain workflow through conversation with the user. | Source | File/Location | Section/Scope | Why | |--------|--------------|---------------|-----| | User | (conversation) | Full workflow description | The domain to build a workspace for | -| Reference | `../../references/conventions-reference.md` | Full file | Know the MWP patterns to discover toward | +| Reference | `../../references/conventions-reference.md` | Full file | Know the ICM patterns to discover toward | | Reference | `../../references/examples/script-to-animation-summary.md` | Full file | Concrete example of a completed workspace | ## Process diff --git a/workspaces/workspace-builder/stages/05-validation/CONTEXT.md b/workspaces/workspace-builder/stages/05-validation/CONTEXT.md index 6eb5b11..879b856 100644 --- a/workspaces/workspace-builder/stages/05-validation/CONTEXT.md +++ b/workspaces/workspace-builder/stages/05-validation/CONTEXT.md @@ -1,6 +1,6 @@ # Stage 05: Validation -Verify the generated workspace against MWP conventions and fix any issues before the workspace ships. +Verify the generated workspace against ICM conventions and fix any issues before the workspace ships. ## Inputs