vbcherepanov/total-agent-memory/onboard-report

/onboard-report — onboarding results and curriculum

Tools are named onboarding_* (possibly client-prefixed). The server enforces access: department heads (team role manager) see and manage their own department; company_viewer and superadmin see every department; superadmin may also manage. A Forbidden error means the user lacks that role — say so.

1. Pick the department

Use $ARGUMENTS if given. Otherwise call onboarding_overview and choose from viewable_teams (report) or manageable_teams (editing).

2. Report

Call onboarding_team_report(team_id) and present:

• a table: employee × module with status (not started / in progress /

quiz available / awaiting review / passed / failed), lessons done, best quiz score, and the relevant date (started, finished, passed);

• who is stuck (failed with no attempts left, or no activity) and lessons

flagged as updated since people studied them (summary.updated_lessons);

• the latest entries of log in plain language.

For one person's detail: onboarding_progress(team_id, user_id).

3. Grade open answers (department head)

For each item in grading_queue, show prompt, rubric and answer, ask the head for points (0..points) and an optional comment, then call onboarding_grade(attempt_id, question_id, score, comment). Grading the last open answer finalizes the attempt. Never grade without the head's decision.

4. Build or edit the curriculum (department head)

1. onboarding_curriculum_get(team_id) → current curriculum and revision.
2. For a first version, onboarding_curriculum_draft(team_id) groups the

department's memory into modules/lessons (LLM-polished only if the server has one). Review it with the head: reorder, rename, remove, add lesson text.

1. Save with onboarding_curriculum_set(team_id, expected_revision, curriculum).

Keep existing ids so employees keep their progress; omitted items are archived.

1. Quizzes per module: onboarding_quiz_draft(module_id) (needs a server LLM;

drafts are checked against lesson quotes) or write questions with the head, then onboarding_quiz_set(module_id, expected_revision, questions). Question types: single, multiple (zero-based correct indexes), open (needs rubric). Set pass_threshold and max_attempts per module in the curriculum.

Always show the head what will be saved before calling a *_set tool.