Merged
Conversation
Add project context, full tech stack, core data types, key flows, and constraints from PRD. Include new critical rules for privacy-first development, research-only data use, and PRD adherence. Co-Authored-By: Claude Opus 4.5 <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
1 participant
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.
Add HomeFlow onboarding framework to CLAUDE.md and align guidance with PRD
♻️ Current situation & Problem
CLAUDE.md previously lacked a clear description of the HomeFlow onboarding flow, making it difficult to reason about user progression, feature scope, and implementation priorities.
This PR introduces a documented onboarding framework that reflects the HomeFlow PRD and clarifies how users move through the onboarding experience. As part of this, existing guidance in CLAUDE.md was updated to better align with PRD assumptions and terminology.
⚙️ Release Notes
📚 Documentation
This PR primarily focuses on documenting the HomeFlow onboarding experience in CLAUDE.md so that it can serve as a reliable reference for future onboarding-related development.
The onboarding flow is designed as a linear experience with clear progress feedback and consists of the following steps:
Welcome screen – Provides a brief overview of the app’s purpose (urinary symptom tracking and quality-of-life tracking).
Status: implemented
Eligibility screening via chatbot – Determines whether the user meets study eligibility criteria.
Status: not yet implemented
Consent form – Collects user consent for study participation.
Status: partially implemented; study-specific details still need to be filled in
Medical history collection via chatbot – Gathers relevant medical history information.
Status: not yet implemented; dependent on Apple HealthKit integration and OpenAI API support
IPSS survey – Captures baseline urinary symptom severity using the IPSS questionnaire.
Status: implemented
Completion screen – Confirms onboarding completion and transitions the user into the app.
Status: implemented
A progress bar is displayed at the bottom of the onboarding screens to communicate progress and clearly indicate how close the user is to completion.
While this PR also updates general guidance in CLAUDE.md to align with the HomeFlow PRD, the onboarding flow documentation is the main addition and is intended to guide upcoming implementation work.
📝 Code of Conduct & Contributing Guidelines
By submitting creating this pull request, you agree to follow our Code of Conduct and Contributing Guidelines: