test-driver/research/README.md
tegwick bec7fdc465 T03: research control plane
H-001..H-005 with explicit falsification conditions, E-001..E-003, the
Concept-Implementation Fitness Map, findings log and ID convention. Plain
files, no tooling.

- fitness map corrects Improvement Loop section 13 levels downward: nothing
  exceeds C1 without implementation
- H-005 (Energy) dormant by decision - events captured, no scoring written
- H-001 gets a genuine control arm so the semantic-action thesis is not
  trivially true
- E-003 added: deliberately attacks the safety boundary rather than only
  sampling benign cases

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

Assistant: claude-code
Assistant-Model: opus
Assistant-Process: 1629012@bnt-lap001
Assistant-Session: 78d4fb13-8a1e-474b-87a3-9b9261c49a39
2026-08-22 23:11:21 +02:00

48 lines
1.8 KiB
Markdown

# Research Control Plane
Deliberately small. This directory exists so that claims about test-driver can be
falsified rather than accumulated. It is plain files — no CLI, no schema, no
tooling — until there are enough readings to justify tooling.
```
research/
├── hypotheses/ H-NNN — a claim with a falsification condition
├── experiments/ E-NNN — a planned or executed test of a hypothesis
├── findings/ F-NNNN — findings about test-driver itself
├── concepts/ the Concept ↔ Implementation Fitness Map
└── decisions/ pointers to decisions recorded in State Hub
```
## Identifier convention
| Prefix | Scope | Example |
|---|---|---|
| `H-NNN` | Hypothesis | `H-001` |
| `E-NNN` | Experiment | `E-001` |
| `F-NNNN` | Framework Finding | `F-0001` |
| `C-<slug>` | Concept in the fitness map | `C-actor-isolation` |
| `D-NN` | Decision, scoped to its design note | `D-07` |
| `TD-WP-NNNN-TNN` | Workplan task (State Hub) | `TD-WP-0002-T04` |
Identifiers are stable and never reused. A rejected hypothesis keeps its number.
## Hypothesis lifecycle
```
PROPOSED → EXPERIMENTING → SUPPORTED → PRACTICALLY_VALIDATED → ARCHITECTURAL
└──────→ REJECTED
```
A hypothesis may be reopened if later evidence contradicts it. Reopening is
recorded in the file, not by creating a new identifier.
## Rules
1. **Every hypothesis states what would falsify it**, in terms of an observable
outcome, before any experiment runs. A hypothesis with no falsification
condition is an opinion.
2. **Concepts with no supporting evidence are marked as such**, not quietly
retained. The fitness map is expected to contain unsupported entries; hiding
them defeats its purpose.
3. **Subtraction counts as progress.** A rejected hypothesis or a removed
abstraction is a result, not a setback.