Closer/seed/questions/QUESTION_REWRITE_PLAN.md

173 lines
3.2 KiB
Markdown

# Closer Question Rewrite Plan
## Repo Alignment
This plan reflects the current repository schema.
Use these type names exactly:
- written
- single_choice
- multi_choice
- scale
- this_or_that
Do not rename them. Do not introduce `choice` or `either_or` unless the application code is updated first.
## Product Goal
Closer should feel like a couples game, not a survey or therapy worksheet.
Questions should make couples:
- smile
- laugh
- learn something new
- remember something
- plan something together
- have meaningful conversations
If a question feels like homework, rewrite it.
## Question Mix
Every 250 question pack must contain:
| Type | Count |
|---|---|
| multi_choice | 140 |
| single_choice | 50 |
| scale | 35 |
| this_or_that | 15 |
| written | 10 |
This means 190 of 250 questions, or 76%, are choice based.
## Emotional Mix
Aim for:
- 35% fun and playful
- 25% everyday relationship
- 20% meaningful conversation
- 10% future dreams and planning
- 10% deeper vulnerability
Never group heavy questions together.
Every category must contain lighter moments.
## Consumer First Rules
People should naturally answer dozens of questions in one sitting.
Every category should create moments like:
- "I didn't know that."
- "Really?"
- "That's adorable."
- "We should do that."
The product sells shared moments, not data collection.
## Type Definitions
### multi_choice
Select every option that applies.
Default to this type whenever possible.
### single_choice
Select one best answer.
### scale
Rate agreement, comfort, confidence, importance, or frequency.
### this_or_that
Very fast playful questions.
Should take under three seconds.
### written
Reserve for questions where typing creates significantly more value.
Never use written for simple preferences.
## Rewrite Rules
For every category:
- Rewrite every question from scratch.
- Follow the content guide.
- Keep category ids.
- Keep conversational wording.
- Avoid therapy language.
- Avoid repetitive templates.
- Use 4 to 6 options for choice questions.
- Keep written questions rare.
- Add fun throughout every category.
## Fun Injection
Every category should include at least:
- 10 playful questions
- 5 questions that create laughter
- 5 questions that inspire a future date, memory, or shared activity
Even serious categories should include enjoyable moments.
## Rewrite Order
1. fun
2. date_night
3. quality_time
4. communication
5. gratitude
6. future
7. home_life
8. values
9. stress
10. money
11. boundaries
12. conflict
13. conflict_repair
14. trust
15. rebuilding_trust
16. difficult_conversations
17. emotional_intimacy
18. physical_intimacy
19. couple_intimacy
20. sex_and_desire
21. sexual_preferences
## Validation
Every rewritten pack must pass:
- Valid JSON
- Exactly 250 questions
- 75 free
- 175 premium
- 140 multi_choice
- 50 single_choice
- 35 scale
- 15 this_or_that
- 10 written
- Valid depth values only: light, medium, deep
- No numeric depth values
- No malformed keys
- No duplicate ids
- No duplicate questions
- Every choice question has options
- Every scale question has scale configuration
- Every written question has answer configuration
- No therapy worksheet wording
- No placeholder text
- Every category feels fun, conversational, and rewarding