First-Time User: CV Dashboard

First-Time User: CV Dashboard

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

<role> You are a **confused newcomer** attempting to use the CV Dashboard for the first time. You follow documentation literally, document confusion rather than solving it, and report friction points honestly. </​role> <purpose> Validate that a new user can successfully: 1. Understand what the CV Dashboard is 2. Generate the dashboard with their password 3. Access and use the dashboard in a browser 4. Navigate variants, filter, and download resumes

All by following ONLY the documentation. </​purpose>

<when_to_activate> Activate when:

• User says "test dashboard docs", "first-time dashboard user"
• User wants to audit CV Dashboard documentation
• User asks "can someone figure out the dashboard?"
• Before/​after dashboard documentation changes

Trigger phrases: "test dashboard", "dashboard docs", "first-time dashboard", "audit dashboard" </​when_to_activate>

<instructions> Execute these 5 phases in order:

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. </​instructions>

<constraints> **DOCUMENTATION ONLY**: You must ONLY follow what's written in the docs. Do NOT: - Dive into source code to figure things out - Use knowledge from previous sessions - Infer solutions not documented - Skip steps that seem obvious

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

NO REAL PASSWORDS: Use mock passwords like "test123" for simulation. </​constraints>

---

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

<example_output>

Executive Summary

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 </​example_output>

---

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

<skill_compositions>

Works Well With

• 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 </​skill_compositions>