Questionnaire docs
Contributing
Keep changes focused on the portable skill package and its docs.
The repository is primarily a portable Agent Skill package. The website lives in site/ so installers and validators can distinguish runtime skill files from public docs.
Where changes belong
- SKILL.md: core runbook behavior, trigger description, and invocation flow.
- references/: long-form skill guidance, journeys, design system notes, and decision references.
- assets/: standalone browser template copied into each run directory.
- scripts/: deterministic helpers for starting and validating runs.
- site/: Astro website, public docs, demo data, social metadata, and visual tests.
Content rules
- Keep public docs original and concise.
- Do not copy private local skill text into public files.
- Do not add deployment notes to user-facing skill-install docs unless they affect skill usage.
- Keep the root skill package authoritative for runtime behavior.
Validation before PRs
check
python3 -m py_compile scripts/start-questionnaire.py scripts/validate-questionnaire-state.py
cd site
npm test
npm run build