wtf is icm-architect?

This project is a skill for Claude that helps turn any process, idea, or problem into an organized folder structure, or reorganize a folder, repository, or notes vault you already have. The underlying idea is called Interpretable Context Methodology, which uses folder structure itself to carry the logic that would normally need separate orchestration code. Numbered folders show the order things happen in, nested folders show scope and context, and plain markdown files hold the current state. The goal is that a single AI model reading the right files at the right time can do the work that would otherwise need several coordinated AI agents, and a human can open any folder and immediately understand what state things are in. The skill works in two modes. Build mode looks at how you describe your work, figures out the stages, the points where a human needs to approve something, and what stays fixed versus what changes each run, then sets up the smallest folder structure that fits. Restructure mode instead looks at a folder you already have, sorts every file into categories such as catalog, contract, factory, product, or dead, proposes a plan for reorganizing it, and then carries out that plan once you approve it. There are five reusable folder shapes it can apply: a pipeline for a production line style process, an umbrella for a portfolio of pipelines, a record library for things like people or client sessions, a knowledge bundle for a navigable set of reference material, and a context map for representing an organization as a network. These shapes can be combined or nested inside each other. Every result is checked with what the project calls a walk test, meaning an AI agent with no prior memory of the project must be able to look only at the files and correctly figure out what is going on and what to do next. To install it in Claude Code, you copy the folder into your skills directory and then simply ask Claude to structure something for you. For other Claude apps, you package the folder as a skill file and upload it through settings. The project is released under the MIT license.