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

2.8 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: 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.