Skip to content

Commit 0470454

Browse files
Copilotrdmueller
andcommitted
feat: Add INVEST semantic anchor (#issue)
Co-authored-by: rdmueller <1856308+rdmueller@users.noreply.github.com>
1 parent b3f3643 commit 0470454

File tree

4 files changed

+80
-0
lines changed

4 files changed

+80
-0
lines changed

docs/anchors/invest.adoc

Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
= INVEST
2+
:categories: requirements-engineering
3+
:roles: product-owner, business-analyst, team-lead, software-developer
4+
:related: user-story-mapping, moscow
5+
:proponents: Bill Wake
6+
:tags: user-stories, agile, scrum, acceptance-criteria, story-quality
7+
8+
[%collapsible]
9+
====
10+
Full Name:: INVEST Criteria for User Stories
11+
12+
Also known as:: INVEST Checklist, INVEST Mnemonic
13+
14+
[discrete]
15+
== *Core Concepts*:
16+
17+
INVEST = **I**ndependent / **N**egotiable / **V**aluable / **E**stimable / **S**mall / **T**estable
18+
19+
Independent:: Stories should be self-contained and deliverable in any order; avoid dependencies between stories that force a fixed implementation sequence
20+
21+
Negotiable:: Stories are not contracts; the details are open to discussion between team and stakeholders until they enter a sprint
22+
23+
Valuable:: Every story must deliver clear value to the user or business; stories that only serve technical needs should be wrapped in user-visible value
24+
25+
Estimable:: The team must be able to estimate the story's size; if they cannot, the story is too large, too vague, or requires a spike
26+
27+
Small:: Stories should be small enough to complete within a single sprint; large epics must be broken down before entering a sprint
28+
29+
Testable:: Stories require concrete acceptance criteria so developers and testers can verify completion; untestable stories hide ambiguity
30+
31+
32+
Key Proponent:: Bill Wake ("INVEST in Good Stories, and SMART Tasks", 2003)
33+
34+
[discrete]
35+
== *When to Use*:
36+
37+
* Reviewing user stories before sprint planning to assess readiness
38+
* Splitting epics into smaller, deliverable stories
39+
* Coaching teams on what constitutes a well-formed user story
40+
* During backlog refinement to identify stories that need more work
41+
* As a Definition of Ready checklist for story acceptance into a sprint
42+
43+
*Related Anchors*:
44+
45+
* <<user-story-mapping,User Story Mapping>>
46+
* <<moscow,MoSCoW>>
47+
====

skill/semantic-anchor-translator/references/catalog.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -188,6 +188,10 @@ Source: https://github.com/LLM-Coding/Semantic-Anchors
188188

189189
## Requirements Engineering
190190

191+
### INVEST
192+
- **Proponents:** Bill Wake
193+
- **Core:** Independent, Negotiable, Valuable, Estimable, Small, Testable — criteria for well-formed user stories
194+
191195
### MoSCoW
192196
- **Proponents:** Dai Clegg
193197
- **Core:** Must have, Should have, Could have, Won't have

website/public/data/anchors.json

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1389,6 +1389,34 @@
13891389
"tags": [],
13901390
"filePath": "docs/anchors/impact-mapping.adoc"
13911391
},
1392+
{
1393+
"id": "invest",
1394+
"title": "INVEST",
1395+
"categories": [
1396+
"requirements-engineering"
1397+
],
1398+
"roles": [
1399+
"product-owner",
1400+
"business-analyst",
1401+
"team-lead",
1402+
"software-developer"
1403+
],
1404+
"related": [
1405+
"user-story-mapping",
1406+
"moscow"
1407+
],
1408+
"proponents": [
1409+
"Bill Wake"
1410+
],
1411+
"tags": [
1412+
"user-stories",
1413+
"agile",
1414+
"scrum",
1415+
"acceptance-criteria",
1416+
"story-quality"
1417+
],
1418+
"filePath": "docs/anchors/invest.adoc"
1419+
},
13921420
{
13931421
"id": "jobs-to-be-done",
13941422
"title": "Jobs To Be Done (JTBD)",

website/public/data/categories.json

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -106,6 +106,7 @@
106106
"name": "Requirements Engineering",
107107
"anchors": [
108108
"ears-requirements",
109+
"invest",
109110
"moscow",
110111
"problem-space-nvc",
111112
"user-story-mapping"

0 commit comments

Comments
 (0)