Revision control

+ # tests
+
+ **Role:** framework test suite. Sample doc-set fixtures, comparison
+ harness, and expected outputs the framework runs its own artifacts
+ against.
+
+ **See also:** [`../README.md`](../README.md) for the framework
+ overview · [`../CONTRIBUTING.md`](../CONTRIBUTING.md) for how to add a
+ test.
+
+ ## Purpose
+
+ The framework validates output correctness against a fixture: an
+ empty module with representative C++ and QML APIs. Each pipeline runs
+ its agents over the fixture; output is compared against human-edited
+ reference content. Audits and reports feed back to agents as new
+ grounding.
+
+ ## Layout (target)
+
+ ```
+ tests/
+ ├── README.md
+ ├── fixtures/ # Sample doc set: C++ module, QML module
+ │ ├── cpp/
+ │ └── qml/
+ ├── reference/ # Human-edited expected output
+ ├── harness/ # Comparison and reporting scripts
+ └── reports/ # Test-run outputs
+ ```
+
+ ## Current state
+
+ No fixtures shipped yet. The first test lands with the first agent
+ that produces content the framework needs to validate.