docs(user-stories): add master CV onboarding stories (GAP-25)#99
Open
docs(user-stories): add master CV onboarding stories (GAP-25)#99
Conversation
Add a new user-story file and related updates covering the initial
creation of Master_CV_Data.json from external source materials.
This closes the documented onboarding gap (previously noted in the
specstory review as "no story for creating master CV from scratch").
New file:
- tasks/user-story-master-cv-onboarding.md
Twelve stories (US-O1–US-O12) across three persona layers:
- Applicant / first-time user: guided path detection (US-O1),
LinkedIn data export import (US-O2), resume/CV document import
(US-O3), BibTeX / Google Scholar publications import (US-O4),
GitHub profile import (US-O5), multi-source merge (US-O6),
manual guided-form fallback (US-O7), review-and-confirm gate
(US-O8).
- UI/UX expert: source selection and import flow clarity (US-O9),
error and gap handling (US-O10).
- Master CV curator: post-import completeness check (US-O11),
conflict resolution when merging sources (US-O12).
Updated files:
- tasks/user-story-first-time-user.md: add US-F4 covering the
precondition check and onboarding entry point for first-time users
who have no existing master CV file.
- tasks/gaps.md: add GAP-25 documenting the onboarding gap, its
severity (HIGH), affected stories, and recommended resolution.
- tasks/workflow-review-expanded-personas.md: register the new story
file in the story-file index.
…nput Add five additional input paths to the resume/CV document import story: - Plain text file upload (.txt) - Markdown file upload (.md) — heading structure used as section hints - HTML file upload (.html/.htm) — tags stripped; heading elements used as section-boundary hints - Pasted text — any format accepted (plain, Markdown, or lightly formatted HTML copy-paste); auto-detected and tag-stripped where needed - The paste path is presented as a first-class equal-weight option alongside file upload (not a secondary fallback) Expand acceptance criteria and failure modes accordingly: - HTML tag-stripping required before LLM prompt (prevents script/style tag pollution and prompt injection via malicious HTML) - Pasted HTML auto-detected and stripped rather than passed raw to LLM - Markdown structural markers preserv- Markdown structural markers preserv- Markdown structural markers preserv- Markdown structural markers preserv- Markdown structural markers preserv- Markdown structural markers preserv- ripti- Markdown structural markers preserv- Markdset.
- Fix integration test: read textarea value via .value not .textContent, resolving the "buildSummaryFocusSection did not use session summary" failure - Upgrade CodeQL Action v3 -> v4 across both workflow files - Upgrade actions/setup-python v4 -> v5 across both workflow files - Add FORCE_JAVASCRIPT_ACTIONS_TO_NODE24=true workflow env to silence Node.js 20 deprecation warnings on cache/checkout/setup-node actions
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds user stories and a gap entry for the documented but unspecified workflow of creating
Master_CV_Data.jsonfrom scratch using external source materials. This addresses the onboarding gap previously noted in specstory history reviews: "There is no story for creating master CV from scratch for a first-time user."New file
tasks/user-story-master-cv-onboarding.mdTwelve stories (US-O1–US-O12) across three persona layers:
Applicant / first-time user:
UI/UX expert:
Master CV curator:
Updated files
tasks/user-story-first-time-user.mdtasks/gaps.mdtasks/workflow-review-expanded-personas.mdRelationship to existing stories / gaps
Testing / review checklist
workflow-review-expanded-personas.mdstory file list is complete