Closer/seed/questions/QUESTION_REWRITE_PLAN.md

3.3 KiB

Closer Question Rewrite Plan v2

See also: QUESTION_CONTENT_GUIDE.md — writing philosophy, voice & tone | QUESTION_SCHEMA.md — JSON schema & validation rules | 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.