90 lines
4.3 KiB
Markdown
90 lines
4.3 KiB
Markdown
# 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 9 planning: Material and Asset Workspace.
|
|
|
|
## 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.
|
|
- Phase 7 web app shell and diagnostic start UI is implemented and verified.
|
|
- Phase 8 learning progress view is implemented and verified.
|
|
|
|
## Next Actions
|
|
|
|
1. Plan and execute Phase 9: Material and Asset Workspace.
|
|
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.
|
|
- 2026-04-26: Phase 7 implementation verified with `go test ./...`, OpenSpec
|
|
validation, root/asset HTTP smoke, and diagnostic API smoke through the
|
|
server used by the web app.
|
|
- 2026-04-26: Phase 8 implementation verified with `go test ./...`, OpenSpec
|
|
validation, app script smoke, and learner memory/readiness/next-challenge API
|
|
smoke after an answer.
|
|
|
|
---
|
|
*State initialized: 2026-04-26.*
|