Product Designer

#!/usr/bin/env python3
"""
Design Critique Generator

Evaluates a UI design against established heuristics (Nielsen's 10,
Gestalt principles, accessibility standards) and generates a structured
critique report with severity ratings and improvement suggestions.

Uses ONLY Python standard library.

Usage:
    python design_critique.py --checklist
    python design_critique.py --answers answers.json
    python design_critique.py --answers answers.json --json
"""

import argparse
import json
import sys
from typing import Dict, List


# Nielsen's 10 Usability Heuristics
NIELSEN_HEURISTICS = [
    {
        "id": "N1",
        "name": "Visibility of system status",
        "description": "The design keeps users informed about what is happening through appropriate feedback within reasonable time.",
        "checkpoints": [
            "Loading states are visible for operations >1 second",
            "Progress indicators shown for multi-step processes",
            "Success/error feedback appears after user actions",
            "Current location is clear in navigation",
        ],
    },
    {
        "id": "N2",
        "name": "Match between system and real world",
        "description": "The design uses language, concepts, and conventions familiar to the user.",
        "checkpoints": [
            "Labels use user language, not internal jargon",
            "Icons follow established conventions",
            "Information appears in natural and logical order",
            "Metaphors match real-world expectations",
        ],
    },
    {
        "id": "N3",
        "name": "User control and freedom",
        "description": "Users can easily undo, redo, or exit unwanted states.",
        "checkpoints": [
            "Undo is available for destructive actions",
            "Cancel/back options are clearly visible",
            "Users can exit flows without losing progress",
            "Confirmation dialogs for irreversible actions",
        ],
    },
    {
        "id": "N4",
        "name": "Consistency and standards",
        "description": "Users don't have to wonder whether different words, situations, or actions mean the same thing.",
        "checkpoints": [
            "UI elements behave the same way throughout",
            "Terminology is consistent across all pages",
            "Visual patterns (spacing, colors) are consistent",
            "Platform conventions are followed",
        ],
    },
    {
        "id": "N5",
        "name": "Error prevention",
        "description": "Good design prevents problems from occurring in the first place.",
        "checkpoints": [
            "Form validation occurs before submission",
            "Constraints prevent invalid inputs",
            "Destructive actions require confirmation",
            "Default values reduce user effort and errors",
        ],
    },
    {
        "id": "N6",
        "name": "Recognition rather than recall",
        "description": "Minimize the user's memory load by making elements, actions, and options visible.",
        "checkpoints": [
            "Options are visible rather than requiring memorization",
            "Help and instructions are easily accessible",
            "Recently used items are easily accessible",
            "Search and filter options are visible",
        ],
    },
    {
        "id": "N7",
        "name": "Flexibility and efficiency of use",
        "description": "Accelerators allow experienced users to speed up interaction.",
        "checkpoints": [
            "Keyboard shortcuts available for frequent actions",
            "Customizable interface elements",
            "Shortcuts or recent items for repeat tasks",
            "Batch operations for power users",
        ],
    },
    {
        "id": "N8",
        "name": "Aesthetic and minimalist design",
        "description": "Interfaces should not contain irrelevant or rarely needed information.",
        "checkpoints": [
            "Each screen focuses on one pri