instructions/CONTRACT.md: die Imperativ-Titel-Regel gilt Instructions, nicht dem H1 eines SKILL.md
#71
Reference in New Issue
Block a user
Delete Branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Ergebnis
Die Regel wurde praezisiert, die fuenf Skill-Titel bleiben unveraendert. Umgesetzt in
663b1c0, Version4.8.0-beta.10.instructions/CONTRACT.md§ "Writing an instruction" traegt jetzt:instructions/<name>.mdform only - a skill's H1 is a different case, below";name:-Frontmatter), der Begruendung und dem Abschlusssatz "That is the whole exception. Everything else in this section binds aSKILL.mdexactly as it binds an instruction" - damit ist auch die Gegenfrage beantwortet, was am Skill sonst noch anders waere: nichts.Befund (unveraendert gueltig)
instructions/CONTRACT.md§ "Writing an instruction" verlangte: "Imperative title. It answers 'what does this tell me to do?'". Alle fuenf Skills verletzten das dem Wortlaut nach:# Wiki Ingest,# Wiki Lint,# Wiki Manage,# Wiki Query,# Wiki Statussind Nomenphrasen.Die Pruefung gegen die Primaerquelle ergab, dass die Regel zu weit griff, nicht dass die fuenf Dateien zu locker waren:
nameunddescription. Zur Ueberschrift im Body steht dort nichts.# PDF Processing,# BigQuery Data Analysis,# DOCX Processing- genau die Nomenphrase, die die Regel verbieten wuerde.description; die wird beim Start in den System-Prompt geladen, der Body erst beim Zugriff.Der Abschnitt heisst "Writing an instruction" und steht in einem Dokument, das Instruction und Skill sonst sauber trennt ("Two forms, three reference tiers"). Die Regel war fuer
instructions/<name>.mdgeschrieben; dass sie auch aufSKILL.mdgelesen wurde, war eine Nebenwirkung der Platzierung.Zusaetzlicher Beleg, in der Umsetzungssitzung gefunden: der vendorierte
commonplace-Korpus traegt incommonplace/kb/instructions/COLLECTION.md:23dieselbe Imperativ-Titel-Regel - unabhaengig entstanden - und macht im selben Absatz dieselbe Ausnahme: "For promoted skills, the skill name is the title (write/SKILL.md)." Ein zweiter Stack kam ohne Kenntnis dieses Issues zum selben Ergebnis. Der Satz steht jetzt mit im Contract.Akzeptanzkriterien
instructions/CONTRACT.mdsagt ausdruecklich, ob die Imperativ-Titel-Regel fuerinstructions/<name>/SKILL.mdgilt. Aus dem Text allein - ohne Kenntnis dieses Issues - ist die Frage beantwortbar: das Bullet schraenkt sich selbst ein und verweist nach unten, der Unterabschnitt beantwortet sie.instructions/wiki-*/SKILL.mdsind unveraendert.git show --stat 663b1c0listet nurinstructions/CONTRACT.md,instructions/wiki-ingest/SKILL.md(Schritte 1 und 6, aus #79 - der H1 nicht),CHANGES.md,VERSION.tools/wikitool instructions verifyundtools/wikitool docs verifylaufen ohne neue Findings. Dazupytest: 1076 passed.Geaendert
instructions/CONTRACT.md§ "Writing an instruction" - Bullet 1 und neuer Unterabschnitt "A skill's H1 is a name, not an imperative".Herkunft
Analyse aus #65 (Fund 3), Sitzung 2026-09-09. #65 stellte die Frage offen ("gilt die Instruction-Titelregel 1:1 fuer den Skill-H1, oder ist der Skill-Titel ein eigener Fall"); die Primaerquelle wurde im Volltext geprueft und die Entscheidung vom Operator bestaetigt. Umgesetzt in derselben Sitzung wie #72 und #79, die auf denselben Abschnitt zeigten.
torben referenced this issue2026-09-09 12:29:25 +00:00
Changelog: Body auf Endstand. Entscheidungsabschnitt wurde zu "Ergebnis" mit dem, was tatsaechlich im Contract steht; alle vier Akzeptanzkriterien abgehakt mit Nachweis. Neu im Befund: der unabhaengige Beleg aus
commonplace/kb/instructions/COLLECTION.md:23, der dieselbe Ausnahme macht - in der Umsetzungssitzung gefunden, dem Issue vorher unbekannt. Umgesetzt in663b1c0,4.8.0-beta.10. Geschlossen.