Closer/seed/questions/QUESTION_REWRITE_PLAN.md

2.8 KiB

Closer Question Pack Rewrite Plan

Purpose

This document defines the active rewrite plan: what needs to happen, in what order, and how to validate each pack.

For writing philosophy and tone, see QUESTION_CONTENT_GUIDE.md. For JSON schema and validation rules, see QUESTION_SCHEMA.md.


1. Product Goal

Closer is a relationship app, not a survey or therapy worksheet.

Every question should make couples smile, laugh, learn something new, remember something, plan something together, or have a meaningful conversation.

The app should feel like a game you accidentally spend an hour playing.

If a question feels like homework, rewrite it.


2. Consumer First Philosophy

People are opening Closer while sitting on the couch, riding in the car, eating dinner, or lying in bed.

They are not looking to complete an emotional worksheet.

Questions should be quick, conversational, and rewarding.

A couple should naturally answer dozens of questions in one session.

Every category should create moments like:

  • "I didn't know that."
  • "Really?"
  • "That's adorable."
  • "We should do that."
  • laughter
  • flirting
  • nostalgia
  • future plans

3. Emotional Mix

Every pack should roughly contain:

  • 35% fun and playful
  • 25% everyday relationship
  • 20% meaningful conversations
  • 10% future dreams and planning
  • 10% deeper vulnerability

Never group heavy questions together.

Every category must contain moments of humor and curiosity.


4. Rewrite Rules

For every category:

  • Rewrite every question from scratch.
  • Follow the content guide.
  • Keep category ids.
  • Use conversational language.
  • Avoid therapy language.
  • Avoid corporate wording.
  • Avoid repetitive templates.
  • Keep answers short.
  • Use 4 to 6 options for choice questions.
  • Make multi_choice clearly allow multiple answers.
  • Make scale neutral.
  • Keep written questions rare.

5. Fun Injection

Every category must include:

  • at least 10 playful questions
  • at least 5 questions that create laughter
  • at least 5 questions that inspire a future date, memory, or shared activity

Even serious categories should contain lighter moments.


6. 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

7. Validation

Every rewritten pack must pass:

  • Valid JSON
  • 250 questions
  • 75 free
  • 175 premium
  • 140 multi_choice
  • 50 choice
  • 35 scale
  • 15 either_or
  • 10 written
  • Valid depth values only
  • No duplicate ids
  • No duplicate questions
  • No malformed keys
  • No placeholder text
  • No therapy worksheet tone
  • Every category contains fun, curiosity, and meaningful conversations