Questionnaire docs

Validation

Keep state files and skill packages mechanically checkable.

Validation keeps the run resumable and keeps the skill package portable.

State validation

Validate generated or imported state before treating it as the durable run source.

state

python3 scripts/validate-questionnaire-state.py path/to/state.json

Python helpers should compile cleanly before publishing or installing the skill.

scripts

python3 -m py_compile scripts/start-questionnaire.py scripts/validate-questionnaire-state.py

Use the official skills-ref validator when available. If it is unavailable, keep local checks honest and state which validation was skipped.

skill

skills-ref validate .

The Astro site should build statically from site/ and keep visual-contract tests around the demo and docs shell.

site

cd site
npm test
npm run build