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 1: Go Backend Foundation and Workflow Boundary.

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.

Next Actions

1. Choose first interview track and canonical concept seed list.
2. Define typed contracts for diagnostic, grading, memory extraction, next challenge, readiness update, ontology gap, and asset prompt.
3. Plan Phase 1 with GSD before writing backend code.

Validation Log

• 2026-04-26: openspec validate bootstrap-job-tutor-platform --strict passed before GSD planning docs were created.

---

State initialized: 2026-04-26.