Closer/seed/questions/QUESTION_REWRITE_PLAN.md

3.2 KiB

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