| name | Training navigation (vendor-agnostic) |
| description | Navigate web-based trainings that gate progress via timers/videos/disabled Next buttons. |
| tools | playwright |
Core Skills Reference
- Use browser-automation-core for:
- Selector strategy (stability first).
- Basic waiting & scrolling logic.
- Handling overlays/modals.
- General HITL (Auth/Safety).
Preconditions
- User is signed in (or is ready to sign in when prompted).
- Training URL is provided in chat as session-only:
<TRAINING_URL>(do not store in repo files).
Training-Specific Gating & Progress
- Gating Signals:
- Disabled Next (
disabled,aria-disabled="true"). - Countdown timers (“You can continue in 00:30”).
- “Must watch video” / “watch until the end” requirements.
- Required acknowledgements/quizzes.
- Disabled Next (
- Long-Duration Polling:
- Unlike standard UI waits, training timers may last minutes.
- Use bounded polling loops: Re-check every 10–20s, up to a max window (e.g., 5–15 mins).
- Between polls, verify landmarks (button enabled, timer reached 0).
- Completion Landmarks:
- Next/Continue enables.
- Timer reaches 0 then disappears.
- “Completed” badge/checkmark appears.
- "Certificate of Completion" page appears (strong signal to exit).
Steps (Training Workflow)
- Open training: Navigate to
<TRAINING_URL>. - Find "Advance" Control: Look for "Next", "Continue", "Start", "Resume".
- Detect Gating: Check if advance control is disabled or if timers/video requirements exist.
- Handle Content:
- Videos: Play video, monitor progress/timer.
- Quizzes: Select answers (prefer clicking
<label>text), Submit, then Continue. - Scroll: Scan for hidden controls at bottom/footer if not visible.
- Advance: Click Next/Continue when enabled.
- Repeat: Until course completion.
HITL Points (Training Specific)
- Exit Confirmation: If clicking "Exit" triggers a "Are you sure?" dialog, treat the secondary confirmation as the irreversible action requiring HITL.
- Certificates: Ask before generating/downloading if it implies "finishing".
Recovery Rules (Training Specific)
- Stuck on Slide:
- Check for "mark as read" checkboxes or small interactions required.
- Check if a video ended but didn't auto-trigger "complete" (try scrubbing to end).
- Menu Exits: If "Exit" is the only way out, verify if it saves progress or completes the course.