Sculptured docs

Reusable groups

Save a group of agents once in your Library and add an independent copy to any project — with its jobs, arrows and workflow stages.

A group is a box of agents on the board, with a name and its own model defaults. Save a group to your Library and it becomes a reusable block: add a copy to any project, export it as a file, or share it through Community.

flowchart LR
  B["Project board"] -- "Save group to Library" --> L["Library: Reusable groups"]
  L -- "Add to project" --> P["Another project"]
  L -- "Saved groups (drag)" --> P
  L -- "Export" --> F[".group.json file"]
  F -- "Import group file" --> L
  C["Community"] -- "Save to Library" --> L

Groups on the board

Save a group from a project

  1. Select the group
    Click the group's name on the board to open its details.
  2. Save it
    Press Save group to Library. Sculptured saves an independent copy; editing the project later doesn't change it.
  3. Open the Library
    Follow Open Library, or open the app menu and choose Library.

The Library

Library (in the top bar) opens Reusable groups: every group you have saved, each with a small drawing of its agents and arrows.

ActionWhat it does
Create group blockStart a new group without a project.
Import group fileLoad a .json group file, review it, then save it.
Add to projectAdd a copy to a project you choose.
InspectRead every agent's instructions, each arrow and each stage.
EditChange the saved group in the group editor.
ExportDownload it as a .group.json file.

The group editor

Create group block and Edit open the group editor, a board for one group. Set the Group name, add agents and arrows, or Add workflow stage to make it a set of workflow stages (only when the group has agents and no ordinary arrows). The status reads Unsaved changes until you press Save group, then Saved in Library. Back to groups asks before discarding unsaved edits.

Editing a saved group creates no project and starts no agents. Agents in a group inherit the folder of the project they are added to.

Add a group to a project

From the Library

Press Add to project on the group. Choose the Destination project, or Create a new project and give it a Project name. Press Add & open project. The copy is added and its board opens.

The destination must be stopped: "Stop this project before adding agents, or choose a new project."

From the board

On the Design board, open More tools in the toolbar and press Saved groups, then drag a group onto the board, or click it to add it. Create or edit saved groups opens the Library.

Each insertion is an independent copy with its own agents. If a name is already taken, the copy gets a number ("Reviewer 2"), so every agent keeps its own name.

A group with workflow stages can't join a project that uses ordinary arrows, and a group with ordinary arrows can't join a workflow project. Sculptured says which and adds nothing.

Export and import

Export downloads <id>.group.json. Export makes the group portable by removing what belongs to one computer or one person:

Removed or reset on exportWhy
Folders, on the group and on every agentThey are paths on your computer.
Model choices for the team, group and agentsThe receiver picks their own.
Workflow InputIt may hold your own notes and links.
Permissions set to restrictedImported agents use the CLI's approval controls. See Questions and approvals for timeout behavior.
When it restarts set to start freshNo session carries over.

Jobs are kept as written, so read them before sharing: a Job can still contain private details.

Import group file reads an exported file of up to 500 KB with one group of at most 64 agents, and opens it in the group editor. Nothing is saved until you press Save group.

From Community

On a Community block, Add to project adds a reviewed copy straight to a project, and Save to Library keeps one here, marked From Community · v1; a newer version offers Update to v2. Download group saves the file instead. See Community.

Next steps