IntentGuard

S03.3 — Measure the baseline and lock metric regression

Planning / historicaltaskdelivery

Historical

Planning material. It summarizes and links to the authoritative specification and the current measured state — it does not replace either, and it is not current engineering truth.

Migration identity#

  • Canonical identifier: S03.3 (GitHub issue type: subtask).
  • Legacy identifier: C03.3 (retained as old_identifier).
  • Parent epic: E03.
  • Milestone: M1 — IntentGuard Weekend MVP.

Objective#

Evaluate the persisted baseline at the declared test checkpoint and write accuracy, macro-F1, configuration, and provenance.

Rationale#

A measured baseline is the comparison floor for AC-004 and must exist before transformer claims.

Parent identifier#

E03.

Source task#

T-003.

Traceability#

Primary: AC-002. Secondary: FR-002, FR-005.

Prerequisites#

C03.2 artifact complete; test-metric timing and numerical tolerance resolved.

Likely files#

src/intentguard/metrics.py, scripts/train_baseline.py, tests/unit/test_metrics.py, tests/unit/test_eval_regression.py, reports/.

Implementation boundary#

Required classification metrics and report generation only; no transformer comparison yet.

MUST scope#

Accuracy, macro-F1, deterministic test-row identity, report schema, artifact/data IDs, and regression tolerance.

Explicit non-goals#

Invented target values, confusion commentary, charts, thresholding, or repeated test-driven tuning.

Acceptance criteria#

One declared checkpoint writes reproducible required metrics tied to exact artifact/data inputs and metric versions.

Validation commands#

make baseline && uv run pytest tests/unit/test_metrics.py tests/unit/test_eval_regression.py -q.

Expected evidence#

Machine-readable baseline report and metric-regression test output.

Fallback and status consequence#

An unmeasured artifact is Implemented but not Measured and fails strict MVP.

Stop condition#

Stop for unclear checkpoint timing, missing test identity, undefined tolerance, or metric mismatch.

Definition of ready#

Artifact is immutable and metric timing/tolerances are decided before reading final results.

Definition of done#

AC-002 has reproducible measured evidence and the working-baseline checkpoint is complete.

Labels#

type:subtask, priority:MUST, area:baseline

Estimate#

1.0 hour.

Related in repository

Open in full graph →
DOCUMENTED_BYDOCUMENTED_BY — source: docs/backlog/tasks/C03.3-baseline-report-metric-regression.md § S03.3 — Measure the baseline and lock metric regressionREFERENCESREFERENCES — source: docs/backlog/tasks/C03.3-baseline-report-metric-regression.mdREFERENCESREFERENCES — source: docs/backlog/tasks/C03.3-baseline-report-metric-regression.mdREFERENCESREFERENCES — source: docs/backlog/tasks/C03.3-baseline-report-metric-regression.mdREFERENCESREFERENCES — source: docs/backlog/tasks/C03.3-baseline-report-metric-regression.mdREFERENCESREFERENCES — source: docs/backlog/tasks/C03.3-baseline-report-metric-regression.mdREFERENCESREFERENCES — source: docs/backlog/tasks/C03.3-baseline-report-metric-regression.mdREFERENCESREFERENCES — source: docs/backlog/tasks/C03.3-baseline-report-metric-regression.mdPART_OF — source: docs/backlog/TRACEABILITY.md § Acceptance criteriaPART_OF — source: docs/backlog/TRACEABILITY.md § Acceptance criteriaREFERENCES — source: docs/backlog/tasks/C03.3-baseline-report-metric-regression.md § TraceabilityREFERENCES — source: docs/backlog/tasks/C03.3-baseline-report-metric-regression.md § TraceabilityREFERENCES — source: docs/backlog/tasks/C03.3-baseline-report-metric-regression.md § TraceabilitySATISFIES — source: docs/specification/docs/TRACEABILITY.md § Functional traceabilityREFERENCES — source: docs/backlog/umbrellas/U03-tfidf-baseline.md § TraceabilitySATISFIES — source: docs/specification/docs/TRACEABILITY.md § Functional traceabilitySATISFIES — source: docs/specification/docs/TRACEABILITY.md § Functional traceabilityREFERENCES — source: docs/backlog/umbrellas/U03-tfidf-baseline.md § TraceabilityREFERENCES — source: docs/backlog/umbrellas/U03-tfidf-baseline.md § TraceabilityCURRENTdocument: S03.3 — Measure the baseline and lock metric regressionS03.3task: S03.3AC-002 — Baseline artifactacceptance-criterion: AC-002 — Baseline artifactAC-004 — Fair comparisonacceptance-criterion: AC-004 — Fair comparisonE03epic: E03FR-002 — Baselinerequirement: FR-002 — BaselineFR-005 — Evaluationrequirement: FR-005 — EvaluationT-003 — Reproducible fit…task: T-003 — Reproducible fitted baseline and report
Hover an edge for its provenance · click a node to open it8 nodes · 19 edges