Working With AI
Version history
Track Skafold Project Importer, skill, AI protocol, and JSON contract compatibility.
Use this page for AI workflow compatibility. For user-facing product releases, see Product Updates.
Current versions
| Area | Current version | Purpose |
|---|---|---|
| Project Importer plugin | 2.4.0 | Installs the discovery, seed, and existing-project update skill. |
| Project Importer skill | 2.4 | Generates project seeds and scoped frame updates from bundled knowledge. |
| AI workflow protocol | 1.10 | Defines AI Context compatibility and deterministic frame-update validation. |
| Project seed schema | 1.0 | Creates a new Skafold project. |
| AI Context schema | 1.0 | Describes a published existing-project snapshot. |
| Frame update schema | 1.0 | Applies one, several, or all supplied frames. |
Project Importer 2.4
Version 2.4 makes choice authoring label-only for radio buttons, dropdowns, and checkbox groups. The skill generates internal choice values and preserves them when labels or order change. Markdown handoffs show labels; JSON keeps the existing label/value structure for stable imports. Explicit CMS value requirements belong in field guidance.
Protocol 1.10 publishes the updated guidance. Earlier supported frame updates remain accepted, and historical protocol resources are unchanged. Update the installed importer and republish AI Context to use the new guidance.
Project Importer 2.3
Version 2.3 adds the expanded section schema types in protocol 1.9: common inputs, choice lists with display labels and stored values, media fields, content references, single object groups, and a Custom escape hatch with a type name and guidance. The bundled guidance and validators preserve these fields through project seeds and frame updates.
Update the installed importer before working with these types, then update AI Context in Skafold and fetch the same URL again. Earlier supported frame-update versions and existing section definitions remain accepted; historical protocol resources are unchanged.
Project Importer 2.2
Version 2.2 aligns the bundled schemas with protocol 1.8 and includes the shared validator helper in both plugin and standalone downloads. Protocol 1.8 preserves the current Section content fields and repeating groups in a coherent immutable release. Earlier supported frame-update versions remain accepted.
After installing this release, update AI Context in Skafold if the snapshot does not yet advertise protocol 1.8, then ask the AI to fetch the same URL again.
Project Importer 2.1
Version 2.1 packages schemas, guidance, examples, and validators directly with the installed skill. File generation no longer downloads protocol resources or manifests. Existing-project updates still fetch the live bearer AI Context URL immediately before planning.
When a user selects a file generated with a legacy importer or protocol, Skafold now points them to the current download documentation from the import screen.
Project Importer 2.0
Version 2.0 introduces the current round-trip workflow:
skafold-project-seedfor new projects.- A stable AI Context bearer URL for existing projects.
- One
skafold-frame-updateformat for any update scope. - Per-frame baselines so unrelated team changes do not automatically block a focused update.
- Versioned schemas and guidance for project seeds and frame updates.
- Stable-ID and cross-frame dependency rules for Structure, Sections, and Page Hierarchy.
- A dedicated frame-update validator that resolves the protocol's linked schemas and reports canonical ordering before handoff.
Protocol 1.7 adds the independently updateable Pre-flight frame, Project Resource links, repeatable titled Design References, and repeatable Typography role/name pairs. Earlier immutable protocol releases remain available for snapshots already pinned to them.
Installed skill updates
The Project Importer uses the schemas and guidance bundled in its installed release:
- New-project generation reads only local skill references.
- Existing-project generation combines local references with the latest live AI Context snapshot.
- The bundled validators verify the completed seed or frame update before handoff.
Update the installed plugin when Skafold changes supported nodes, frames, schemas, or generation guidance.
The September 22, 2026 Sections and Pages interface update does not require a new plugin or skill release. The section editor, drag reordering, bulk status controls, and status filters use the existing ordered content fields and independent definition and placement statuses. The subsequent field-type expansion does require Project Importer 2.3 and protocol 1.9.
Compatibility rules
Use the format that matches the operation:
{ "format": "skafold-project-seed", "schemaVersion": "1.0" }
{ "format": "skafold-ai-context", "schemaVersion": "1.0" }
{ "format": "skafold-frame-update", "schemaVersion": "1.0" }
Legacy skafold-context files belong to the retired whole-project exchange workflow and are not the contract for the new AI Context flow.
When to update the installed plugin
Download and reinstall the Project Importer when Skafold announces:
- A new Project Importer version.
- New or changed node and frame capabilities.
- Schema, validator, generation-guidance, or Section preset changes.
If Skafold detects a legacy file during import, follow the displayed link to download the latest version.