docs(questionnaires): F9.3 forking documentation#58
Merged
Conversation
Add the fork-readiness docs for ConQuest: - forking.md (keystone) — Part A re-skinning for a new vertical (keep/rename/replace, ordered sed recipes, demo-tenancy replacement), Part B tracking upstream Sunrise (upstream remote, merge discipline, contribute-back loop). Cross-references the platform-owned docs (CUSTOMIZATION.md, VERSIONING.md, migrations.md) rather than editing them. - contributions-upstream.md — resolved-counterpart ledger to upstream-gaps.md; records UG-1/UG-2 (Sunrise PR #286/#285, both v0.0.1) as a sales artefact. - f9.3.md tracker; registered forking.md in the questionnaire docs index; flipped the F9.3 status lines in the development plan. Docs-only — no code/schema/route changes; no CHANGELOG entry (app surface). Co-Authored-By: Claude Opus 4.8 (1M context) <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.
What & why
F9.3 — Forking documentation, the fork-readiness deliverable of phase P9. Two readers need a map: a client-engagement team inheriting this repo to deliver a different vertical, and any fork tracking upstream Sunrise. This PR writes both maps and records the upstream contributions ConQuest's own build already drove.
Docs-only — no code, schema, or route changes.
Deliverables
.context/app/questionnaire/forking.md(new, keystone) — two halves:App*models, 18app_*tables, 11APP_QUESTIONNAIRES_*flags, livequestionnaire/ConQuestcounts), orderedsedrecipes with theapp_questionnaire-before-questionnairecollision rule and the "don't touch thelib/app/bootstrap seams" guard, what content to replace, and the demo-tenancy replacement (grepDEMO-ONLY; three paths — delete /AppTenant+RLS /AppBrand).upstreamremote, the merge recipe, semantic-conflict discipline (never edit Sunrise's migration SQL), version-decision references, and the contribute-back loop..context/app/planning/contributions-upstream.md(new) — resolved-counterpart ledger toupstream-gaps.md: UG-1/UG-2 table (Sunrise PR #286/#285, both in v0.0.1) with honest "smaller than planned, still a real sales artefact" framing..context/app/planning/features/f9.3.md(new) — feature tracker, modeled onf9.4.md.forking.mdin the questionnaire docs index; flipped the three F9.3 status lines indevelopment-plan.mdto done.Design notes
CUSTOMIZATION.md,VERSIONING.md,.context/database/migrations.mdare platform-owned (they merge through from upstream) — they are linked as authoritative, never edited. The new value is ConQuest-specific detail and the sequencing of the upstream-tracking mechanics into one guide.forking.mdis the canonical home for the three demo-tenancy replacement paths —demo-clients.md§ "Fork guidance" already links to it for them.CHANGELOG.mdentry — app-surface docs, not Sunrise platform public surface (per the repo's platform-scoped CHANGELOG policy).Verification
db:drift-check,db:reset, …) and the Sunrise upstream URL check out.sedrecipes are a documented procedure — not run against the tree.🤖 Generated with Claude Code