Skip to content

Commit 579833a

Browse files
authored
Merge pull request #187 from LLM-Coding/copilot/add-invest-terminology
feat: Add INVEST semantic anchor
2 parents a9d8346 + 649e2b8 commit 579833a

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
@@ -202,6 +202,10 @@ Source: https://github.com/LLM-Coding/Semantic-Anchors
202202

203203
## Requirements Engineering
204204

205+
### INVEST
206+
- **Proponents:** Bill Wake
207+
- **Core:** Independent, Negotiable, Valuable, Estimable, Small, Testable — criteria for well-formed user stories
208+
205209
### PRD
206210
- **Also known as:** Product Requirements Document, Product Spec, Feature Spec
207211
- **Proponents:** Marty Cagan, Roman Pichler

website/public/data/anchors.json

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1436,6 +1436,34 @@
14361436
"filePath": "docs/anchors/impact-mapping.adoc",
14371437
"tier": 3
14381438
},
1439+
{
1440+
"id": "invest",
1441+
"title": "INVEST",
1442+
"categories": [
1443+
"requirements-engineering"
1444+
],
1445+
"roles": [
1446+
"product-owner",
1447+
"business-analyst",
1448+
"team-lead",
1449+
"software-developer"
1450+
],
1451+
"related": [
1452+
"user-story-mapping",
1453+
"moscow"
1454+
],
1455+
"proponents": [
1456+
"Bill Wake"
1457+
],
1458+
"tags": [
1459+
"user-stories",
1460+
"agile",
1461+
"scrum",
1462+
"acceptance-criteria",
1463+
"story-quality"
1464+
],
1465+
"filePath": "docs/anchors/invest.adoc"
1466+
},
14391467
{
14401468
"id": "jobs-to-be-done",
14411469
"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
@@ -104,6 +104,7 @@
104104
"name": "Requirements Engineering",
105105
"anchors": [
106106
"ears-requirements",
107+
"invest",
107108
"moscow",
108109
"prd",
109110
"problem-space-nvc",

0 commit comments

Comments
 (0)