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