Skafold Documentation

AI Context and Maintenance

AI Context

Create one stable, versioned project URL for trusted AI chats, IDE tools, and team workflows.

AI Context is a read-only JSON snapshot of the project’s semantic planning. It replaces manual whole-project JSON downloads and Markdown context packages for ongoing AI work.

Create the project link

  1. Open a project and wait for Saved.
  2. Choose Project Tools → AI Context.
  3. Choose Create AI Context link.
  4. Copy the URL into the trusted AI chat or IDE that needs the plan.

Creation publishes revision 1. The URL belongs to the project and is shared across authorised editors; another user does not generate a different link.

What the URL contains

The current snapshot contains eight independently hashed frames:

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

Project Resources and Design References are represented by their titles, descriptions where available, and public HTTP(S) URLs. Image and document binaries are not embedded. AI tools can follow those links when they have web access; an inaccessible or private link should be reported rather than treated as read.

It also identifies its context revision and the AI workflow versions accepted by the project.

AI Context includes bounded frame-local node bounds and semantic connector handles so AI can place new structure around the current arrangement. It excludes raw canvas state, database records, collaboration presence, locks, edge bend points, styles, and internal persistence state.

Publish project changes

Editing the project does not silently change the public snapshot. This lets the team finish and review a set of changes before publishing them to AI tools.

When saved project changes are newer than AI Context, Skafold displays Update AI Context beside Saved and inside the modal. Choose it to publish the current semantic plan.

The URL stays the same. A meaningful context change creates a new revision; changes that do not affect semantic AI context simply mark the existing snapshot as checked and current.

Use it with an AI tool

Provide the URL immediately before asking the AI to plan an update:

Read this Skafold AI Context URL as the current source of truth. Update Technical Architecture for the confirmed CMS integration and return one Skafold frame-update containing only that frame.

Skafold Project Importer combines the live snapshot with its bundled protocol guidance and returns a file that can update one, several, or all frames.

Security

AI Context is a secret bearer link:

  • Anyone with the URL can read the published project context.
  • Share it only with trusted people and tools.
  • Do not place it in public tickets, documentation, source code, or screenshots.
  • Skafold rate limits public access and serves cacheable immutable snapshot content to reduce repeated origin work.

Deleting the link revokes the existing URL and can break team members’ AI chats or IDE configuration. Skafold requires a second confirmation and reminds you to inform the team. After deletion, creating AI Context produces a different URL.

AI Context is separate from the client Share link. Client sharing provides a view-only visual project; AI Context provides structured machine-readable planning.

Continue with Keep AI Context current.