Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions CLAUDE.md
Original file line number Diff line number Diff line change
@@ -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
Expand All @@ -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
Expand All @@ -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/` |

Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
4 changes: 2 additions & 2 deletions _core/CONVENTIONS.md
Original file line number Diff line number Diff line change
@@ -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.

---

Expand Down
6 changes: 3 additions & 3 deletions workspaces/workspace-builder/CLAUDE.md
Original file line number Diff line number Diff line change
@@ -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

Expand All @@ -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)
```
Expand Down
4 changes: 2 additions & 2 deletions workspaces/workspace-builder/CONTEXT.md
Original file line number Diff line number Diff line change
@@ -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

Expand All @@ -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 |
Original file line number Diff line number Diff line change
@@ -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.

Expand Down
Original file line number Diff line number Diff line change
@@ -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.

---

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
Original file line number Diff line number Diff line change
@@ -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

Expand Down