# Icm Architect

Design a process, idea or body of knowledge into an ICM (Interpretable Context...

- Repository: https://github.com/RinDig/icm-architect (2122 stars)
- Category: Design
- License: MIT
- Last updated: 2026-10-24
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add RinDig/icm-architect --skill icm-architect -g -a claude-code -y`
Codex: `npx skills add RinDig/icm-architect --skill icm-architect -g -a codex -y`
Cursor: `npx skills add RinDig/icm-architect --skill icm-architect -g -a cursor -y`
Gemini CLI: `npx skills add RinDig/icm-architect --skill icm-architect -g -a gemini-cli -y`

## Description

Design a process, idea or body of knowledge into an ICM (Interpretable Context Methodology) workspace, where folder structure is the agent architecture, or restructure an existing folder, repo or vault into one. Use for "make this an ICM", "ICM this", "build me a workspace", "structure this for agents", "map this repo", "audit this folder", "what would a change hit", a second brain, team brain or context map, or turning transcripts and research into material for lectures, scripts or docs.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# ICM Architect

Build workspaces where the folder structure does the orchestration. One agent, reading the right files at the right moment, replaces a multi-agent framework: numbered folders carry sequencing, hierarchy carries context scoping, plain markdown files carry state. A person can open any folder and see what state the system is in, because state is just files. The routing files are the catalog: small and stable, they point at the shelves where the content lives.

Method: Interpretable Context Methodology (Van Clief & McDermott, arXiv:2603.16021, MIT-licensed). It runs in any agent or model that can read files: nothing in a workspace depends on one vendor's tools.

## The invariants

Every ICM starts from these ten. They are defaults: when you know what works and need a nuanced change, break one on purpose and write why in the nearest `CONTEXT.md` or `AGENTS.md`.

The rest: https://github.com/RinDig/icm-architect/blob/HEAD//SKILL.md