docs: start frontend mvp milestone
This commit is contained in:
44
openspec/changes/frontend-mvp/specs/frontend-mvp/spec.md
Normal file
44
openspec/changes/frontend-mvp/specs/frontend-mvp/spec.md
Normal file
@@ -0,0 +1,44 @@
|
||||
# frontend-mvp Specification
|
||||
|
||||
## ADDED Requirements
|
||||
|
||||
### Requirement: Web app exposes the job-seeker tutoring loop
|
||||
|
||||
The system SHALL provide a browser UI for the diagnostic interview loop.
|
||||
|
||||
#### Scenario: user starts diagnostic practice
|
||||
|
||||
- **GIVEN** a job seeker opens the web app
|
||||
- **WHEN** they enter target role, stack, and interview timeline
|
||||
- **THEN** the app creates a diagnostic session
|
||||
- **AND** shows role-relevant questions.
|
||||
|
||||
#### Scenario: user submits an answer
|
||||
|
||||
- **GIVEN** a diagnostic session is active
|
||||
- **WHEN** the user submits an answer
|
||||
- **THEN** the app shows typed grading feedback
|
||||
- **AND** the feedback links to evidence-backed learning state.
|
||||
|
||||
### Requirement: Web app exposes learning progress
|
||||
|
||||
The system SHALL show learner memory, readiness, and next challenge from the
|
||||
backend APIs.
|
||||
|
||||
#### Scenario: progress appears after answer
|
||||
|
||||
- **GIVEN** the user has submitted at least one answer
|
||||
- **WHEN** the app refreshes progress
|
||||
- **THEN** it shows concept mastery, readiness percentage, and next challenge.
|
||||
|
||||
### Requirement: Web app exposes content operations
|
||||
|
||||
The system SHALL provide MVP operator controls for material ingestion,
|
||||
ontology inspection, and teaching asset prompt candidates.
|
||||
|
||||
#### Scenario: operator creates teaching asset prompt
|
||||
|
||||
- **GIVEN** source material has produced ontology candidates
|
||||
- **WHEN** the operator generates an asset prompt for a concept
|
||||
- **THEN** the prompt shows source evidence, review state, model key, and model
|
||||
verification guard.
|
||||
Reference in New Issue
Block a user