spec(v4): promote R4-P0-1 user.klickd onboarding wizard to normative (docs-only)#38
Merged
Merged
Conversation
…(docs-only) Land the RFC 2119 normative contract for the user.klickd 7-step onboarding wizard with mandatory reload verification (step 6, non-negotiable), per R4-P0-1 in docs/roadmap/ROAD-TO-V4-GA.md §2.4. The new docs/spec/R4-P0-1-onboarding-wizard.md binds, in RFC 2119 language, the user-visible onboarding flow that any conforming v4 user.klickd writer MUST expose. It is strictly docs-only: - No schema, SDK, vector, wire-format, package, npm/PyPI/Zenodo/DOI or git tag change is implied. - The §33 field surface stays preview / non-normative; SPEC §33.11 references the new normative companion document. - §33.7 forward-compatibility and §33.10 privacy invariants are unchanged. UX constraints preserved: - user.klickd remains the simple step-by-step explanatory main path. - Advanced <x>.klickd profiles MUST NOT enter the user.klickd wizard. - QR / deeplink onboarding remains P1 conditional / P2 (governed by docs/ux/V4-ONBOARDING-QR-DEEPLINK.md), explicitly out of scope. - media / project / gaming continuity profiles stay out of scope and are mentioned only as "next step" references. - R4-P0-2 (KLICKD_E_* i18n table) referenced for step 4 / step 6 error contracts but not implemented here. Tests: verify_vectors.py 59/59 PASS; verify_vectors.mjs 29/29 PASS (13 skipped without hash-wasm, per CONTRIBUTING.md). Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
user.klickd7-step onboarding wizard with mandatory reload verification (step 6, non-negotiable).docs/spec/R4-P0-1-onboarding-wizard.mdand a pointer sectionSPEC.md §33.11linking to it.docs/roadmap/ROAD-TO-V4-GA.mdR4-P0-1 entry to reference the normative contract as a deliverable now landed.This PR is strictly docs-only and scope-limited to R4-P0-1. No SDK / schema / vector / wire-format / package / npm / PyPI / Zenodo / DOI / Git tag / GitHub release change is implied or required.
Scope (in / out)
In scope (R4-P0-1 only):
user.klickdwizard (steps 1–7).Out of scope (explicitly listed in §5 of the new doc):
user.klickdstrict schema → P0-2.KLICKD_E_*i18n error table → R4-P0-2 (referenced as a next step, not implemented here).docs/ux/V4-ONBOARDING-QR-DEEPLINK.md.media.klickd/project.klickd/gaming.klickd/agent.klickd/core.klickdprofiles → respective RFC tracks; MUST NOT enter theuser.klickdmain path.UX constraints preserved
user.klickd= simple step-by-step explanatory main path (this PR).<x>.klickd= advanced progressive disclosure (kept on separate entry, untouched).docs/ux/V4-ONBOARDING-QR-DEEPLINK.md).Files changed
docs/spec/R4-P0-1-onboarding-wizard.md— RFC 2119 normative contract, 7 steps + cross-cutting conformance + non-goals.SPEC.md— new sub-section §33.11 pointing to the normative companion (no change to §33.1–§33.10 normative behavior, no field-surface change).docs/roadmap/ROAD-TO-V4-GA.md— R4-P0-1 entry updated to reference the normative deliverable as landed.Testing
python verify_vectors.py→ 59/59 PASS (0 failed)node verify_vectors.mjs→ 29/29 PASS (0 failed, 13 skipped without hash-wasm, perCONTRIBUTING.md)git diff --stat)git grepconfirms no new package version, no new tag, no new release artefact references introducedNext recommended branch after this PR
Per §7 of the new normative doc and roadmap §2.4: R4-P0-2 —
KLICKD_E_*i18n error table (FR/EN/DE/LB) — because R4-P0-1 already depends on it for step 4 (passphrase confirmation failure) and step 6 (reload verification failure) error contracts. R4-P0-2 is docs-only and unblocks the wizard's error contract without touching SDK, schema, or vectors.🤖 Generated with Claude Code