null
/
Closer
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

remove

This commit is contained in:
null 2026-06-21 19:45:55 -05:00
parent 54fdaf831f
commit 51702e910b
1 changed files with 998 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

998
seed/questions/QUESTION_CONTENT_GUIDE.md Normal file
View File

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