Closer/seed/questions/QUESTION_REWRITE_PLAN.md

161 lines
3.3 KiB
Markdown

# Closer Question Rewrite Plan v2
**See also:** [QUESTION_CONTENT_GUIDE.md](QUESTION_CONTENT_GUIDE.md) — writing philosophy, voice & tone | [QUESTION_SCHEMA.md](QUESTION_SCHEMA.md) — JSON schema & validation rules | [QUESTION_QUALITY_CHECKLIST.md](QUESTION_QUALITY_CHECKLIST.md) — quality gate before commit
## Product Goal
Closer is a relationship app, not a survey.
The experience should feel like a couples game that naturally creates conversations, laughter, memories, flirting, and meaningful moments.
If a question feels like homework, rewrite it.
## Repo Schema
Use these type names exactly:
* written
* single_choice
* multi_choice
* scale
* this_or_that
Do not rename them unless the app code is updated first.
## Question Mix per 250
| Type | Count |
|---|---:|
| multi_choice | 140 |
| single_choice | 50 |
| scale | 35 |
| this_or_that | 15 |
| written | 10 |
76 percent of questions must be choice based.
Written questions should stay rare.
## Free and Premium Split
Per 250 question pack:
* 75 free
* 175 premium
Suggested free split:
* multi_choice: 42
* single_choice: 15
* scale: 11
* this_or_that: 5
* written: 2
Suggested premium split:
* multi_choice: 98
* single_choice: 35
* scale: 24
* this_or_that: 10
* written: 8
Free should feel useful, fun, and complete.
Premium should feel deeper, richer, and more varied.
## Emotional Mix
Every category should roughly include:
* 35 percent playful
* 25 percent everyday relationship
* 20 percent meaningful conversation
* 10 percent future dreams and planning
* 10 percent deeper vulnerability
Never group heavy questions together.
Every category must include lighter moments.
## Rewrite Rules
For every category:
* Rewrite every question from scratch.
* Keep category ids.
* Use conversational language.
* Avoid therapy wording.
* Avoid survey wording.
* Avoid repetitive templates.
* Use 4 to 6 options for choice questions.
* Keep written questions rare.
* Add fun to every category.
* Make every category feel different.
* Reject questions that feel generated.
## 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
## Serious Category Rule
Serious categories still need warmth, humor, and relief.
Do not make conflict, trust, boundaries, or intimacy feel like couples counseling homework.
Use soft, safe, specific wording.
## Validation Rules
Every rewritten pack must pass:
* valid JSON
* exactly 250 questions
* exactly 75 free
* exactly 175 premium
* exactly 140 multi_choice
* exactly 50 single_choice
* exactly 35 scale
* exactly 15 this_or_that
* exactly 10 written
* at least 76 percent choice based
* valid depth values only: light, medium, deep
* no numeric depth values
* no malformed keys
* no duplicate ids
* no duplicate question text
* every choice question has options
* every scale question has scale configuration
* every written question has answer configuration
* no placeholder text
* no therapy worksheet tone
* no obvious AI repetition
## Final Rule
The schema only proves the file can load.
It does not prove the questions are good.
Quality review is mandatory before commit.