feat(aidd-pm): add a story-map route to User Stories
Nobody has claimed this yet.
Assessment
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Newbie friendliness
- 48/100
- Issue type
- Feature
- Clarity
- Mostly clear
- Activity status
- Quiet
- Tech stack
- typescript
- Domain
- tooling
Research direction
Start at the aidd-pm:02-user-stories map route and trace how configured support supplies and persists existing Stories. Done means the route confirms an ordered backbone and named value slices, preserves references without changing Stories, and verifies persisted readback with complete, non-duplicated scope accounting.
Written by the indexing model from the issue text.
Description
Problem
Existing User Stories can be ordered, but the framework has no product-level view that groups those Stories under ordered user activities and makes the smallest coherent value slice visible.
A Story Map is a projection of an existing Story set: its backbone is the user activities, and its bands show value slices. It must remain independent of any particular tracker, sprint, milestone, calendar, or release mechanism.
Decision
Do not add a separate story-map skill. Add a map route to aidd-pm:02-user-stories.
The concern belongs there: User Stories already own their vertical slicing, ordering, relations, and persistence. A Story Map adds the complementary horizontal organisation of the same Stories. A new skill would add another entry point and lifecycle without evidence that maps need to be independently managed as a product artifact.
aidd-pm:07-epic is not the owner: its contract deliberately stays at outcome level and does not propose child slices. Product Brief, Three Amigos, and the backlog orchestrator respectively frame opportunities, assess existing artifacts, and coordinate work; none owns this Story projection.
Scope
- Add a
maproute toaidd-pm:02-user-stories. - Take an explicit, existing Story scope from the project’s configured support.
- Propose an ordered backbone of user activities from that Story scope, then obtain the user’s confirmation before persisting.
- Persist a Story Map on the selected support when authorised. It references Stories; it never copies, creates, rewrites, transitions, or moves them.
- Organise the selected Stories into named value slices. A slice is a product-value grouping, not a GitHub milestone, sprint, calendar period, or release implementation by default.
- Keep any projection to a tracker, roadmap, milestone, or release process outside this route unless a future, explicit integration defines it.
Terminology
slice in the existing User Stories route remains a vertical decomposition into independently valuable Stories.
The map route performs the complementary horizontal organisation:
- backbone: ordered user activities;
- value slice: a coherent band of referenced Stories;
- unallocated: a Story in the selected scope that is deliberately not assigned to a value slice.
Acceptance criteria
- A caller supplies existing Stories from its configured support; the route never invents or redrafts a Story.
- The result contains a confirmed ordered backbone and named value slices.
- Each selected Story is referenced at most once in a value slice, or is explicitly unallocated.
- The map owns membership references; it does not add release, slice, or duplicate relation fields to Stories.
- The route is support-agnostic and does not infer a tracker, milestone, sprint, or release integration.
- A persisted map is read back and verified: every reference resolves, no Story is duplicated, and the requested scope is accounted for.
Extraction threshold
A future standalone Story Map skill is justified only if maps acquire an independent lifecycle: for example, several maps maintained separately, scenario comparison, map versioning, cross-backlog composition, or dedicated relationships and transitions. Until then, a route in 02-user-stories is the smallest coherent surface.
- Dominant language
- TypeScript
- Stars
- 481
- Forks
- 45
- Avg merge
- 19h 38m
- Merged PRs (30d)
- 108
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from ai-driven-dev/framework
-
refactor(aidd-orchestrator): the check zone says when to stop, and reviews its axes in one round Open
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
ai-driven-dev/framework#887 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
ai-driven-dev/framework#873 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 85/100
ai-driven-dev/framework#872 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
ai-driven-dev/framework#625 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
ai-driven-dev/framework#467 · 1 comment ·
All issues in ai-driven-dev/framework
Similar issues
-
VerificationGate: ATTRIBUTION quote guard never matches a normal quotation (\b around the quote) Open
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
danielmiessler/LifeOS#2234 ·
-
T: Bug
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
-
Difficulty 1/5 Under an hour Newbie friendliness 85/100
-
Mend: dependency security vulnerability untriaged
Difficulty 2/5 1-3 hours Newbie friendliness 70/100