Skip to content

TASK-C01: Course Information Architecture

  • Status: Ready
  • Scope Type: Documentation foundation
  • Recommended Model Tier: Balanced
  • Recommended Reasoning: Low to Medium

Objective

Create the newcomer training information architecture so the repo can support guided learning without losing the existing reference-doc structure.

Scope

  • create course, scenarios, and architecture entry sections
  • create a diagrams workflow page and folder conventions
  • expose the new sections in VitePress nav and sidebar
  • fix docs filename issues that block the docs build
  • establish a reusable style and structure for course pages

Non-Scope

  • writing the full training content for every module
  • drawing all diagrams
  • rewriting all existing lessons

Files To Read First

  • docs/index.md
  • docs/.vitepress/config.mts
  • docs/implementation/ROADMAP.md
  • docs/requirements.md
  • docs/lessons/** only as needed to understand current coverage

Expected Deliverables

  • docs/course/index.md
  • docs/course/COURSE-ROADMAP.md
  • docs/course/COURSE-EXECUTION-GUIDE.md
  • docs/course/DIAGRAMS-WORKFLOW.md
  • new landing pages for scenarios and architecture
  • nav and sidebar updates

Verification

  • npm run docs:build
  • manually confirm the new sections appear in nav and sidebar

Copy/Paste Prompt

text
You are working in C:\Lcn.Workspaces\lcn-wafer-inspection-desktop.

Audience: a newcomer software engineer or automation engineer learning this project.
Goal: turn this repo into a high-quality engineering training course, not just reference docs.
Style: practical, detailed, blog-quality English; clear headings; concrete examples; no fluff.
Ground all claims in the repo docs and code. Do not invent behavior that the current project does not support.
Prefer reusing and linking existing content under docs/lessons, docs/specs, docs/tasks, docs/adrs, docs/implementation, and the source code when helpful.
For diagrams, do not generate binary assets. Instead, produce a Draw.io-friendly diagram brief: title, purpose, nodes, edges, grouping, caption, and destination file path.
If you edit docs, keep VitePress navigation coherent and make sure npm run docs:build passes.

Task: Create the training-docs information architecture for this repo.

Read first:
- docs/index.md
- docs/.vitepress/config.mts
- docs/implementation/ROADMAP.md
- docs/requirements.md
- enough of docs/lessons to understand current topic coverage

Do:
- add top-level sections for Course, Scenarios, Architecture, and Diagrams workflow
- create landing pages for those sections
- create a concise course execution guide for model choice, prompting, and review
- fix filename or nav issues that block VitePress builds
- update VitePress nav and sidebar to expose the new sections

Do not:
- write the full course content yet
- rewrite all lesson pages

Verify:
- npm run docs:build
- confirm the new sections are visible in nav and sidebar

Docs-first project memory for AI-assisted implementation.