Skip to content
Merged
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
41 changes: 37 additions & 4 deletions docs/pr-preservation/_patterns.md
Original file line number Diff line number Diff line change
Expand Up @@ -285,6 +285,16 @@ first-name attribution:
- Behavioural docs, threat models
- Spec docs (`docs/**` not in history-class above)

**Synthesis-over-history surfaces** — current-state-tracking
abstractions over history-class corpora; reflect current state
not historical sequence:

- `docs/pr-preservation/_patterns.md` (this file) — synthesis-
index over the per-PR drain-log corpus. Edited as new logs
land + patterns surface; should reflect current corpus state.
Comment thread
AceHack marked this conversation as resolved.
Outdated
Underscore-prefix candidate convention for "synthesis-indices
over history-class corpora" co-located with the corpus.

**Tension surfaces** — both apply; defer to maintainer:

- `docs/bootstrap/**` (#195) — current-state operational substrate
Expand All @@ -295,7 +305,9 @@ first-name attribution:
The **Otto-279 history-vs-current-state carve-out is mature enough
to codify in `docs/AGENT-BEST-PRACTICES.md` as a stable BP-NN rule.**
Tension surfaces need either a third surface class or explicit
carve-out within current-state.
carve-out within current-state. Synthesis-over-history is now
named as a third class that's distinct from both pure history-
class and pure current-state.

---

Expand Down Expand Up @@ -357,9 +369,30 @@ When a new drain-log lands in `docs/pr-preservation/`:
3. If an outcome class needs renaming or a tension surface gets a
maintainer-decision, update the taxonomy sections.

This file is itself current-state operational substrate: it should
reflect the corpus state, not the historical sequence in which
patterns were discovered.
This file is a **synthesis-index over a history-class corpus** —
the per-PR `*-drain-log.md` files in this directory are the
history-class records (preserve names, point-in-time records,
provenance, Otto-279 carve-out applies), and this `_patterns.md`
is the current-state-tracking abstraction over them. The two
surface classes coexist in the same directory by design:

- `docs/pr-preservation/*-drain-log.md` — **history-class** per-PR
records (per the surface-class taxonomy above; Otto-279 carve-out
applies; first-name attribution preserves provenance).
- `docs/pr-preservation/_patterns.md` (this file) —
**current-state synthesis-index** that should reflect the corpus
state, not the historical sequence in which patterns were
discovered. This is a third surface class — *synthesis-over-
history* — distinct from both pure history-class and pure
current-state surfaces.
Comment thread
AceHack marked this conversation as resolved.
Outdated

The directory-level surface-class declaration in the
"Surface-class taxonomy" section above applies to the per-log
records; the index file is explicitly carved out as a synthesis-
Comment thread
AceHack marked this conversation as resolved.
Outdated
index. The underscore prefix (`_patterns.md`) is a candidate
naming convention for "synthesis-indices over history-class
corpora" — when the convention matures, it could be promoted to
a named pattern itself.
Comment thread
AceHack marked this conversation as resolved.
Outdated

## Reference patterns

Expand Down
Loading