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 Import/Export JSON.
  4. Choose Download Skafold JSON.
  5. Keep the downloaded file as the baseline for the next AI pass.

Revise with AI

Attach the exported JSON to a task where Skafold Project Importer or its standalone skill is active. In ChatGPT, mention the Project Importer with @. In Codex, mention $skafold-project-importer or select it from the skill picker. In Claude or Gemini, use a conversation where the standalone Project Importer skill or Gem is enabled.

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, globalSections, journeys, and architecture items.
Preserve each page section's page-specific instanceName, including when other fields on that page change.
Preserve supported fields such as layout, notes, tags, buildGuidance, explicit statusColor, and globalSectionId unless the request changes them. Remove legacy `statusColor: "gray"`; an omitted status means not started. Legacy `completed: true` values remain compatible and represent green.
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/Export JSON inside the existing project. Review the detected changes, confirm any removals, then choose Apply Update.

Updating the existing project is preferable to creating another project because stable IDs preserve the relationship between the exported baseline and the revision. Skafold also tries to preserve matching node positions, Page Hierarchy card placements, and connector paths during replacement.

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.
  • Add or revise canonical section definitions through globalSections, then reference them from page placements with globalSectionId.
  • Update Page Hierarchy composition tags or workflow status colors.
  • 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.