skills I believed were committed
This commit is contained in:
+21
-21
@@ -1,6 +1,6 @@
|
||||
---
|
||||
name: elicit
|
||||
description: "Run a structured discovery session to build an Allium specification through conversation. Use when the user wants to create a new spec from scratch, elicit or gather requirements, capture domain behaviour, specify a feature or system, define what a system should do, or is describing functionality and needs help shaping it into a specification."
|
||||
description: 'Run a structured discovery session to build an Allium specification through conversation. Use when the user wants to create a new spec from scratch, elicit or gather requirements, capture domain behaviour, specify a feature or system, define what a system should do, or is describing functionality and needs help shaping it into a specification.'
|
||||
disable-model-invocation: true
|
||||
license: MIT
|
||||
metadata:
|
||||
@@ -53,14 +53,14 @@ The hardest part of specification is choosing what to include and what to leave
|
||||
|
||||
For every detail, ask: "Why does the stakeholder care about this?"
|
||||
|
||||
| Detail | Why? | Include? |
|
||||
|--------|------|----------|
|
||||
| "Users log in with Google OAuth" | They need to authenticate | Maybe not, "Users authenticate" might be sufficient |
|
||||
| "We support Google and Microsoft OAuth" | Users choose their provider | Yes, the choice is domain-level |
|
||||
| "Sessions expire after 24 hours" | Security/UX decision | Yes, affects user experience |
|
||||
| "Sessions are stored in Redis" | Performance | No, implementation detail |
|
||||
| "Passwords must be 12+ characters" | Security policy | Yes, affects users |
|
||||
| "Passwords are hashed with bcrypt" | Security implementation | No, how not what |
|
||||
| Detail | Why? | Include? |
|
||||
| --------------------------------------- | --------------------------- | --------------------------------------------------- |
|
||||
| "Users log in with Google OAuth" | They need to authenticate | Maybe not, "Users authenticate" might be sufficient |
|
||||
| "We support Google and Microsoft OAuth" | Users choose their provider | Yes, the choice is domain-level |
|
||||
| "Sessions expire after 24 hours" | Security/UX decision | Yes, affects user experience |
|
||||
| "Sessions are stored in Redis" | Performance | No, implementation detail |
|
||||
| "Passwords must be 12+ characters" | Security policy | Yes, affects users |
|
||||
| "Passwords are hashed with bcrypt" | Security implementation | No, how not what |
|
||||
|
||||
### The "Could it be different?" test
|
||||
|
||||
@@ -80,12 +80,12 @@ Examples:
|
||||
|
||||
Is this a category of thing, or a specific instance?
|
||||
|
||||
| Instance (implementation) | Template (domain-level) |
|
||||
|---------------------------|-------------------------|
|
||||
| Google OAuth | Authentication provider |
|
||||
| Slack | Notification channel |
|
||||
| 15 minutes | Link expiry duration (configurable) |
|
||||
| Greenhouse ATS | External candidate source |
|
||||
| Instance (implementation) | Template (domain-level) |
|
||||
| ------------------------- | ----------------------------------- |
|
||||
| Google OAuth | Authentication provider |
|
||||
| Slack | Notification channel |
|
||||
| 15 minutes | Link expiry duration (configurable) |
|
||||
| Greenhouse ATS | External candidate source |
|
||||
|
||||
Sometimes the instance IS the domain concern. "We specifically integrate with Salesforce" might be a competitive feature. "We support exactly these three OAuth providers" might be design scope.
|
||||
|
||||
@@ -257,12 +257,12 @@ This surfaces decisions they have not made yet.
|
||||
|
||||
When you hear implementation language, redirect:
|
||||
|
||||
| They say | You redirect |
|
||||
|----------|-------------|
|
||||
| "The API returns a 404" | "So the user is informed it's not found?" |
|
||||
| "We store it in Postgres" | "What information is captured?" |
|
||||
| "The frontend shows a modal" | "The user is prompted to confirm?" |
|
||||
| "We use a cron job" | "This happens on a schedule, how often?" |
|
||||
| They say | You redirect |
|
||||
| ---------------------------- | ----------------------------------------- |
|
||||
| "The API returns a 404" | "So the user is informed it's not found?" |
|
||||
| "We store it in Postgres" | "What information is captured?" |
|
||||
| "The frontend shows a modal" | "The user is prompted to confirm?" |
|
||||
| "We use a cron job" | "This happens on a schedule, how often?" |
|
||||
|
||||
### Surface ambiguity explicitly
|
||||
|
||||
|
||||
Reference in New Issue
Block a user