nWave-ai/nWave / nWave/skills/nw-jtbd-core
nw-jtbd-core
VerifiedLoad when turning a request into promises, job stories or scenario titles.
Promises from a request
A promise is one outcome the request asks for: what an actor can do or see. Tests, slices and the closing statement all use these promises.
1. Decide before writing
- Split the request into sentences. Mark each as an outcome, a reason or a constraint.
- Write one promise per outcome sentence, in the request's own meaning. Add no input class, surface, failure mode or quality it does not state; drop none it states.
- Map every request sentence to a promise or to a stated reason, and every promise back to a request sentence. A sentence with neither is a defect: fix it now.
- Name the actor and the observable result in the actor's words: "Customer sees the order confirmed with an order number". Name no class, function, file, table or internal task.
- Use job-story form when the situation matters:
When <situation>, I want to <capability>, so I can <outcome>. Fill situation and outcome from the request; no UI element or technology. - Write a benefit, motivation or emotion only when the request or the human supplied it; else leave it out, write
Proposal: ..., or for emotion "not supplied". - Keep a stated behaviour as stated. Lifecycle, failure or recovery ideas the request does not call for go under "Suggestions" in the closing statement, never in a promise or the diff.
- Leave delivered behaviour as it is: no re-slice, rewrite or re-promise unless the request asks.
- Mark an unconfirmed assumption
Open assumption. It never appears as a requirement in a promise, an assertion or the closing statement. - Call an example "supplied" or "observed" only when its concrete stimulus and outcome were supplied or observed; else label it
Proposal.
2. Write the scenario
Promise, then acceptance condition, then scenario (Given context, one When action, Then observable outcome). Use the request's concrete values ($100.00, 'Electronics'); when none was supplied, label your value Proposal.
Title the scenario by what the user achieves. Rewrite any title holding a class, method, file or protocol term:
| Wrong | Right |
|---|---|
| FileWatcher triggers TreeView refresh | Dashboard updates in real time |
| Validator accepts JSON | Customer's valid order is accepted |
3. Closing statement
Lead with delivered behaviour, then gaps, then suggestions. State each promise in the user's words as what the user can now do or see; none names only a mechanism. Claim no motivation the request did not supply. Never say every outcome is covered while a request sentence has neither a test nor a stated gap.
4. Self-check
- Each request outcome sentence has one promise; each reason sentence is kept as a reason; nothing added or dropped.
- Each promise has an actor and an observable result in the actor's words.
- No unsupplied benefit or emotion, or it is marked Proposal.
- No scenario title with a class, method, file or protocol term.
- No open assumption written as a requirement; no proposed example presented as supplied.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |