ulgerang/tutor-service
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: plan backend foundation phase

Browse Source
This commit is contained in:
user
2026-04-26 15:45:56 +09:00
parent 9edaddd092
commit 2744c37f58
12 changed files with 628 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
openspec/changes/bootstrap-job-tutor-platform/specs/job-seeker-tutor/spec.md
View File

@@ -15,6 +15,14 @@ while preserving an architecture that can later support general students.
- **AND** grades the user's answers against explicit rubrics
- **AND** creates an initial concept weakness map.
#### Scenario: backend developer track is the first canonical track
- **GIVEN** the MVP track catalog is initialized
- **WHEN** the system loads the first interview track
- **THEN** it provides the Backend Developer Interview track
- **AND** includes HTTP, REST/API design, databases, transactions, caching,
concurrency, testing, and system design basics as seed concept clusters.
#### Scenario: practice session adapts to weak answers
- **GIVEN** a user answers an interview question weakly or incorrectly

9
openspec/changes/bootstrap-job-tutor-platform/specs/tutor-workflows/spec.md
View File

@@ -23,6 +23,15 @@ The system SHALL express core tutor behavior as configurable workflows using
- **THEN** it emits memory update candidates
- **AND** each candidate identifies its evidence and confidence.
#### Scenario: initial contract set is available for backend planning
- **GIVEN** the backend workflow boundary is planned
- **WHEN** implementation begins
- **THEN** the initial contract set includes DiagnosticResult, GradedAnswer,
MemoryUpdateCandidate, NextChallenge, ReadinessUpdate, OntologyGap, and
TeachingAssetPrompt
- **AND** each state-changing contract carries evidence references.
### Requirement: Default LLM runtime is configurable
The system SHALL keep the LLM model target configurable while defaulting the

9
openspec/changes/bootstrap-job-tutor-platform/tasks.md
View File

@@ -7,8 +7,9 @@
- [x] 4. Incorporate game-design learning loop and progression planning.
- [x] 5. Add repository engineering principles and code-size constraints.
- [x] 6. Lock Go backend and internalized agent-farm workflow direction.
- [ ] 7. Choose the first interview track and canonical concept seed list.
- [ ] 8. Define typed JSON contracts for diagnostic, grading, memory extraction,
- [x] 7. Choose the first interview track and canonical concept seed list.
- [x] 8. Define typed JSON contracts for diagnostic, grading, memory extraction,
ontology gap detection, and asset prompt generation.
- [ ] 9. Draft the first `agent-farm-go` YAML workflow package.
- [x] 10. Validate the OpenSpec change.
- [x] 9. Create Phase 1 GSD context, research, and plan artifacts.
- [ ] 10. Draft the first `agent-farm-go` YAML workflow package.
- [x] 11. Validate the OpenSpec change.