Review Scoring → Word Document

Converts raw product review files into a formatted Word document with two deliverables:

1. Attribute catalog — a minimum of 30 product attributes inferred from the full review corpus, each anchored to a Maslow need tier and accompanied by an evaluation dimension statement.
2. Product × attribute score matrix — every product scored 0–10 on every attribute, colour-coded by performance band, with per-attribute averages and per-product totals.

For a worked example using real Amazon reviews, see references/worked-example.md.

Concepts and definitions

Review corpus

All text written by customers about a product, collected across one or more files. A valid review is any entry whose body text exceeds 15 characters after stripping whitespace. No language filter is applied; multilingual corpora are treated identically to monolingual ones.

Attribute

A distinct, evaluable dimension of product quality or experience that surfaces — positively or negatively — across multiple reviews. An attribute is not a feature; it is the customer's lived experience of that feature. For example, "anti-fog coating" is a feature; "fog resistance in practice" is an attribute.