Sculptured docs

MADL files

Export a team as a Multi-Agent Descriptor Language file that other tools can read, and import MADL files as teams.

MADL, the Multi-Agent Descriptor Language, is an open, vendor-neutral file format for describing a multi-agent system. A MADL file holds:

Use it to share a team with tools other than Sculptured, to keep a readable copy in a Git repository, or to bring in a system designed elsewhere.

ExportThe team's Settings → Export → Export team file. The file goes to your downloads as <team>.madl.yaml. Leave Include folders off to share it.
ImportNew project → Advanced: import a team file or a past run → choose a .madl.yaml (or .json) file, or paste it, then Import.

What is kept

A team exported from Sculptured and imported again comes back unchanged. Everything is in MADL's own fields, with nothing in a Sculptured-only extension, so another MADL tool sees the whole team.

SculpturedMADL
Agents, their Jobs and kindsagents, with instructions and runtime: claude-code or codex
Groupsgroups, and each agent's groups
Hands work to, reports to, watchesconnections of kind handoff, report, watch
The Inputinputs
Modelseach agent's model, written as provider/model
Token, turn and time limitssettings.restrictions.budget, as { soft, hard }
Run budgetssystem.budget
Contracts: what an agent reads, writes and decidesdata_access and authority
Skillsskills, embedded as { name, description, body }
Checkschecks
Schedulespolicies.schedules
Positions on the boardlayout
Workflows: stages, routes, limits, and a dispatch commandworkflows
Components, and the ones each agent usestools, given to agents by id
Restricted permissionssettings.restrictions.approvals, as runtime-permissions
The project folder and own copiesdefaults.preferences.workspace
Question timeoutdefaults.preferences.questions
Protectionspreferences.context
Your Claude Code setuppreferences.config
An agent's briefing (full or minimal)preferences.briefing
Safety rulesrestrictions.tools.refuse
Plan pausessystem.budget.plan[].pause
The decision loga channel with medium decision-log

Importing a MADL file from elsewhere

MADL can describe more than Sculptured runs today. Importing keeps what Sculptured can use and lists the rest by its place in the file, under Not imported:

A file that is not valid MADL is refused with each error and where it is. A MADL file that refers to other files ($ref) can't be uploaded as it is. Join it into one file first with madl expand:

cargo install --git https://github.com/Sculptured/Multi-Agent-Descriptor-Language madl-cli
madl expand team.madl.yaml > one-file.madl.yaml

The madl command also validates a file (madl validate), shows every agent's effective settings (madl resolve) and draws it (madl graph).