tutor-service/.planning/STATE.md

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.