🧠 Onboarding Quiz Wizard (Per-collaborator personalization)

Goal

Personalize each invited collaborator experience in atlantyqa-labs using soft-skills, tech-skills, initial citizen role, and HMI device, with full GitHub traceability.

Operational flow

1. collaborator accepts org invitation on github.com.
2. opens the guided quiz wizard issue form.
3. bot classifies and suggests a personalized route.
4. citizen role + device + SSO preference are captured.
5. role labels + Day-1 plan are attached.
6. all critical decisions remain under explicit human approval.

Open quiz wizard

Open onboarding quiz Project v2

Flow governance

• template: .github/ISSUE_TEMPLATE/04_onboarding_quiz_wizard.yml
• automation: .github/workflows/onboarding-quiz-personalization.yml
• human protocol: portal/human-decision-protocol/

MicroK8s bot runtime (GitHub App)

For institutional operation, this flow is governed through MicroK8s bot runtime:

1. set ENABLE_GITHUB_APP_BOT=true in ops/microk8s/.env.
2. configure GitHub App credentials (GITHUB_APP_*).
3. deploy with scripts/microk8s/deploy_atlantyqa_microk8s.sh.

Associated runbook: - internal/microk8s-github-auth-runbook/