Files
tutor-service/.planning/STATE.md
2026-04-26 18:34:47 +09:00

82 lines
3.8 KiB
Markdown

# Project State
## Project Reference
See: `.planning/PROJECT.md` (updated 2026-04-26)
**Core value:** The user should feel and prove that they are becoming more
interview-ready after each short practice loop.
**Current focus:** v2 Frontend MVP milestone started; ready for Phase 7.
## Current Decisions
- Backend is Go.
- `agent-farm-go` workflow patterns should be internalized behind typed backend
interfaces.
- `third-one` is the LLM execution kernel.
- Default runtime target is `deepseek-v4-flash`.
- Source files should stay at or below 600 lines.
- SOLID, KISS, and YAGNI are active implementation constraints.
- OpenSpec is the intent/requirements source of truth.
- First interview track is Backend Developer Interview.
- Phase 1 has context, research, and plan artifacts.
- Phase 1 Go backend scaffold is implemented and verified.
- Phase 2 diagnostic interview loop is implemented and verified with in-memory
sessions.
- Phase 3 learner memory is implemented and verified with evidence-backed
in-memory profiles, mastery, misconceptions, interventions, and review
schedules.
- Phase 4 progression is implemented and verified with readiness map and next
challenge APIs derived from learner memory evidence.
- Phase 5 ontology material ingestion is implemented and verified with
source-backed candidate concepts, prerequisite edges, and candidate gaps.
- Phase 6 teaching asset prompts are implemented and verified with source
evidence, model config, review state, and model-id verification guard.
- v1 milestone audit completed with all 28/28 requirements satisfied and
tech-debt items recorded in `.planning/v1-MILESTONE-AUDIT.md`.
- v2 Frontend MVP milestone selected to turn the backend learning loop into a
usable web service.
## Next Actions
1. Plan and execute Phase 7: Web App Shell and Diagnostic Start.
2. Verify the production OpenAI image model identifier before real image
generation calls.
3. Add standardized SUMMARY frontmatter or Nyquist validation files if future
GSD automation should enforce those gates.
## Validation Log
- 2026-04-26: `openspec validate bootstrap-job-tutor-platform --strict` passed
before GSD planning docs were created.
- 2026-04-26: First track, workflow contracts, and Phase 1 GSD plan were
created.
- 2026-04-26: Phase 1 implementation verified with `go test ./...`,
`openspec validate bootstrap-job-tutor-platform --strict`, and Go source
line-count check.
- 2026-04-26: Phase 2 implementation verified with `go test ./...`, live
`/healthz` smoke, live diagnostic create/answer/get smoke, OpenSpec, and Go
source line-count check.
- 2026-04-26: Phase 3 implementation verified with `go test ./...`,
`openspec validate bootstrap-job-tutor-platform --strict`, live diagnostic
answer to learner-memory smoke, and Go source line-count check.
- 2026-04-26: Phase 4 implementation verified with `go test ./...`,
`openspec validate bootstrap-job-tutor-platform --strict`, live readiness and
next-challenge smoke, and Go source line-count check.
- 2026-04-26: Phase 5 implementation verified with `go test ./...`,
`openspec validate bootstrap-job-tutor-platform --strict`, live material
ingestion and ontology snapshot smoke, and Go source line-count check.
- 2026-04-26: Phase 6 implementation verified with `go test ./...`,
`openspec validate bootstrap-job-tutor-platform --strict`, live
material-to-asset-prompt smoke, and Go source line-count check.
- 2026-04-26: v1 milestone audit verified 28/28 requirements, cross-phase
integration, E2E diagnostic/progression and material/asset flows. Audit
status is `tech_debt` because MVP storage, real workflow runtime, parsers,
real image generation, and Nyquist validation artifacts remain deferred.
- 2026-04-26: v2 Frontend MVP milestone started with WEB-01..WEB-08 mapped to
phases 7 through 9.
---
*State initialized: 2026-04-26.*