Skip to content

Commit ff259f1

Browse files
raifdmuellerclaude
andcommitted
docs: update rejected proposals — link to Semantic Contracts
- TLDR → now "Concise Response" contract (BLUF + Strunk & White) - ELI5 → now "Simple Explanation" contract (Feynman Technique) - Spec-Driven Development → now "Specification" + "Requirements Discovery" - Explicit Contract Surface → now "Layer Boundaries" contract - Added tip: rejected anchors can live on as Semantic Contracts Updated both EN and DE versions. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 2abc833 commit ff259f1

2 files changed

Lines changed: 40 additions & 4 deletions

File tree

docs/rejected-proposals.adoc

Lines changed: 20 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -23,18 +23,36 @@ A real methodology but too specialized for reliable activation across different
2323

2424
| *TLDR*
2525
| Structurally unsuitable
26-
| Underspecified instruction with no defined structure. Just means "be brief" without any framework for how. Not a methodology.
26+
| Underspecified instruction with no defined structure. Just means "be brief" without any framework for how. Not a methodology. +
27+
*Now available as link:#/contracts[Semantic Contract]*: "Concise Response" — composes BLUF + Strunk & White.
2728

2829
| *ELI5* (Explain Like I'm 5)
2930
| Structurally unsuitable
30-
| Vague target level with no pedagogical framework. No consistent interpretation of what "5-year-old level" means technically.
31+
| Vague target level with no pedagogical framework. No consistent interpretation of what "5-year-old level" means technically. +
32+
*Now available as link:#/contracts[Semantic Contract]*: "Simple Explanation" — composes Feynman Technique.
33+
34+
| *Spec-Driven Development* (https://github.com/LLM-Coding/Semantic-Anchors/pull/356[#356])
35+
| Structurally unsuitable
36+
| Relevant concept but no single canonical definition — different people mean different things (API-first, formal specs, our workflow). Not attributable to a specific proponent. +
37+
*Now available as link:#/contracts[Semantic Contracts]*: "Specification" + "Requirements Discovery" — composes Gherkin, BDD, Socratic Method, MECE, PRD.
38+
39+
| *Explicit Contract Surface* (https://github.com/LLM-Coding/Semantic-Anchors/pull/357[#357])
40+
| Structurally unsuitable
41+
| Well-described design practice but not an established term in the literature. Combines existing anchors (Clean Architecture, Hexagonal, DDD, SOLID DIP/ISP) without adding new activation. +
42+
*Now available as link:#/contracts[Semantic Contract]*: "Layer Boundaries".
3143

3244
| *MIRRR UX Framework* (https://github.com/LLM-Coding/Semantic-Anchors/issues/150[#150])
3345
| Not in training data
3446
| A real UX framework with defined methodology, but not widely enough documented for LLMs to reliably recognize it and activate the correct concepts.
3547

3648
|===
3749

50+
[TIP]
51+
====
52+
Terms that don't qualify as semantic anchors can still be useful as link:#/contracts[Semantic Contracts].
53+
A contract defines what a term means in your project — either by composing established anchors or by providing custom definitions that only exist within your team.
54+
====
55+
3856
== How We Evaluate
3957

4058
Every proposal is tested against our four quality criteria:

docs/rejected-proposals.de.adoc

Lines changed: 20 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -23,18 +23,36 @@ Eine echte Methodik, aber zu spezialisiert für zuverlässige Aktivierung über
2323

2424
| *TLDR*
2525
| Strukturell ungeeignet
26-
| Unterspezifizierte Anweisung ohne definierte Struktur. Bedeutet nur "fasse dich kurz" ohne ein Framework dafür. Keine Methodik.
26+
| Unterspezifizierte Anweisung ohne definierte Struktur. Bedeutet nur "fasse dich kurz" ohne ein Framework dafür. Keine Methodik. +
27+
*Jetzt verfügbar als link:#/contracts[Semantic Contract]*: "Concise Response" — kombiniert BLUF + Strunk & White.
2728

2829
| *ELI5* (Explain Like I'm 5)
2930
| Strukturell ungeeignet
30-
| Vages Zielniveau ohne pädagogisches Framework. Keine konsistente Interpretation dessen, was "Niveau eines 5-Jährigen" technisch bedeutet.
31+
| Vages Zielniveau ohne pädagogisches Framework. Keine konsistente Interpretation dessen, was "Niveau eines 5-Jährigen" technisch bedeutet. +
32+
*Jetzt verfügbar als link:#/contracts[Semantic Contract]*: "Simple Explanation" — nutzt die Feynman-Technik.
33+
34+
| *Spec-Driven Development* (https://github.com/LLM-Coding/Semantic-Anchors/pull/356[#356])
35+
| Strukturell ungeeignet
36+
| Relevantes Konzept, aber keine einheitliche Definition — verschiedene Interpretationen (API-first, formale Specs, unser Workflow). Nicht einem konkreten Urheber zuordenbar. +
37+
*Jetzt verfügbar als link:#/contracts[Semantic Contracts]*: "Specification" + "Requirements Discovery" — kombiniert Gherkin, BDD, Sokratische Methode, MECE, PRD.
38+
39+
| *Explicit Contract Surface* (https://github.com/LLM-Coding/Semantic-Anchors/pull/357[#357])
40+
| Strukturell ungeeignet
41+
| Gut beschriebene Design-Praxis, aber kein etablierter Begriff in der Literatur. Kombiniert bestehende Anker (Clean Architecture, Hexagonal, DDD, SOLID DIP/ISP) ohne neue Aktivierung. +
42+
*Jetzt verfügbar als link:#/contracts[Semantic Contract]*: "Layer Boundaries".
3143

3244
| *MIRRR UX Framework* (https://github.com/LLM-Coding/Semantic-Anchors/issues/150[#150])
3345
| Nicht in Trainingsdaten
3446
| Ein echtes UX-Framework mit definierter Methodik, aber nicht weit genug dokumentiert, damit LLMs es zuverlässig erkennen und die richtigen Konzepte aktivieren.
3547

3648
|===
3749

50+
[TIP]
51+
====
52+
Begriffe, die nicht als Semantic Anchors qualifizieren, können trotzdem als link:#/contracts[Semantic Contracts] nützlich sein.
53+
Ein Contract definiert, was ein Begriff in deinem Projekt bedeutet — entweder durch Komposition etablierter Anker oder durch eigene Definitionen, die nur in deinem Team existieren.
54+
====
55+
3856
== Wie wir bewerten
3957

4058
Jeder Vorschlag wird gegen unsere vier Qualitätskriterien getestet:

0 commit comments

Comments
 (0)