andreagrandi / andreagrandi/draftomen

Define a fixed narration evaluation corpus

Open
#453 0 comments 0 reactions 0 assignees View on GitHub
draftomen enhancement size: S
Dominant language
Python
Stars
0
Forks
0
Avg merge
1h 23m
Merged PRs (30d)
181

Description

## Problem

Model quality cannot be judged by a few attractive examples or tests that merely check for nonempty output.

## Proposed change

Create fixed fact-contract fixtures and expected permitted claims covering all nine PRD situations: obvious best card, close decision, in-color strength, color deviation, low data, near-identical win rates, several strong alternatives, incomplete statistics, and multiple material factors. Include literal card names containing numbers or punctuation so numeric guards cannot confuse names with invented metrics. Define automated checks plus a human factuality/natural-English rubric. Keep this slice to corpus and evaluation specification; actual runtime benchmarking belongs to Establish local narration feasibility and delivery decisions.

## Acceptance Criteria

- [ ] AC1: A corpus coverage check maps every required situation to an immutable fixture with its engine-selected recommendation and permitted claims.
- [ ] AC2: Deliberately incorrect example outputs fail the rubric for invented statistics/reasons, altered numbers/colors, or contradicting the recommendation; verified by evaluator checks or recorded rubric review.
- [ ] AC3: Valid examples containing missing values, close-choice language, and numeric card names are judged correctly; verified by boundary examples.
- [ ] AC4: The evaluation specification separates deterministic format/number checks from reviewed semantic factuality and naturalness; verified by review of the rubric.

## Implementation classification

- **Estimated size:** S
- **Orchestration risk:** Normal
- **Reason:** A bounded fixture set and explicit quality rubric establish the evaluation baseline.

## Dependencies

Direct prerequisites: #452. Consumer: Establish local narration feasibility and delivery decisions.

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.