Skafold Documentation

Working With AI

Update an existing project with AI

Give an AI the project’s live context URL and import one update containing exactly the requested frames.

Existing projects use one update path. The same skafold-frame-update file can contain one frame, a related combination, or all eight frames.

1. Publish current AI Context

Wait for the project toolbar to show Saved. If Update AI Context appears beside it, choose the button before asking an AI to make changes.

You can also open Project Tools → AI Context to create the link, copy it, or publish an update. The URL remains stable across revisions and is shared by the whole project team.

2. Give the URL to your AI

Use a task where Skafold Project Importer is installed and provide the AI Context URL immediately before the request.

Use this Skafold AI Context URL as the current source of truth.

Add a supplier onboarding journey and update the Dashboard page composition to support it.
Return one Skafold frame-update containing only User Journeys and Page Hierarchy.
Preserve stable IDs and leave every other frame unchanged.

The skill reads the live snapshot, confirms its bundled protocol is accepted, copies the baseline hash for every requested frame, and runs the dedicated frame-update validator before handoff.

Do not download or attach a whole-project Skafold JSON package. The AI Context URL replaces that step.

3. Choose the correct scope

Every included frame is a complete replacement target:

  • Project Overview
  • Structure
  • User Journeys
  • Sections
  • Page Hierarchy
  • Technical Architecture
  • Design Guidance
  • Pre-flight

A missing item inside an included frame means removal. A missing frame means no change.

Some changes need related frames in the same file:

  • Add or remove pages: include Structure and Page Hierarchy.
  • Remove a reusable Section used by pages: include Sections and Page Hierarchy.
  • Change only page placement order or instance labels: include Page Hierarchy only.
  • Change only reusable Section guidance: include Sections only.
  • Audit or revise launch requirements: include Pre-flight only unless findings also change another planning area.

4. Import the update

Open Import AI update from Project Tools or use the import icon on any frame. Both routes open the same modal and run the same validation.

Skafold shows:

  • Frames included in the update.
  • Added, updated, and removed items.
  • Cross-frame warnings.
  • Destructive removals requiring confirmation.

Applying the file changes only its supplied frames. It does not replace omitted project areas.

5. Handle stale context

If a targeted frame changed after the AI generated the file, Skafold rejects that target rather than overwriting newer work.

  1. Confirm the latest edits are saved.
  2. Choose Update AI Context.
  3. Ask the AI to refetch the same URL.
  4. Generate the update again.

Revision drift caused by unrelated frames does not block an update when every targeted frame still matches its baseline.

6. Continue with the same URL

After a successful import, Skafold publishes the resulting context. Team members and tools continue using the original URL; no new link or context package is required.

If Skafold reports that the changes were saved but AI Context could not be published, keep the imported changes and retry Update AI Context. Do not apply the same file again just to retry publication. If the project save itself failed, follow the save warning and confirm Saved before generating another update.