diff --git a/docs/anchors/invest.adoc b/docs/anchors/invest.adoc new file mode 100644 index 0000000..498b602 --- /dev/null +++ b/docs/anchors/invest.adoc @@ -0,0 +1,47 @@ += INVEST +:categories: requirements-engineering +:roles: product-owner, business-analyst, team-lead, software-developer +:related: user-story-mapping, moscow +:proponents: Bill Wake +:tags: user-stories, agile, scrum, acceptance-criteria, story-quality + +[%collapsible] +==== +Full Name:: INVEST Criteria for User Stories + +Also known as:: INVEST Checklist, INVEST Mnemonic + +[discrete] +== *Core Concepts*: + +INVEST = **I**ndependent / **N**egotiable / **V**aluable / **E**stimable / **S**mall / **T**estable + +Independent:: Stories should be self-contained and deliverable in any order; avoid dependencies between stories that force a fixed implementation sequence + +Negotiable:: Stories are not contracts; the details are open to discussion between team and stakeholders until they enter a sprint + +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 + +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 + +Small:: Stories should be small enough to complete within a single sprint; large epics must be broken down before entering a sprint + +Testable:: Stories require concrete acceptance criteria so developers and testers can verify completion; untestable stories hide ambiguity + + +Key Proponent:: Bill Wake ("INVEST in Good Stories, and SMART Tasks", 2003) + +[discrete] +== *When to Use*: + +* Reviewing user stories before sprint planning to assess readiness +* Splitting epics into smaller, deliverable stories +* Coaching teams on what constitutes a well-formed user story +* During backlog refinement to identify stories that need more work +* As a Definition of Ready checklist for story acceptance into a sprint + +*Related Anchors*: + +* <> +* <> +==== diff --git a/skill/semantic-anchor-translator/references/catalog.md b/skill/semantic-anchor-translator/references/catalog.md index c9f09f1..8ca9952 100644 --- a/skill/semantic-anchor-translator/references/catalog.md +++ b/skill/semantic-anchor-translator/references/catalog.md @@ -202,6 +202,10 @@ Source: https://github.com/LLM-Coding/Semantic-Anchors ## Requirements Engineering +### INVEST +- **Proponents:** Bill Wake +- **Core:** Independent, Negotiable, Valuable, Estimable, Small, Testable — criteria for well-formed user stories + ### PRD - **Also known as:** Product Requirements Document, Product Spec, Feature Spec - **Proponents:** Marty Cagan, Roman Pichler diff --git a/website/public/data/anchors.json b/website/public/data/anchors.json index ceef23c..37e05c1 100644 --- a/website/public/data/anchors.json +++ b/website/public/data/anchors.json @@ -1436,6 +1436,34 @@ "filePath": "docs/anchors/impact-mapping.adoc", "tier": 3 }, + { + "id": "invest", + "title": "INVEST", + "categories": [ + "requirements-engineering" + ], + "roles": [ + "product-owner", + "business-analyst", + "team-lead", + "software-developer" + ], + "related": [ + "user-story-mapping", + "moscow" + ], + "proponents": [ + "Bill Wake" + ], + "tags": [ + "user-stories", + "agile", + "scrum", + "acceptance-criteria", + "story-quality" + ], + "filePath": "docs/anchors/invest.adoc" + }, { "id": "jobs-to-be-done", "title": "Jobs To Be Done (JTBD)", diff --git a/website/public/data/categories.json b/website/public/data/categories.json index 1957d94..9b404e8 100644 --- a/website/public/data/categories.json +++ b/website/public/data/categories.json @@ -104,6 +104,7 @@ "name": "Requirements Engineering", "anchors": [ "ears-requirements", + "invest", "moscow", "prd", "problem-space-nvc",