Problem
The harness encodes a lot of opinions (mechanical gates, meta-gates, layered boundaries, agent hooks) but the why behind those choices isn't captured anywhere a reader can find quickly. New contributors and users have to reverse-engineer the rationale from the gates themselves.
Proposed solution
Add LEARNING.md at the repo root, ~200–300 words, covering:
- What surprised the author while building the harness (where intuition was wrong).
- Which gate has caught the most real mistakes, and what kind.
- What would be done differently on a v2 (and why).
Keep it personal-voice and short — this isn't a design doc, it's a reflection.
Acceptance criteria
Priority rationale
Polish — not a blocker for release. Adds a humanising dimension that the rest of the docs (intentionally terse) don't carry.
Problem
The harness encodes a lot of opinions (mechanical gates, meta-gates, layered boundaries, agent hooks) but the why behind those choices isn't captured anywhere a reader can find quickly. New contributors and users have to reverse-engineer the rationale from the gates themselves.
Proposed solution
Add
LEARNING.mdat the repo root, ~200–300 words, covering:Keep it personal-voice and short — this isn't a design doc, it's a reflection.
Acceptance criteria
LEARNING.mdexists at repo root, ~200–300 wordsPriority rationale
Polish — not a blocker for release. Adds a humanising dimension that the rest of the docs (intentionally terse) don't carry.