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:** Phase 6 planning: Teaching Assets.

## 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.

## Next Actions

1. Plan Phase 6 teaching asset prompt generation with GSD.
2. Keep `docs/planning/WORKFLOW_CONTRACTS.md` aligned with Go structs during
   future workflow implementation.
3. Verify the production OpenAI image model identifier before real asset
   generation calls.

## 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.

---
*State initialized: 2026-04-26.*