Skip to content

docs(questionnaires): F9.3 forking documentation#58

Merged
JohnD-EE merged 1 commit into
mainfrom
feat/F9.3-forking-docs
Jun 9, 2026
Merged

docs(questionnaires): F9.3 forking documentation#58
JohnD-EE merged 1 commit into
mainfrom
feat/F9.3-forking-docs

Conversation

@JohnD-EE

@JohnD-EE JohnD-EE commented Jun 9, 2026

Copy link
Copy Markdown
Contributor

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:
    • Part A — Re-skinning for a new vertical: what to keep verbatim (the platform + the vertical-neutral questionnaire engine), the rename-surface table (18 App* models, 18 app_* tables, 11 APP_QUESTIONNAIRES_* flags, live questionnaire/ConQuest counts), ordered sed recipes with the app_questionnaire-before-questionnaire collision rule and the "don't touch the lib/app/ bootstrap seams" guard, what content to replace, and the demo-tenancy replacement (grep DEMO-ONLY; three paths — delete / AppTenant+RLS / AppBrand).
    • Part B — Tracking upstream Sunrise: wiring the upstream remote, 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 to upstream-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 on f9.4.md.
  • Registered forking.md in the questionnaire docs index; flipped the three F9.3 status lines in development-plan.md to done.

Design notes

  • Cross-reference, don't duplicate or edit platform docs. CUSTOMIZATION.md, VERSIONING.md, .context/database/migrations.md are 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.md is the canonical home for the three demo-tenancy replacement pathsdemo-clients.md § "Fork guidance" already links to it for them.
  • No CHANGELOG.md entry — app-surface docs, not Sunrise platform public surface (per the repo's platform-scoped CHANGELOG policy).

Verification

  • All cross-reference links in the three new docs resolve to real files; cited npm scripts (db:drift-check, db:reset, …) and the Sunrise upstream URL check out.
  • Rename-surface counts and the 18-model / 11-flag inventory spot-checked against the repo.
  • Prettier-clean (lint-staged ran on commit).
  • The sed recipes are a documented procedure — not run against the tree.

🤖 Generated with Claude Code

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>
@JohnD-EE JohnD-EE merged commit 87821e9 into main Jun 9, 2026
14 checks passed
@JohnD-EE JohnD-EE deleted the feat/F9.3-forking-docs branch June 9, 2026 12:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant