page.tsx
├── CourseHeader (~/components/courses/course-header.tsx)
│   ├── useCourse (~/hooks/api/use-course.ts)
│   └── AndamioPageHeader (~/components/andamio/)
├── ModuleList (~/components/courses/module-list.tsx)
│   ├── useCourseModules (~/hooks/api/use-course-module.ts)
│   └── ModuleCard (~/components/courses/module-card.tsx)  ← Full Audit only
└── AssignmentCommitment (~/components/courses/assignment-commitment.tsx)
    ├── useStudentAssignments (~/hooks/api/)
    └── useMutation + queryClient  ← check cache invalidation

## QA Report: /route/path

**Audit depth**: Quick Scan / Full Audit
**Files analyzed**: N
**Component tree depth**: N levels

### Summary

| Severity | Count |
|----------|-------|
| Critical | N |
| Warning  | N |
| Info     | N |

### Critical Findings

#### C1: [Title]
**File**: `path/to/file.tsx:LINE`
**Rule**: [Rule ID from checklist]
**Issue**: What's wrong
**Fix**: How to fix it
**Why**: Educational context for the team

### Warning Findings

#### W1: [Title]
...

### Info Findings

#### I1: [Title]
...

### Component Extraction Recommendations

| Current Location | Suggested Component | Reason |
|-----------------|-------------------|--------|
| ... | ... | ... |

### Route Health Score

| Category | Score | Notes |
|----------|-------|-------|
| Data Fetching | Good/Needs Work/Critical | ... |
| Component Structure | Good/Needs Work/Critical | ... |
| TypeScript Safety | Good/Needs Work/Critical | ... |
| Next.js Patterns | Good/Needs Work/Critical | ... |
| Performance | Good/Needs Work/Critical | ... |
| Andamio Conventions | Good/Needs Work/Critical | ... |

npm run typecheck
npm run build

# Find all page files
find src/app -name "page.tsx" | head -40

# Find direct API calls in components (should use hooks)
grep -rn "gateway\|gatewayAuth\|gatewayPost\|gatewayAuthPost" src/app/ src/components/ --include="*.tsx"

# Find "use client" directives
grep -rn "\"use client\"" src/app/ src/components/ --include="*.tsx"

# Find useState that might copy server state
grep -rn "useState.*data\|useState.*query\|useState.*result" src/app/ src/components/ --include="*.tsx"

# Find missing loading.tsx
for dir in $(find src/app -name "page.tsx" -exec dirname {} \;); do
  [ ! -f "$dir/loading.tsx" ] && echo "Missing: $dir/loading.tsx"
done

# Find missing error.tsx
for dir in $(find src/app -name "page.tsx" -exec dirname {} \;); do
  [ ! -f "$dir/error.tsx" ] && echo "Missing: $dir/error.tsx"
done

# Check for inline queryKey arrays
grep -rn "queryKey: \[" src/app/ src/components/ --include="*.tsx"

# Find any typed assertions
grep -rn " as " src/app/ src/components/ --include="*.tsx" | grep -v "as const" | grep -v "// safe"