@somacheck/vibecheck 0.6.12 → 0.6.14
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +73 -41
- package/SKILL.md +11 -7
- package/dist/claude-plugin-setup.js +183 -78
- package/dist/cli.js +63 -20
- package/dist/client-setup.js +38 -22
- package/dist/constants.js +1 -1
- package/dist/readiness.js +36 -31
- package/dist/recipes.js +7 -7
- package/dist/server.js +65 -17
- package/package.json +3 -4
- package/recipes/chattermill-research-reflection.md +11 -10
- package/recipes/dovetail-research-reflection.md +2 -2
- package/recipes/great-question-research-reflection.md +5 -4
- package/recipes/maze-research-reflection.md +9 -9
- package/recipes/prolific-research-reflection.md +2 -2
- package/recipes/questionpro-research-reflection.md +6 -3
- package/recipes/typeform-research-reflection.md +3 -3
- package/recipes/user-interviews-research-reflection.md +9 -7
- package/claude-marketplace/.claude-plugin/marketplace.json +0 -22
- package/claude-marketplace/plugins/vibecheck/.claude-plugin/plugin.json +0 -13
- package/claude-marketplace/plugins/vibecheck/hooks/hooks.json +0 -18
|
@@ -115,7 +115,7 @@ makes the reading an automatic write condition.
|
|
|
115
115
|
`pending`, is `expired` or `cancelled`, or errors, continue without a result;
|
|
116
116
|
do not infer one or start another request.
|
|
117
117
|
8. **Return authority.** Offer the options to revise, investigate, proceed,
|
|
118
|
-
pause, or leave the artifact unchanged.
|
|
118
|
+
pause, or leave the artifact unchanged. An explicit researcher choice overrides
|
|
119
119
|
the signal.
|
|
120
120
|
9. **Keep the signal private.** Do not write the verdict, confidence, gesture,
|
|
121
121
|
or confirmation to Dovetail. If the researcher asks to record a next step,
|
|
@@ -153,7 +153,7 @@ Do not trigger when:
|
|
|
153
153
|
- the task is ordinary Dovetail retrieval, summarization, tagging, or export;
|
|
154
154
|
- the proposed subject is anyone other than the researcher;
|
|
155
155
|
- the source contains raw or identifiable participant material;
|
|
156
|
-
- the researcher has already made a clear
|
|
156
|
+
- the researcher has already made a clear choice;
|
|
157
157
|
- the result would determine inclusion, quality, compensation, performance, or
|
|
158
158
|
another consequential outcome; or
|
|
159
159
|
- a vibecheck was already used for the same decision.
|
|
@@ -48,7 +48,8 @@ neutral study framings and show their exact questions. Then offer one short
|
|
|
48
48
|
first-person proposition about my own preferred framing and wait for my
|
|
49
49
|
acceptance before any proactive SomaCheck ask. Give the agent the Aligned or
|
|
50
50
|
Unaligned result plus confidence as context and let it use that context with
|
|
51
|
-
its judgment. Ask what I choose
|
|
51
|
+
its judgment. Ask what I choose and accept any explicit response available in
|
|
52
|
+
this interface. Keep the proposition, reading,
|
|
52
53
|
confidence, and my confirmation out of Great Question. Return a signal-free,
|
|
53
54
|
copy-ready research plan only. Do not create, update, delete, recruit, invite,
|
|
54
55
|
message, schedule, incentivize, launch, publish, or otherwise write to Great
|
|
@@ -119,8 +120,8 @@ owner-supplied artifact.
|
|
|
119
120
|
or Unaligned reading, and confidence. Let it combine that context with the
|
|
120
121
|
conversation and its judgment. Keep observation, interpretation,
|
|
121
122
|
confirmation, and choice distinct.
|
|
122
|
-
9. **Ask the researcher to
|
|
123
|
-
follows and may differ from the signal.
|
|
123
|
+
9. **Return authority.** Ask the researcher to indicate their choice explicitly.
|
|
124
|
+
Their choice controls what follows and may differ from the signal.
|
|
124
125
|
10. **Return a copy-ready plan.** Include only a test title, goal/purpose,
|
|
125
126
|
language, and the five questions. Do not attach an incentive, consent form,
|
|
126
127
|
screener, candidates, recruitment settings, or send settings.
|
|
@@ -169,7 +170,7 @@ The end-to-end test passes only when:
|
|
|
169
170
|
- **SomaCheck unresolved:** Use the same handle once later, then proceed without
|
|
170
171
|
a reading if unresolved.
|
|
171
172
|
- **Unreadable capture:** Offer a retry only if the researcher wants it.
|
|
172
|
-
- **The researcher's
|
|
173
|
+
- **The researcher's choice differs from the reading:** Follow their explicit choice
|
|
173
174
|
without reconciliation or repetition.
|
|
174
175
|
|
|
175
176
|
## Privacy boundary
|
|
@@ -73,7 +73,7 @@ summary (mission completion rates, time on task, success-rate aggregate,
|
|
|
73
73
|
summary counts). It does not open transcripts, response rows, participant
|
|
74
74
|
identifiers, recordings, or free-text fields. The agent offers two defensible
|
|
75
75
|
interpretation framings and one short first-person proposition about the
|
|
76
|
-
researcher's own interpretation plan. After the researcher
|
|
76
|
+
researcher's own interpretation plan. After the researcher explicitly indicates a choice,
|
|
77
77
|
the agent stops. There is no Maze write.
|
|
78
78
|
|
|
79
79
|
## Starter prompt
|
|
@@ -94,7 +94,8 @@ defensible interpretation framings. Then offer one short first-person
|
|
|
94
94
|
proposition about my own interpretation plan and wait for my acceptance
|
|
95
95
|
before any proactive SomaCheck ask. Treat Aligned or Unaligned plus
|
|
96
96
|
confidence as context, not truth, diagnosis, authorization, or evidence
|
|
97
|
-
about a Maze participant. Ask what I choose
|
|
97
|
+
about a Maze participant. Ask what I choose and accept any explicit response
|
|
98
|
+
available in this interface. Keep the
|
|
98
99
|
proposition, reading, confidence, and my confirmation out of Maze. Do
|
|
99
100
|
not create, edit, publish, delete, archive, export, share, tag, comment,
|
|
100
101
|
or write to Maze, a hidden field, a webhook, or any analytics record.
|
|
@@ -192,8 +193,8 @@ read, label the Maze half untested and stop.
|
|
|
192
193
|
decides). `unaligned` may indicate possible inner conflict relative
|
|
193
194
|
to the proposition; it does not name a cause, choose an interpretation,
|
|
194
195
|
or justify a research claim.
|
|
195
|
-
11. **
|
|
196
|
-
want a third option, or whether they want to stop. Follow their
|
|
196
|
+
11. **Return authority.** Ask the researcher which framing they choose, whether they
|
|
197
|
+
want a third option, or whether they want to stop. Follow their explicit
|
|
197
198
|
choice.
|
|
198
199
|
12. **Keep the signal out of Maze.** Do not call any Maze write, mutation,
|
|
199
200
|
export, webhook, comment, tag, highlight, insight, analytics, or
|
|
@@ -241,8 +242,8 @@ The test passes when:
|
|
|
241
242
|
theme, highlight, insight, automation, or write tool;
|
|
242
243
|
- the researcher receives at most one optional SomaCheck check-in on their phone
|
|
243
244
|
on an exact first-person proposition about their own interpretation plan;
|
|
244
|
-
- the agent presents the result as context, asks the researcher to
|
|
245
|
-
choice
|
|
245
|
+
- the agent presents the result as context, asks the researcher to indicate
|
|
246
|
+
their choice explicitly, and follows that choice;
|
|
246
247
|
- the agent makes no Maze write, mutation, export, share, tag,
|
|
247
248
|
comment, or analytics call; and
|
|
248
249
|
- no Maze participant, respondent, or employee data enters the
|
|
@@ -271,7 +272,7 @@ The test passes when:
|
|
|
271
272
|
later, then proceed without a reading if still unresolved.
|
|
272
273
|
- **Unreadable capture:** Offer a retry only if the researcher wants it;
|
|
273
274
|
unreadable is not a third interpretation.
|
|
274
|
-
- **Researcher disagrees with the reading:** Follow the researcher's
|
|
275
|
+
- **Researcher disagrees with the reading:** Follow the researcher's explicit choice
|
|
275
276
|
without reconciliation or repetition.
|
|
276
277
|
|
|
277
278
|
## Privacy boundary
|
|
@@ -308,8 +309,7 @@ The test passes when:
|
|
|
308
309
|
- [ ] At most one SomaCheck request is created for the choice.
|
|
309
310
|
- [ ] Observation, interpretation, confirmation, and choice remain
|
|
310
311
|
separate.
|
|
311
|
-
- [ ] The researcher
|
|
312
|
-
choice.
|
|
312
|
+
- [ ] The researcher explicitly indicates a choice and the agent follows it.
|
|
313
313
|
- [ ] The agent makes no Maze mutation, write, export, share, tag,
|
|
314
314
|
comment, or analytics call.
|
|
315
315
|
- [ ] No Maze participant, respondent, or employee data enters the
|
|
@@ -124,7 +124,7 @@ automatic decision gate.
|
|
|
124
124
|
proceed to separate review, pause, or leave unchanged. Do not call
|
|
125
125
|
`create_filter_set`, `create_study`, or `publish_study`. If the researcher
|
|
126
126
|
chooses a change, produce a reviewable draft outside Prolific; platform
|
|
127
|
-
mutation is a new action requiring explicit instruction.
|
|
127
|
+
mutation is a new action requiring explicit instruction. An explicit researcher
|
|
128
128
|
choice overrides the signal.
|
|
129
129
|
10. **Keep the signal private.** Do not write the verdict, confidence, gesture,
|
|
130
130
|
confirmation, or inferred meaning to Prolific or another research platform.
|
|
@@ -161,7 +161,7 @@ Do not trigger when:
|
|
|
161
161
|
- the proposed subject is a participant, employee, cohort, or respondent;
|
|
162
162
|
- the result would affect eligibility, filtering, payment, bonus, rejection,
|
|
163
163
|
submission quality, authenticity, or performance;
|
|
164
|
-
- the researcher has already made a clear
|
|
164
|
+
- the researcher has already made a clear choice;
|
|
165
165
|
- the agent is being asked to publish, gate, or automate a launch; or
|
|
166
166
|
- a vibecheck was already used for the same decision.
|
|
167
167
|
|
|
@@ -26,7 +26,8 @@ about a respondent, or a research decision. The researcher remains the authority
|
|
|
26
26
|
|
|
27
27
|
The researcher supplies a participant-free survey goal. The agent drafts two
|
|
28
28
|
four-question versions and may offer one SomaCheck check-in on the researcher's
|
|
29
|
-
own preferred direction. The researcher then
|
|
29
|
+
own preferred direction. The researcher then explicitly indicates a choice.
|
|
30
|
+
The output is a
|
|
30
31
|
signal-free survey definition for a QuestionPro owner to review. This recipe
|
|
31
32
|
does not create, publish, distribute, or populate a survey.
|
|
32
33
|
|
|
@@ -43,7 +44,8 @@ upgrade, buy a plan, administer access, or populate QuestionPro data. Propose tw
|
|
|
43
44
|
questionnaire framings and show the exact questions. Then offer one short
|
|
44
45
|
first-person proposition about my own preferred direction and wait for my
|
|
45
46
|
acceptance before any proactive SomaCheck ask. Give the result and confidence to
|
|
46
|
-
the agent as context and let it use its judgment. Ask what I choose
|
|
47
|
+
the agent as context and let it use its judgment. Ask what I choose and accept
|
|
48
|
+
any explicit response available in this interface.
|
|
47
49
|
Keep the proposition, reading, confidence, and confirmation out of QuestionPro.
|
|
48
50
|
Return a copy-ready, signal-free survey definition only. Do not create, edit,
|
|
49
51
|
send, distribute, publish, recruit, launch, access responses, or spend anything.
|
|
@@ -77,7 +79,8 @@ send, distribute, publish, recruit, launch, access responses, or spend anything.
|
|
|
77
79
|
6. Give the proposition, Aligned or Unaligned result, and confidence to the
|
|
78
80
|
agent. Let the agent use its judgment in context without treating the result
|
|
79
81
|
as authorization or a claim about respondents.
|
|
80
|
-
7. Ask
|
|
82
|
+
7. Ask the researcher to indicate their choice explicitly. Their choice controls
|
|
83
|
+
the plan.
|
|
81
84
|
8. Return a copy-ready payload with title, purpose, questions, answer choices,
|
|
82
85
|
and optional logic. Exclude all SomaCheck data and platform identifiers.
|
|
83
86
|
9. Stop before any QuestionPro data or action call. A partner owner may review
|
|
@@ -115,8 +115,8 @@ Typeform write or launch condition.
|
|
|
115
115
|
`pending`, is `expired` or `cancelled`, or errors, continue without a result;
|
|
116
116
|
do not infer one or start another request.
|
|
117
117
|
8. **Return authority.** Offer revise, split a question, soften leading
|
|
118
|
-
wording, add an answer option, pilot, proceed, pause, or leave unchanged.
|
|
119
|
-
|
|
118
|
+
wording, add an answer option, pilot, proceed, pause, or leave unchanged. An
|
|
119
|
+
explicit researcher choice overrides the signal.
|
|
120
120
|
9. **Keep the signal private.** Do not write the verdict, confidence, gesture,
|
|
121
121
|
or confirmation to Typeform. If the researcher asks for a Typeform edit,
|
|
122
122
|
show the exact signal-free edit first and call the Typeform write tool only
|
|
@@ -159,7 +159,7 @@ Do not trigger when:
|
|
|
159
159
|
free-text answers;
|
|
160
160
|
- the result would affect eligibility, payment, employment, grading, access,
|
|
161
161
|
support priority, response quality, or survey validity;
|
|
162
|
-
- the researcher has already made a clear
|
|
162
|
+
- the researcher has already made a clear choice;
|
|
163
163
|
- the researcher has declined a recent offer or opted out; or
|
|
164
164
|
- a vibecheck was already used for the same decision.
|
|
165
165
|
|
|
@@ -57,7 +57,8 @@ gates.
|
|
|
57
57
|
|
|
58
58
|
The researcher gives the agent a participant-free study idea. The agent drafts
|
|
59
59
|
two neutral framings, offers one first-person SomaCheck check-in about the
|
|
60
|
-
researcher's own direction, and
|
|
60
|
+
researcher's own direction, and accepts any explicit response available in the
|
|
61
|
+
interface. The agent
|
|
61
62
|
returns a complete copy-ready payload and stops. User Interviews remains
|
|
62
63
|
unchanged. Any later draft creation is a separate future recipe and review, not
|
|
63
64
|
an optional branch of this one.
|
|
@@ -79,7 +80,8 @@ Propose two neutral study framings and show the exact
|
|
|
79
80
|
signal-free project copy. Then offer one short first-person proposition about
|
|
80
81
|
my own preferred direction and ask for one SomaCheck check-in on that exact
|
|
81
82
|
wording. Keep the proposition, reading, confidence, and my confirmation out of
|
|
82
|
-
User Interviews. Afterward ask what I choose
|
|
83
|
+
User Interviews. Afterward ask what I choose and accept any explicit response
|
|
84
|
+
available in this interface. Return the complete
|
|
83
85
|
signal-free, copy-ready project payload only. Do not create, edit, recruit,
|
|
84
86
|
invite, message, schedule, screen, launch, publish, attach incentives, spend,
|
|
85
87
|
read participant data, or call a broader or undocumented tool.
|
|
@@ -152,14 +154,14 @@ tools, stop without calling it.
|
|
|
152
154
|
8. **Return authority.** Separate observation, interpretation (`aligned` or
|
|
153
155
|
`unaligned` plus confidence), confirmation, and choice. `unaligned` may
|
|
154
156
|
indicate possible inner conflict relative to the proposition; it does not
|
|
155
|
-
identify a cause or select a study design. The researcher's
|
|
157
|
+
identify a cause or select a study design. The researcher's explicit choice
|
|
156
158
|
controls.
|
|
157
159
|
9. **Prepare the exact payload.** Show title, purpose, study type, questions or
|
|
158
160
|
tasks, and any required non-contact fields. Exclude the proposition, result,
|
|
159
161
|
confidence, confirmation, SomaCheck wording, participant metadata, and
|
|
160
162
|
hidden fields.
|
|
161
163
|
10. **Stop before every platform call.** The SomaCheck reading and the
|
|
162
|
-
researcher's
|
|
164
|
+
researcher's explicit choice are not approval to use User Interviews. Do not
|
|
163
165
|
call create, update,
|
|
164
166
|
read-back, recruitment, messaging, scheduling, participant, incentive,
|
|
165
167
|
launch, publish, or data tools.
|
|
@@ -188,8 +190,8 @@ Not allowed:
|
|
|
188
190
|
The test passes when:
|
|
189
191
|
|
|
190
192
|
- the researcher receives at most one live SomaCheck request on their phone;
|
|
191
|
-
- the agent presents the result as context and asks the researcher
|
|
192
|
-
|
|
193
|
+
- the agent presents the result as context and asks the researcher to indicate
|
|
194
|
+
their choice explicitly;
|
|
193
195
|
- the agent returns the exact signal-free, copy-ready project payload;
|
|
194
196
|
- no User Interviews data or action tool is invoked and the workspace remains
|
|
195
197
|
unchanged; and
|
|
@@ -212,7 +214,7 @@ The test passes when:
|
|
|
212
214
|
proceed without a reading if unresolved.
|
|
213
215
|
- **Unreadable capture:** Offer a retry only if the researcher wants it;
|
|
214
216
|
unreadable is not a third interpretation.
|
|
215
|
-
- **Researcher disagrees with the reading:** Follow the researcher's
|
|
217
|
+
- **Researcher disagrees with the reading:** Follow the researcher's explicit
|
|
216
218
|
choice without reconciliation or repetition.
|
|
217
219
|
|
|
218
220
|
## Privacy boundary
|
|
@@ -1,22 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"name": "somacheck-local",
|
|
3
|
-
"owner": {
|
|
4
|
-
"name": "Sensie",
|
|
5
|
-
"email": "agents@joinsensie.com"
|
|
6
|
-
},
|
|
7
|
-
"description": "SomaCheck integration installed by the official vibecheck package.",
|
|
8
|
-
"plugins": [
|
|
9
|
-
{
|
|
10
|
-
"name": "vibecheck",
|
|
11
|
-
"source": "./plugins/vibecheck",
|
|
12
|
-
"description": "Let Claude offer a vibecheck and continue when the phone result arrives.",
|
|
13
|
-
"version": "0.6.12",
|
|
14
|
-
"author": {
|
|
15
|
-
"name": "Sensie",
|
|
16
|
-
"email": "agents@joinsensie.com"
|
|
17
|
-
},
|
|
18
|
-
"category": "productivity",
|
|
19
|
-
"tags": ["vibecheck", "somacheck", "decision-support", "mcp"]
|
|
20
|
-
}
|
|
21
|
-
]
|
|
22
|
-
}
|
|
@@ -1,13 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"name": "vibecheck",
|
|
3
|
-
"description": "Let Claude offer a SomaCheck vibecheck and continue when the phone result arrives.",
|
|
4
|
-
"version": "0.6.12",
|
|
5
|
-
"author": {
|
|
6
|
-
"name": "Sensie",
|
|
7
|
-
"email": "agents@joinsensie.com"
|
|
8
|
-
},
|
|
9
|
-
"homepage": "https://github.com/Sensie-agents/vibecheck",
|
|
10
|
-
"repository": "https://github.com/Sensie-agents/vibecheck",
|
|
11
|
-
"license": "MIT",
|
|
12
|
-
"keywords": ["vibecheck", "somacheck", "decision-support", "mcp"]
|
|
13
|
-
}
|
|
@@ -1,18 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"description": "Continue an ordinary Claude Code session when a SomaCheck result arrives.",
|
|
3
|
-
"hooks": {
|
|
4
|
-
"PostToolUse": [
|
|
5
|
-
{
|
|
6
|
-
"matcher": "mcp__vibecheck__request_vibecheck",
|
|
7
|
-
"hooks": [
|
|
8
|
-
{
|
|
9
|
-
"type": "command",
|
|
10
|
-
"command": "npx -y @somacheck/vibecheck@0.6.12 claude-hook await-result",
|
|
11
|
-
"asyncRewake": true,
|
|
12
|
-
"timeout": 900
|
|
13
|
-
}
|
|
14
|
-
]
|
|
15
|
-
}
|
|
16
|
-
]
|
|
17
|
-
}
|
|
18
|
-
}
|