MIT
/open source
/C4 · DDD · governance
Architecture that lives here,
and holds whatever builds from it.
Diagrams go stale because the drawing is the document, but the model doesn't stop at the diagram. Radical.Tools keeps one model, modelled by you or by AI, and turns it into the harness whatever builds from it has to run inside.
Modelled by either
Draw it yourself in Studio, chat it into being with the AI assistant, or let a coding agent edit the
.radical file directly in your repo. The model doesn't care who's architecting today.
Read as context
Before it writes a line, a coding agent reads the model: the boundaries the metamodel allows, the decisions already recorded in ADRs, the requirements it has to satisfy.
Checked against
Fitness functions, ADRs and EARS requirements aren't written after the fact. They're what catches the code, human or AI, when it drifts from what the model says.
Also in the box
- Governance as first-class elements. ADRs, fitness functions and EARS requirements are model elements, linked to what they constrain, implement, satisfy or supersede. Type a requirement as a sentence — “When the user clicks save, the system shall persist the document” — and it is parsed into trigger, condition and action.
- AI that edits the model, not the picture. Ask what depends on what, find gaps, or describe a change in plain language. The answer comes back as a patch that is validated against the metamodel, applied to the model and undoable. Claude, OpenAI, Gemini or local Ollama — your key, called directly, nothing proxied.
- Concept Hub. 70+ curated requirements, ADRs, fitness functions, patterns and blueprints, rendered by the same engine as Studio. Fill in a template’s parameters, add it to your model, reconfigure later.
- Layout that earns its name. Smart Layout runs layered (ELK), force-directed and simulated-annealing candidates, scores them for crossings and overlap, and keeps the best. Live physics keeps things tidy while you drag; a tree mode handles deep containment.
- Three perspectives, one model. Designer edits. Viewer explores read-only — drag, collapse, re-layout without touching the saved model. Presenter turns views into slides that capture scope, layout and camera; flow views replay step by step.
-
Plain files, no lock-in. Save as a single
.radicalJSON file, or as a folder of Markdown — one.mdper element with YAML front-matter, hierarchy as directories, layout in a sidecar. Diff it in git, edit it in any editor, script it. Autosaved either way. -
Desktop, browser or VS Code — same code. The Electron app opens local files and folders and reloads a file you launched it with when it changes on disk. The web build needs no install and can still work on a local folder. The VS Code extension embeds the full editor for
.radicalfiles.
Start from the Hub
Don’t model from a blank canvas. Open a concept as a diagram, wiki page or table — exactly as it will look in your model — collect the ones you want and add them to Studio in one click.
Run it locally
Node.js ≥ 18. The desktop app adds local folders, file watching and the Markdown-folder format with no browser permissions — or skip the install and use studio.radical.tools.
# clone, install, run
git clone https://github.com/radicaltools/radical.tools.git
cd radical.tools
npm install
npm run dev