navidocs/USER-TESTING-GUIDE.md

Feature Selector User Testing Guide

Quick Start: https://digital-lab.ca/navidocs/builder/

---

Quick Test (5 minutes)

Step 1: Open Feature Selector

Open browser: https://digital-lab.ca/navidocs/builder/

Step 2: Select Tier 1 Features

Check all 4 Tier 1 features (red badges):

• Photo-Based Inventory Tracking
• Smart Maintenance Tracking & Reminders
• Document Versioning & Audit Trail
• Multi-User Expense Tracking

Step 3: Export Agent Tasks

1. Click green "Export Agent Tasks" button
2. Verify alert shows:
   • Total tasks: 21
   • P0 tasks: 21
   • Estimated hours: 53h
3. Download: navidocs-agent-tasks-2025-11-13.json

Step 4: Verify JSON Structure

Open downloaded file and check:

• metadata.selected_features: 4
• agents.agent-1-backend.tasks: 4 tasks
• agents.agent-2-frontend.tasks: 4 tasks
• agents.agent-3-database.tasks: 4 tasks
• agents.agent-4-integration.tasks: 1 task (expense-tracking only)
• agents.agent-5-testing.tasks: 4 tasks
• summary.total_tasks: 21
• summary.estimated_total_hours: 53

Expected Result: ✅ JSON matches sample in /home/setup/navidocs/sample-agent-tasks-tier1.json

---

Full Test (15 minutes)

Test Case 1: No Features Selected

1. Clear all selections (Click "Clear All")
2. Click "Export Agent Tasks"
3. Expected: Alert "Please select at least one feature before exporting agent tasks!"

Test Case 2: Single Feature

1. Select only "Photo-Based Inventory Tracking" (Tier 1)
2. Click "Export Agent Tasks"
3. Expected: 5 tasks (1 per agent, except agent-4 skips this feature)

Test Case 3: Mix of Tiers

1. Select:
   • Tier 1: Photo-Based Inventory Tracking (Must-Have: 10)
   • Tier 2: Camera Integration (Must-Have: 7)
   • Tier 3: WhatsApp Integration (Must-Have: 5)
2. Click "Export Agent Tasks"
3. Expected:
   • P0 tasks: 5 (from Tier 1, Must-Have 10 → P0)
   • P1 tasks: 5 (from Tier 2, Must-Have 7 → P1)
   • P2 tasks: 5 (from Tier 3, Must-Have 5 → P2)

Test Case 4: Priority Calculation

1. Select "Camera Integration" (Tier 2, default Must-Have: 7)
2. Adjust slider to 9
3. Click "Export Agent Tasks"
4. Expected: All 5 tasks now P0 (Must-Have 9 ≥ 8 → P0)

Test Case 5: Integration Features

1. Select all features requiring third-party integrations:
   • Camera Integration (Home Assistant)
   • WhatsApp Integration (WhatsApp Business API)
   • Accounting Integration (Spliit fork)
   • Multi-User Expense Tracking (OCR + bank API)
2. Click "Export Agent Tasks"
3. Expected: agent-4-integration has 4 tasks (one for each integration feature)

Test Case 6: All Features

1. Click "Select All" (11 features)
2. Click "Export Agent Tasks"
3. Expected:
   • Total tasks: 54-55 (11 features × ~5 agents, minus skipped integrations)
   • P0 tasks: ~35-40 (features with Must-Have ≥ 8)
   • Estimated hours: ~150-200h

---

Validation Checklist

Feature Display

• 11 features rendered correctly
• Tier badges visible (red=Tier 1, orange=Tier 2, green=Tier 3)
• Must-Have rating displayed (X/10)
• Priority badges (CRITICAL/HIGH/MEDIUM)
• Savings amounts shown

Interaction

• Checkboxes toggle feature selection
• Selected features highlight in blue (#F0F8FF)
• Stats update in real-time (Selected count, Avg Must-Have, Total Savings)
• Slider adjusts Must-Have rating (1-10)
• Notes textarea accepts input

Buttons

• "Select All" checks all 11 features
• "Clear All" unchecks all features
• "Export JSON" downloads feature-selection JSON
• "Export Agent Tasks" downloads agent-tasks JSON (green button)
• "Print" opens print dialog

JSON Structure (Agent Tasks)

{
  "metadata": {
    "timestamp": "ISO 8601",
    "meeting": "Riviera Plaisance Partnership",
    "deployment_target": "StackCP shared hosting",
    "selected_features": <count>,
    "swarm_pattern": "S2 (5 Haiku agents parallel)",
    "autonomous_task_file": "AUTONOMOUS-NEXT-TASKS.md"
  },
  "agents": {
    "agent-1-backend": { "role": "...", "model": "haiku", "tasks": [...] },
    "agent-2-frontend": { "role": "...", "model": "haiku", "tasks": [...] },
    "agent-3-database": { "role": "...", "model": "haiku", "tasks": [...] },
    "agent-4-integration": { "role": "...", "model": "haiku", "tasks": [...] },
    "agent-5-testing": { "role": "...", "model": "haiku", "tasks": [...] }
  },
  "summary": {
    "total_tasks": <count>,
    "estimated_total_hours": <hours>,
    "p0_tasks": <count>,
    "deployment_instructions": [...]
  }
}

Task Structure

Each task must have:

• feature_id: String (e.g., "inventory-tracking")
• title: String (e.g., "API endpoints for Photo-Based Inventory Tracking")
• priority: String (P0/P1/P2)
• status: String ("pending")
• description: String (technical description)
• technical_notes: String (from feature.description)
• user_notes: String (from notes textarea or "None")
• estimated_hours: Number (2-4 hours depending on tier)
• dependencies: Array of strings (e.g., ["database schema ready"])

---

Known Issues

❌ Issue 1: WebFetch Network Access

• Description: Agent 3 WebFetch tool cannot access live deployment
• Impact: Cannot verify page loads in browser (static analysis only)
• Workaround: Manual browser testing required
• Status: P2 (Medium) - File analysis confirms correctness

---

Success Criteria

Minimum Viable Test (MVP)

• Page loads at https://digital-lab.ca/navidocs/builder/
• Can select/deselect features
• "Export Agent Tasks" button works
• JSON downloads with correct structure
• Alert shows task summary

Production Ready

• All 6 test cases pass
• JSON validates against schema
• No console errors
• Works on mobile (responsive)
• Print view formats correctly

---

Next Steps After Testing

If Tests Pass

1. Deploy agent-tasks JSON to StackCP
2. Launch 5 parallel Haiku agents
3. Agents poll AUTONOMOUS-NEXT-TASKS.md
4. Begin implementation (Backend → Database → Frontend → Integration → Testing)

If Tests Fail

1. Document failures in /home/setup/navidocs/test-failures.md
2. Report to Agent 3 for debugging
3. Fix bugs in feature-selector.html (lines 591-759)
4. Redeploy to StackCP
5. Retest

---

Sample Output

See /home/setup/navidocs/sample-agent-tasks-tier1.json for expected JSON structure when all 4 Tier 1 features are selected.

---

Generated by: Agent 3 - Feature Selector Testing & Validation (Haiku) Date: 2025-11-13 IF.TTT Compliance: Testing instructions traceable to feature-selector.html:591-759