Walkthrough

A typical session, end to end — from uploading a draft survey to saving a deployable artifact with a documented methodology trail.

1. Log in with your PIN

Open the app and paste the PIN from your welcome email. The PIN is session-scoped — close the tab and you'll need to re-enter it.

[Screenshot: PIN modal]

2. Submit your survey

Paste your questions one-per-line, or upload a Qualtrics export (.qsf, .csv, or .xlsx). The goal statement guides the entire validation — be specific about what you're measuring and what decisions the data will inform.

[Screenshot: import panel]

3. Read the score and verdict

Within 60–90 seconds you'll see a score out of 100, a one-sentence verdict, and an action button. The sidebar's Risk to your decisions warning line surfaces immediate concerns. Everything else (component breakdown, AI revision details, structural revisions, downloads) is collapsed by default — expand only what you want to read.

[Screenshot: sidebar three zones]

4. Try structural revisions (optional)

If the score is below your deploy threshold, click Try structural revisions. The AI proposes specific moves: split a double-barreled item, drop a no-construct item, merge a redundant pair, add an item to fill a construct gap. Each is a checkbox — review the rationale and accept only the moves you want.

[Screenshot: structural suggestions checklist]

5. Apply and re-validate

Apply the accepted moves. The AI re-writes the curated question list to clean up wording. Click Re-validate to score the new version. Iteration is free within the same survey — keep iterating until you're satisfied. Most surveys plateau within 2–3 cycles.

[Screenshot: re-validation score lift]

6. Save the deployable artifact

When the score lands at a level you can defend, click Save survey (.docx). The download is a Word document with the final question list AND a "Design decisions you own" appendix — every trade-off the validator deliberately deferred to you, framed as context + your call. Show it to your colleagues, attach it to your IRB submission, cite it in your methods section.

[Screenshot: docx appendix]

What "1 survey" means

All the iteration above — re-validate, structural revisions, apply moves, save — happens on a single survey and counts as your 1 credit. To validate a different survey, click New Survey, upload your new questions, and start over. That counts as another credit.