docs(skill): clarify work item skill triggers
This commit is contained in:
1 parent
2e18a66a77
commit
d42a70605d
1 file changed
+11
-4
@@ -1,12 +1,19 @@
|
||||
---
|
||||
name: work-item-definition
|
||||
description: Turn an unclear request into a bounded technical work item.
|
||||
description: Use when a request is too vague to scope, estimate, or verify. Define the objective, scope, acceptance criteria, assumptions, dependencies, and only material open questions; do not implement it.
|
||||
---
|
||||
|
||||
# Work Item Definition
|
||||
|
||||
Use when requirements, scope, or acceptance criteria are incomplete.
|
||||
Use when a request lacks enough detail to estimate or verify the intended technical outcome.
|
||||
|
||||
Clarify the objective, boundaries, assumptions, acceptance criteria, and open questions.
|
||||
## Workflow
|
||||
|
||||
Do not invent business requirements.
|
||||
1. State the user or system outcome in concrete terms.
|
||||
2. Define what is in scope and what is explicitly out of scope based on the request and current behavior.
|
||||
3. Write observable acceptance criteria, including relevant failure or edge cases.
|
||||
4. Record constraints, dependencies, compatibility requirements, and assumptions separately.
|
||||
5. Ask only questions whose answers would materially change behavior, contracts, permissions, or acceptance. Choose safe reversible defaults for minor implementation details.
|
||||
6. Identify unresolved risks and a proportionate verification approach.
|
||||
|
||||
Return a bounded work item with objective, scope, criteria, assumptions, dependencies, and open questions. Do not invent business rules or start implementation unless asked.
|
||||
Reference in new issue
Block a user