Skafold documentation

Skafold is a structure-first planning workspace for websites and applications. It helps you turn a brief into pages, page sections, user journeys, design guidance, and technical decisions before implementation starts.

Start here

• Create your first project and learn the canvas, workflow navigation, autosave, and readiness checks.
• Follow the project workflow from initial plan through repository handoff and maintenance.
• Understand frames and nodes before adding detailed project context.
• Define page hierarchy and sections so each page has usable implementation guidance.
• Export and maintain repository context when the plan is ready for implementation.
• Work with your AI when you want to generate or revise an editable Skafold JSON package.

Recommended workflow

1. Create a blank project, apply a structure preset, or import a plan from an AI tool.
2. Capture intent and constraints in Project Brief.
3. Map the direct page or screen hierarchy in Structure.
4. Define each page's ordered sections in Page Hierarchy.
5. Add focused User Journeys, Design Guidance, and Technical Architecture where they improve the handoff.
6. Review Readiness, then download the Markdown context package.
7. Add the Skafold Context Package folder to the repository and tell your coding tool to read it before planning or building.
8. As decisions change, update Skafold and replace only the affected frame Markdown file in the repository.

Use Download Skafold JSON separately when you want an AI tool to revise the editable Skafold project itself.

Documentation scope

• Getting Started: create a project and learn the canvas.
• Core Workflow: move from plan to maintained implementation context.
• Presets: start quickly and reuse your own structure patterns.
• Frames: understand each planning area and its node types.
• Page Hierarchy: define sections and the context attached to them.
• Export and Maintenance: hand context to a repository and keep it synchronized.
• Working With AI: install the skill and exchange editable JSON.
• Support: resolve import and validation problems.

For account-specific or unresolved issues, contact Skafold support.