FÜR NEUE KOLLEGEN. UND DIE, DIE ALLES ERKLÄREN.
„Frag am besten Thomas.“ Thomas ist seit März weg.
Die ersten Wochen bestehen aus Fragen, die schon hundertmal beantwortet wurden — mündlich, also nirgends. Mit FACET steht die Antwort neben dem Code, den sie erklärt. Die Neue liest nach, statt zu warten.
ATLAS FRAGEN
Wann endet ein gekündigter Vertrag?
- liest contracts/lifecycle/cancellation.yaml
- liest src/contracts/cancel.go
- liest test/contracts/cancel_test.go
Zum Ende der laufenden Vertragsperiode, nicht sofort. Eine Kündigung setzt ends_at auf das Periodenende; bis dahin bleibt der Vertrag aktiv.
Quellen
- Szenario
- cancellation-ends-at-period-end
- Code
- src/contracts/cancel.go:42
- Test
- cancel_test.go › ends at period end
Illustrative Skizze · aus Bausteinen gezeichnet, kein Screenshot
VIER FRAGEN AM ERSTEN TAG
Vier Fragen. Jede Woche dieselben.
Wer weiß das? Wo steht das? Warum ist das so? Gilt das noch? Für jede dieser Fragen hat ein Feature in FACET eine feste Stelle — neben dem Code, nicht im Kopf von drei Leuten.
Wer weiß das?
lineageDer Owner des Features steht im Record. Dazu, wovon es abhängt und was von ihm abhängt.
Wo steht das?
anchorJede Quelldatei, die das Feature umsetzt, trägt einen @facet:-Anker. Der Record zeigt auf sie zurück.
Warum ist das so?
intent · knowledgeIntent sagt, wofür das Feature da ist. Knowledge beantwortet die Fragen, die Nutzer dazu stellen.
Gilt das noch?
verificationWelcher Test welches Szenario belegt. Ändert sich der Code ohne den Record, meldet es facet drift.
Die sieben Facetten eines Records: intent, contract, anchor, verification, observation, knowledge, lineage
ÜBERGABE
Thomas ist weg. Sein Wissen nicht.
FACET hält fest, was ein Feature tun soll, wo es im Code steht und welcher Test es prüft. Neue Kollegen und neue Agents fangen dort an, statt die erfahrensten Entwickler mit jeder Frage zu unterbrechen.
id: contracts/lifecycle/cancellationintent: summary: A cancelled contract runs to the end of its current period.knowledge: common_pitfalls: question: What mistakes do users typically make? answer: Expecting access to stop on the day they cancel. success_signal: question: How does the user know it worked? answer: The contract shows its end date instead of a renewal date.
Illustratives Beispiel · ein Ausschnitt, kein vollständiger Record
Wer denselben Record liest
- Die neue Kollegin, am ersten Tag, ohne jemanden zu unterbrechen.
- Der Coding-Agent, bevor er die Kündigungslogik anfasst.
- Der Mensch, der es bisher jedes Mal erklärt hat — nur noch dort, wo der Record schweigt.
WAS FACET HIER NICHT TUT
Eine offene Frage bleibt sichtbar offen.
Unbeantwortete Fragen bleiben unbeantwortet, bis jemand das Wissen ergänzt.