Sculptured docs

Design assistant

Ask your own Claude Code or Codex to change a team's design, inspect the proposal on the board, then approve or reject it.

The design assistant changes a team's design for you. Describe the change, for example "add a tester after the builder" or "make the reviewer's job stricter". Your own Claude Code or Codex proposes it, and the board shows the proposal before anything is saved. You inspect it, then approve it, reject it, or keep refining it.

flowchart LR
  D["Saved design"] -- "Ask" --> P["Proposal on the board"]
  P -- "Refine" --> P
  P -- "Approve" --> N["The proposal is the design"]
  P -- "Reject" --> D

Ask for a change

  1. Open the assistant
    On the Design board, choose Design assistant in the bar above the board. Its panel opens on the right.
  2. Choose who answers
    Choose Claude Code or Codex. It runs on your own computer with your own sign-in, like the agents do.
  3. Describe the change
    Write what should change and choose Ask. An answer usually takes under a minute.

Inspect the proposal

While a proposal is open, the board shows the proposal instead of the saved design:

Each card also says New, Changed or Removed, so nothing depends on colour alone. The panel lists every change in words. Choose a change to open it. For a changed Job, Compare the job shows the saved and proposed text side by side.

The board is read-only while you inspect, and Start waits until you approve or reject. The saved design does not change. Anything Sculptured can't keep from the answer is listed under parts Sculptured can't keep.

Approve, reject or keep going

Approve and Reject sit in the bar above the board and in the panel, so you can end the conversation at any point.

What the assistant reads

The assistant receives the design as a MADL file: agents, Jobs, groups, arrows, the Input, models, checks and token limits. It does not receive board positions, run history or file contents. New cards are placed next to their group, or to the right of the board. Cards that already exist stay where they are.

If the answer is not a valid design, Sculptured tells the assistant what was wrong and asks once more before showing you an error.