Skafold Documentation

Working With AI

Export and revise

Export the current project to JSON, refine it with an AI tool, and import the complete revision back into Skafold.

The circular workflow lets Skafold remain the visual source of truth while an AI helps with discovery, expansion, or revision.

Export from Skafold

  1. Open a project in Structure Studio.
  2. Open Export Context.
  3. Choose Download Skafold JSON.
  4. Keep the downloaded file as the baseline for the next AI pass.

Revise with AI

Attach the exported JSON to a chat using the installed Skafold skill. Describe the changes and explicitly request a complete revised package.

Use the attached Skafold JSON as the baseline.

Add a supplier onboarding journey and update the dashboard page sections.
Preserve IDs for unchanged pages, sections, journeys, and architecture items.
Return one complete revised JSON package, not a patch.

The skill should retain fields that the conversation does not change. Review assumptions and open questions before importing.

Return to Skafold

Use Import JSON and replace inside the existing project. The replacement flow is preferable to creating another project because stable IDs preserve the relationship between the exported baseline and the revision.

Good revision requests

Keep each AI pass focused:

  • Add or revise a page group.
  • Split a complex user journey into separate goals.
  • Add implementation architecture supported by confirmed requirements.
  • Expand page sections using recognised Skafold presets.
  • Refine design guidance or token values.
  • Resolve specific open questions.

Avoid asking the AI to redesign every part of the package when only one area changed.