Investigor Frontend Skill Playbook

This playbook is for engineers and coding agents working on investigor-frontend.

Primary Goals

• Keep field workflows fast, clear, and resilient under stress.
• Keep UI behavior aligned with backend contracts.
• Minimize blocking ambiguity in generation and profile workflows.

Working Rules

• Use one canonical predicate for status labels and action enablement.
• If an action is blocked, show a clear reason and a direct recovery action.
• Avoid repeated error toasts for identical failures in short windows.
• Keep mobile and keyboard-first operation practical.

UX Hardening Baseline

For high-pressure workflows (hourly day, closeouts, case overview):

• Provide an inline blocker panel with recovery actions.
• Deduplicate repeated error toasts.
• Support keyboard shortcuts for common actions.

Required Validation For Profile/Workflow Changes

Run these before merge:

• npm run test -- src/test/HourlyLogDayPage.test.tsx
• npm run test -- src/test/DailyCloseoutsPage.test.tsx
• npm run test -- src/test/CasePageRoleVisibility.test.tsx
• npm run test -- src/test/AdminReportProfilesControl.test.tsx

Cross-Repo Doc Sync

If UI behavior changes for profile/generation/permissions:

1. Update frontend docs note.
2. Update matching backend docs note.
3. Keep wording and decision rationale consistent.

Current Reference

• docs/CROSS_REPO_ALIGNMENT_2026_04_27.md