From 468244e26e0556b07f4d426a1f9c492fd168943d Mon Sep 17 00:00:00 2001
From: Derek Ables <derekables@gmail.com>
Date: Fri, 24 Jul 2026 14:56:54 -0700
Subject: [PATCH 1/2] test: add domain fixture conventions documentation

---
 packages/decision-pipeline/src/fixtures.md | 43 ++++++++++++++++++++++
 1 file changed, 43 insertions(+)
 create mode 100644 packages/decision-pipeline/src/fixtures.md

diff --git a/packages/decision-pipeline/src/fixtures.md b/packages/decision-pipeline/src/fixtures.md
new file mode 100644
index 0000000..c5a74d0
--- /dev/null
+++ b/packages/decision-pipeline/src/fixtures.md
@@ -0,0 +1,43 @@
+# Domain Fixture Conventions
+
+## Purpose
+
+This document establishes conventions for test fixtures used throughout Auto-Guardable.
+
+Fixtures provide predictable representations of domain inputs while keeping tests independent from production integrations.
+
+## Principles
+
+- Fixtures represent domain concepts, not implementation details.
+- Tests should describe behavior through contracts.
+- External systems should be replaced with deterministic test data.
+- Fixtures should remain small and intentional.
+
+## Current Pipeline Validation Flow
+
+```
+Domain Fixture
+      |
+      v
+Policy Result Fixture
+      |
+      v
+Decision Adapter
+      |
+      v
+Decision Pipeline
+      |
+      v
+Decision Output
+```
+
+## Future Usage
+
+Fixtures may later represent:
+
+- Camera observations
+- Sensor events
+- Policy scenarios
+- Action outcomes
+
+without requiring those systems to exist during foundation development.

From be8a4b533021546463dd51d2229e3fc7d4169e08 Mon Sep 17 00:00:00 2001
From: Derek Ables <derekables@gmail.com>
Date: Fri, 24 Jul 2026 14:57:04 -0700
Subject: [PATCH 2/2] docs: define pipeline test conventions

---
 .../decision-pipeline/src/test-conventions.md | 30 +++++++++++++++++++
 1 file changed, 30 insertions(+)
 create mode 100644 packages/decision-pipeline/src/test-conventions.md

diff --git a/packages/decision-pipeline/src/test-conventions.md b/packages/decision-pipeline/src/test-conventions.md
new file mode 100644
index 0000000..a4ffda8
--- /dev/null
+++ b/packages/decision-pipeline/src/test-conventions.md
@@ -0,0 +1,30 @@
+# Decision Pipeline Test Conventions
+
+## Purpose
+
+Define how future tests should validate pipeline behavior while preserving architectural boundaries.
+
+## Test Layers
+
+### Contract Tests
+
+Validate that interfaces remain stable.
+
+### Pipeline Tests
+
+Validate that information can move through the pipeline.
+
+### Integration Tests
+
+Validate collaboration between implemented components.
+
+## Rules
+
+- Tests should not depend on hardware.
+- Tests should not require external services.
+- Tests should prove behavior, not implementation details.
+- Each architectural boundary should have explicit validation.
+
+## Goal
+
+Future contributors should be able to add capabilities while maintaining confidence in the system's foundation.