From 51702e910beba9e283162bbb157d2f36604be0a4 Mon Sep 17 00:00:00 2001 From: null Date: Sun, 21 Jun 2026 19:45:55 -0500 Subject: [PATCH] remove --- seed/questions/QUESTION_CONTENT_GUIDE.md | 998 +++++++++++++++++++++++ 1 file changed, 998 insertions(+) create mode 100644 seed/questions/QUESTION_CONTENT_GUIDE.md diff --git a/seed/questions/QUESTION_CONTENT_GUIDE.md b/seed/questions/QUESTION_CONTENT_GUIDE.md new file mode 100644 index 00000000..91c839a7 --- /dev/null +++ b/seed/questions/QUESTION_CONTENT_GUIDE.md @@ -0,0 +1,998 @@ +# Closer Question Content Guide + +## Purpose + +This guide defines how Closer question packs should be written, reviewed, and validated. + +Closer is a private couples app. The questions should help two people feel closer through honest, warm, simple conversation. The app should not sound robotic, clinical, cheesy, judgmental, or like therapy homework. + +Use this guide before writing or rewriting any question JSON file. + +--- + +# 1. The Closer Voice + +Closer should sound: + +- warm +- private +- plainspoken +- emotionally honest +- lightly playful when appropriate +- easy to answer +- respectful of both partners +- safe and non-pressuring + +Closer should not sound: + +- robotic +- overly formal +- fake-deep +- preachy +- judgmental +- clinical +- like a therapist worksheet +- like a corporate wellness app +- sexually pushy +- repetitive +- awkwardly generated + +## Voice rule + +A good Closer question should sound like something a real person could comfortably ask their partner. + +Bad: + +```text +What boundary around money boundaries would help you feel respected? +``` + +Better: + +```text +What money boundary would help you feel more respected? +``` + +Best: + +```text +What is one money habit we could agree on that would make things feel calmer between us? +``` + +--- + +# 2. Core Writing Standard + +Every question should pass this test: + +```bat +ECHO Would a real couple actually answer this? +ECHO Is it clear in one read? +ECHO Does it sound natural out loud? +ECHO Does it invite honesty without blaming either partner? +ECHO Does it fit the pack topic? +ECHO Does it avoid sounding like AI generated filler? +``` + +If the answer is no, rewrite it. + +--- + +# 3. Product Goal + +Questions should create moments like: + +```text +Oh, that is easy to answer. +That actually sounds like us. +I never thought to ask that. +That feels safe to say. +That could start a good conversation. +That makes me want to see my partner's answer. +``` + +Questions should not create moments like: + +```text +What does this even mean? +Why is this worded so strangely? +This feels like therapy homework. +This sounds too intense. +This sounds too sexual too fast. +This feels repetitive. +This makes me feel accused. +``` + +--- + +# 4. Category Purpose + +Every pack needs a clear purpose. + +Before writing a pack, define: + +```bat +SET PACK_NAME= +SET PACK_PURPOSE= +SET USER_FEELING= +SET RELATIONSHIP_OUTCOME= +SET FREE_VALUE= +SET PREMIUM_VALUE= +``` + +Example: + +```bat +SET PACK_NAME=Date Night +SET PACK_PURPOSE=Help couples plan, enjoy, and remember time together. +SET USER_FEELING=Playful, wanted, relaxed, connected. +SET RELATIONSHIP_OUTCOME=More intentional time together without pressure. +SET FREE_VALUE=Easy, fun, low-pressure date questions. +SET PREMIUM_VALUE=Deeper romance, planning preferences, rut-breaking, and memory-making prompts. +``` + +--- + +# 5. Question Depth Levels + +Use depth intentionally. + +## Light + +Light questions should be easy, fun, and low-pressure. + +Examples: + +```text +What is a simple date we could do with almost no planning? +What snack would make a movie night feel complete? +Would you rather go out for dessert or stay in with a blanket? +``` + +## Medium + +Medium questions should reveal preferences, needs, feelings, or patterns. + +Examples: + +```text +What makes a night together feel special instead of routine? +What helps you feel like I really want to spend time with you? +What is one thing that would make date night easier for us to follow through on? +``` + +## Deep + +Deep questions should invite vulnerability without pressure or blame. + +Examples: + +```text +When have you felt most wanted by me, and what made it feel that way? +What kind of attention from me makes you feel closest? +What do you miss about the way we used to spend time together? +``` + +## Depth rules + +```bat +ECHO Light questions should not feel shallow or useless. +ECHO Medium questions should not feel like a confrontation. +ECHO Deep questions should not feel like a trap. +ECHO Sensitive questions should never pressure a partner to disclose, forgive, explain, or perform. +``` + +--- + +# 6. Question Types + +Each question type should have a purpose. + +## written + +Use for stories, memories, reflection, emotional honesty, and open-ended answers. + +Good written examples: + +```text +What is one small thing I do that makes you feel cared for? +What is a memory of us that still makes you smile? +What is something you wish we made more time for? +``` + +Avoid written questions that are too vague: + +```text +How can we deepen our connection? +``` + +Better: + +```text +What is one thing we could do this week that would make us feel more like a team? +``` + +--- + +## single_choice + +Use for preferences and simple decisions. + +Good single-choice example: + +```json +{ + "type": "single_choice", + "text": "Which kind of date sounds best this week?", + "options": [ + { "id": "cozy_at_home", "text": "Cozy at home" }, + { "id": "dinner_out", "text": "Dinner out" }, + { "id": "something_playful", "text": "Something playful" }, + { "id": "something_outside", "text": "Something outside" }, + { "id": "surprise_me", "text": "Surprise me" } + ] +} +``` + +Rules: + +```bat +ECHO Options should be short. +ECHO Options should not overlap too much. +ECHO Options should sound like real choices. +ECHO Avoid more than 6 options unless truly needed. +``` + +--- + +## multi_choice + +Use when more than one answer can be true. + +Good multi-choice example: + +```json +{ + "type": "multi_choice", + "text": "What helps you feel relaxed on a date with me?", + "options": [ + { "id": "no_rushing", "text": "Not feeling rushed" }, + { "id": "phones_away", "text": "Putting phones away" }, + { "id": "good_food", "text": "Good food" }, + { "id": "easy_conversation", "text": "Easy conversation" }, + { "id": "physical_affection", "text": "Physical affection" }, + { "id": "clear_plan", "text": "Having a plan" } + ] +} +``` + +Rules: + +```bat +ECHO Multi-choice prompts should say or imply that multiple answers are okay. +ECHO Options should not shame either partner. +ECHO Include practical and emotional options when possible. +``` + +--- + +## scale + +Use for comfort level, closeness, energy, readiness, satisfaction, or frequency. + +Good scale example: + +```json +{ + "type": "scale", + "text": "How much do you feel like we need a real date soon?", + "scale": { + "min": 1, + "max": 5, + "min_label": "Not much", + "max_label": "Very much" + } +} +``` + +Rules: + +```bat +ECHO Scale labels should be gentle and neutral. +ECHO Do not make the low end sound bad or shameful. +ECHO Scale questions should measure one thing only. +``` + +Bad: + +```text +How badly are we failing at making time for each other? +``` + +Better: + +```text +How much would some intentional time together help us right now? +``` + +--- + +## this_or_that + +Use for fast, playful, low-pressure choices. + +Good this-or-that examples: + +```text +Planned date or spontaneous date? +Dress up or stay cozy? +Cook together or order in? +Sunset walk or late-night drive? +``` + +Rules: + +```bat +ECHO This-or-that prompts should be quick. +ECHO Avoid choices that imply one partner is wrong. +ECHO Best used in fun, date, intimacy, home, and lifestyle packs. +``` + +--- + +# 7. Free vs Premium Strategy + +Free questions should prove the app is worth using. + +Premium questions should feel deeper, more specific, more personalized, more playful, or more valuable. + +## Free questions should be: + +```bat +ECHO Easy to answer. +ECHO Warm and useful. +ECHO Good enough to create trust. +ECHO Low-pressure. +ECHO Representative of the pack. +``` + +## Premium questions should be: + +```bat +ECHO More specific. +ECHO More thoughtful. +ECHO More emotionally useful. +ECHO More creative. +ECHO More likely to start a meaningful conversation. +``` + +Premium must not be only “more of the same.” + +Bad premium strategy: + +```text +Free: What date sounds fun? +Premium: What date sounds really fun? +``` + +Better premium strategy: + +```text +Free: What is a simple date we could do this week? +Premium: What kind of date would make you feel pursued, not just scheduled? +``` + +--- + +# 8. Banned or Overused Phrases + +Avoid these unless there is a very good reason. + +```text +What boundary around... +hold space +emotional container +relationship dynamic +intentional intimacy +deepen our connection +in this season +needs met +love language +safe space +show up for you +lean into +create space for +feel seen and heard +navigate conflict +honor your needs +``` + +These phrases are not always wrong, but they quickly make the app sound generic or clinical. + +Use natural language instead. + +Instead of: + +```text +How can I hold space for your needs? +``` + +Use: + +```text +When you are having a hard day, what helps you feel supported by me? +``` + +Instead of: + +```text +How can we deepen intentional intimacy? +``` + +Use: + +```text +What is one small thing that makes you want to be closer to me? +``` + +--- + +# 9. Tone Rules by Pack Type + +## Fun packs + +Should feel light, playful, and easy. + +Use: + +```text +What is a tiny adventure we could do without spending much? +What inside joke of ours still makes you laugh? +What would make an ordinary night feel more fun? +``` + +Avoid: + +```text +How can we optimize shared leisure experiences? +``` + +--- + +## Date Night packs + +Should feel romantic, playful, practical, and low-pressure. + +Use: + +```text +What kind of date would feel easy but still special? +What would make you feel like I planned the night with you in mind? +What is one date we keep talking about but never actually do? +``` + +Avoid: + +```text +What date structure would best support our connection goals? +``` + +--- + +## Boundaries packs + +Should feel respectful, calm, and non-accusing. + +Use: + +```text +What is one thing you wish we handled more gently? +When you need alone time, what helps you feel understood instead of distant? +What is a small boundary that would make our home feel calmer? +``` + +Avoid: + +```text +What boundary around boundaries would support emotional safety? +``` + +--- + +## Conflict packs + +Should feel safe, repair-focused, and not blaming. + +Use: + +```text +When we disagree, what helps you stay open instead of shutting down? +What is one thing I can do during an argument that would help us slow down? +What helps you feel like we are on the same team again? +``` + +Avoid: + +```text +What do I always do wrong during conflict? +``` + +--- + +## Trust packs + +Should feel careful, honest, and non-punishing. + +Use: + +```text +What small action helps you trust me more? +What makes an apology feel real to you? +What helps you feel reassured without feeling like you had to ask too much? +``` + +Avoid: + +```text +What have I done to make you unable to trust me? +``` + +--- + +## Sex, desire, and physical intimacy packs + +Should feel adult, consent-based, respectful, optional, and never pushy. + +Use: + +```text +What kind of affection helps you feel wanted without feeling pressured? +What helps you feel comfortable talking about desire with me? +What is one way I can make physical closeness feel safer and more relaxed? +``` + +Avoid: + +```text +What should I do to make sure you give me more sex? +What fantasy do you have to tell me tonight? +Why do you not want me more? +``` + +Sensitive packs should include: + +```bat +ECHO Consent-first wording. +ECHO No pressure. +ECHO No shame. +ECHO No assumptions about gender roles. +ECHO No assumptions about sex drive. +ECHO No coercive language. +ECHO No questions that pressure disclosure of trauma. +``` + +--- + +# 10. Safety Rules + +Closer is not therapy, counseling, crisis support, or medical advice. + +Questions must not: + +```bat +ECHO Encourage staying in unsafe relationships. +ECHO Pressure forgiveness. +ECHO Minimize abuse. +ECHO Encourage sexual pressure. +ECHO Ask users to disclose trauma before they are ready. +ECHO Diagnose a partner. +ECHO Tell a partner what they owe. +ECHO Encourage monitoring, control, or isolation. +``` + +## Abuse-sensitive rule + +Avoid questions that frame controlling behavior as a normal boundary. + +Bad: + +```text +What rule should we have about who your partner can talk to? +``` + +Better: + +```text +What helps you feel secure in our relationship while still respecting each other's independence? +``` + +## Consent rule + +Bad: + +```text +How can I get you to be more physically affectionate? +``` + +Better: + +```text +What kind of affection feels good to you when you are open to closeness? +``` + +--- + +# 11. Wording Rules + +## Keep questions short + +Aim for 8 to 22 words when possible. + +Long questions are okay only when the topic needs softness or context. + +## Ask one thing at a time + +Bad: + +```text +What boundary do you need around family, money, friends, work, and rest so you feel loved and respected? +``` + +Better: + +```text +What family boundary would make our relationship feel more protected? +``` + +## Avoid stacked emotional words + +Bad: + +```text +What would help you feel safe, seen, valued, loved, respected, and emotionally connected? +``` + +Better: + +```text +What helps you feel respected by me? +``` + +## Avoid vague “more” questions + +Bad: + +```text +How can we be more connected? +``` + +Better: + +```text +What is one thing we could do tonight to feel closer? +``` + +## Avoid blame + +Bad: + +```text +What do I do that makes date night feel bad? +``` + +Better: + +```text +What tends to make date night harder for you to enjoy? +``` + +--- + +# 12. JSON Quality Rules + +Every JSON file should pass these checks. + +```bat +ECHO [ ] Valid JSON. +ECHO [ ] Category id matches file purpose. +ECHO [ ] Category title sounds user-facing. +ECHO [ ] Category access matches actual free/premium strategy. +ECHO [ ] Metadata counts match actual question counts. +ECHO [ ] All question IDs are unique. +ECHO [ ] All question texts are unique. +ECHO [ ] No near-duplicate blocks. +ECHO [ ] Type counts match metadata. +ECHO [ ] Free/premium counts match metadata. +ECHO [ ] Depth values are valid. +ECHO [ ] Access values are valid. +ECHO [ ] Options have unique IDs inside each question. +ECHO [ ] Option IDs are neutral and clean. +ECHO [ ] Scale labels are present when needed. +ECHO [ ] No malformed keys like m a x _ l e n g t h. +ECHO [ ] No placeholder text. +ECHO [ ] No accidental old gendered IDs unless intentionally used. +``` + +Recommended access values: + +```text +free +premium +``` + +Recommended category access values: + +```text +free +premium +mixed +``` + +Recommended depth values: + +```text +light +medium +deep +``` + +Recommended question types: + +```text +written +single_choice +multi_choice +scale +this_or_that +``` + +--- + +# 13. Pack Structure Recommendation + +For a 250-question pack: + +```bat +SET TOTAL_QUESTIONS=250 +SET FREE_QUESTIONS=75 +SET PREMIUM_QUESTIONS=175 +SET WRITTEN=150 +SET SINGLE_CHOICE=40 +SET MULTI_CHOICE=20 +SET SCALE=25 +SET THIS_OR_THAT=15 +``` + +This structure is acceptable if the current app expects those counts. + +But quality matters more than exact counts. If a pack cannot support 250 good questions without filler, reduce the pack or split it. + +--- + +# 14. Content Batching Process + +Do not write all 250 questions in one creative pass. + +Use this process: + +```bat +ECHO Step 1: Define pack purpose. +ECHO Step 2: Define subtopics. +ECHO Step 3: Write 40-50 high-quality questions. +ECHO Step 4: Review tone and repetition. +ECHO Step 5: Write the next batch. +ECHO Step 6: Add choice, scale, and this-or-that questions. +ECHO Step 7: Assign free/premium. +ECHO Step 8: Assign depth. +ECHO Step 9: Validate JSON. +ECHO Step 10: Read the full file like a user. +``` + +--- + +# 15. Subtopic Planning + +Each pack should have subtopics to prevent repetition. + +Example for Date Night: + +```text +easy dates +low-cost dates +at-home dates +going out +planning preferences +romance style +fun and play +food and drinks +music and movies +seasonal dates +surprises +feeling wanted +getting out of a rut +after-kids / busy life +date-night stress +memories +future date dreams +``` + +Example for Boundaries: + +```text +alone time +phone privacy +social media +family involvement +friendships +money +work time +rest +chores +home space +conflict +tone of voice +physical affection +private conversations +parenting/family roles +emotional bandwidth +plans and scheduling +personal belongings +sleep +stress +``` + +--- + +# 16. Repetition Check + +A pack fails if it has blocks like this: + +```text +What boundary around alone time would help you feel respected? +What boundary around phone privacy would help you feel respected? +What boundary around family involvement would help you feel respected? +What boundary around friendships would help you feel respected? +``` + +Instead, each question should have its own angle. + +Better: + +```text +When you need alone time, how should I respond so it does not feel personal? +What phone privacy boundary would help us feel trusted instead of watched? +How involved should family be in decisions that affect just the two of us? +What helps friendships feel healthy without making our relationship feel pushed aside? +``` + +--- + +# 17. Human Read-Aloud Test + +Before finalizing, read 25 random questions out loud. + +Reject questions that: + +```bat +ECHO Sound stiff. +ECHO Sound embarrassing for the wrong reason. +ECHO Sound like a therapy script. +ECHO Sound too much like another question. +ECHO Take too long to understand. +ECHO Would make a normal couple roll their eyes. +``` + +--- + +# 18. Claude Instructions for Rewriting JSON Packs + +When Claude rewrites a pack: + +```bat +ECHO Read the existing JSON first. +ECHO Preserve required schema unless told otherwise. +ECHO Preserve required counts unless told otherwise. +ECHO Improve wording, variety, and product feel. +ECHO Do not create repetitive template blocks. +ECHO Do not use weird phrasing. +ECHO Do not overuse therapy language. +ECHO Do not make sensitive prompts coercive. +ECHO Validate the final JSON. +ECHO Report count totals. +ECHO Report any schema changes. +``` + +Claude should not say a file is done unless: + +```bat +ECHO The JSON parses. +ECHO The counts match. +ECHO IDs are unique. +ECHO Question texts are unique. +ECHO Free/premium counts match. +ECHO Type counts match. +ECHO The tone guide was followed. +``` + +--- + +# 19. Good Question Examples by Category + +## Date Night + +```text +What is a date we could plan this month that would feel easy but special? +What makes you feel like I really wanted time with you? +What kind of date helps you relax the fastest? +What is one date we should bring back? +What would make a regular night feel romantic? +``` + +## Boundaries + +```text +When you need space, what helps you feel understood instead of distant? +What is one small boundary that would make our home feel calmer? +What topic do you wish we handled more gently? +What helps you feel trusted instead of checked up on? +What is one way we can protect our time together from outside stress? +``` + +## Communication + +```text +What helps you open up when something is bothering you? +When do you feel easiest to talk to me? +What is one thing I could say more often? +What makes a hard conversation feel safer? +What helps you know I am really listening? +``` + +## Fun + +```text +What is something silly we should do together soon? +What little adventure would make this week better? +What is an inside joke of ours that you still love? +What would make tonight feel less boring? +What is something we should try just because it sounds fun? +``` + +## Trust + +```text +What small action helps you trust me more? +What makes an apology feel real to you? +What helps you feel reassured without having to ask twice? +What is one promise that matters a lot to you? +What helps us feel like we are on the same team? +``` + +## Physical Intimacy + +```text +What kind of affection helps you feel closest to me? +When do you feel most comfortable being physically close? +What helps touch feel relaxed instead of expected? +What small affectionate habit would you like more of? +What makes cuddling or closeness feel safe and easy? +``` + +--- + +# 20. Final Standard + +A finished Closer question pack should feel: + +```text +Human. +Warm. +Private. +Clear. +Useful. +Specific. +Respectful. +Worth paying for. +``` + +If a question does not help a couple feel closer, understand each other, laugh together, plan something, repair something, or feel safer with each other, it probably does not belong in Closer.