Files
tutor-service/.planning/STATE.md
2026-04-26 17:54:23 +09:00

3.2 KiB

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: v1 baseline complete; ready for milestone audit or frontend planning.

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.

Next Actions

  1. Run a milestone audit across Phase 1 through Phase 6.
  2. Choose the next milestone: frontend MVP, persistence, real workflow runtime, or document parser integration.
  3. Verify the production OpenAI image model identifier before real image 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.
  • 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.

State initialized: 2026-04-26.