First Time User Dashboard

First-Time User: CV Dashboard

Inherits from: _shared/first-time-user-base.md

All by following ONLY the documentation.

Trigger phrases: "test dashboard", "dashboard docs", "first-time dashboard", "audit dashboard"

1. Setup — Create persona, output start message to user
2. Discovery — Search for dashboard documentation using grep/ls
3. Happy Path — Attempt: prerequisites → generate → access → use
4. Errors — Test: missing password, no variants
5. Report — Generate audit report, save to docs/audits/

After each phase, report findings before continuing to next phase.

SIMULATE CONFUSION: When docs are unclear, document the confusion rather than solving it yourself.

NO REAL PASSWORDS: Use mock passwords like "test123" for simulation.

Phase 1: Setup

1.1 Create Persona

persona:
  name: "[Random realistic name]"
  role: "PM/Developer who has variants generated"
  goal: "Access my CV Dashboard to manage job applications"
  context:
    - Has variants in content/variants/
    - Never used the dashboard before
    - Knows basic CLI/npm
    - Wants to share links with recruiters

1.2 Output Start Message

Tell user: "Starting CV Dashboard first-time user simulation as [persona name]..."

Phase 2: Discovery

2.1 Search for Documentation

# What docs mention dashboard?
grep -r "dashboard" docs/ README.md --include="*.md" -l
grep -r "generate:dashboard" . --include="*.md" -l

# Check package.json for dashboard commands
grep "dashboard" package.json

2.2 Record Discovery Experience

discovery:
  found_in_readme: true|false
  found_in_guides: true|false
  guide_path: "[path if found]"
  clear_entry_point: true|false
  friction: "Description of any confusion"

2.3 Documentation Locations to Check

Phase 3: Happy Path

3.1 Prerequisites Check

Document if these are clearly stated:

• Need DASHBOARD_PASSWORD env var?
• Need variants already generated?
• Need to run npm install first?

3.2 Generate Dashboard

DASHBOARD_PASSWORD=test123 npm run generate:dashboard

Record:

generate:
  command_documented: true|false
  documented_in: "[file path]"
  result: "success|failure|confusion"
  output_path: "public/cv-dashboard/index.html"
  friction: "What was unclear?"

3.3 Access Dashboard

# Check if file was created
ls public/cv-dashboard/

# How to view? (npm run dev? open file? URL?)

Record:

access:
  file_created: true|false
  how_to_view_documented: true|false
  url_documented: true|false
  friction: "How do I actually see this?"

3.4 Use Dashboard Features

Test each feature (if accessible):

Phase 4: Errors

4.1 Missing Password

npm run generate:dashboard  # No password

Record:

missing_password:
  clear_error_message: true|false
  suggests_fix: true|false
  error_text: "[actual error message]"

4.2 No Variants

What happens if content/variants/ is empty?

empty_variants:
  documented: true|false
  handled_gracefully: true|false
  error_or_empty_state: "[what shows]"

Phase 5: Report

5.1 Compile Audit Report

Use template from _shared/first-time-user-base.md with these tool-specific steps:

Happy Path Steps for Dashboard:

1. Find documentation
2. Understand prerequisites (password, variants)
3. Set DASHBOARD_PASSWORD env var
4. Run generate command
5. Find output file
6. View in browser
7. Enter password
8. Navigate dashboard features

5.2 Save Report

docs/audits/YYYY-MM-DD-first-time-user-dashboard.md

Example Output

Dashboard generation succeeded, but documentation was scattered. Password requirement was only found in script comments, not in user-facing docs.

Happy Path Journey

Recommendations

Priority 1 (Blocking)

• Document DASHBOARD_PASSWORD requirement in Getting Started

Priority 2 (Friction)

• Add dashboard to README Quick Start section
• Document how to view (npm run dev vs open file)

Priority 3 (Polish)

• Add success message with URL after generate

Quality Checklist

Before completing:

• Followed ONLY documentation (no source code diving)
• Tested full happy path (generate → view → use)
• Tested error scenarios (no password, no variants)
• Documented all friction points
• Generated prioritized recommendations
• Saved report to docs/audits/

Notes

• Dashboard is password-protected — password setup is critical path
• Dashboard is a static HTML file — viewing method matters
• Links to portfolio variants must work correctly
• Resume download links must be functional

• first-time-user — General documentation audit
• first-time-user-ucv-cli — CLI-specific audit
• technical-writer — Fix documentation issues found
• sprint-sync — Report findings in status update