From 40839d956d491c3ab60532c30d9ea228243a280e Mon Sep 17 00:00:00 2001 From: Torben Nehmer Date: Tue, 6 Oct 2026 07:03:49 +0200 Subject: [PATCH] content: four concept pages tagged guideline; the template's guideline filter is a default, not a setup question (#179) Files changed: - CHANGES.md - VERSION - kb/CONVENTIONS.md - kb/CONVENTIONS.md.template - kb/concepts/decisions/Diff-Reviewable Agent Edits.md - kb/concepts/decisions/Structural Enforcement over Documented Rule.md - kb/concepts/problems/Ambient Environment Dependency.md - kb/concepts/problems/Green Suite Blind Spot.md - kb/log.md Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01SnAJ7Z3CpVD3PRbN73QtU2 --- CHANGES.md | 13 ++++++++++++- VERSION | 2 +- kb/CONVENTIONS.md | 2 +- kb/CONVENTIONS.md.template | 6 ++++-- .../decisions/Diff-Reviewable Agent Edits.md | 2 +- .../Structural Enforcement over Documented Rule.md | 2 +- .../problems/Ambient Environment Dependency.md | 2 +- kb/concepts/problems/Green Suite Blind Spot.md | 2 +- kb/log.md | 6 ++++++ 9 files changed, 28 insertions(+), 9 deletions(-) diff --git a/CHANGES.md b/CHANGES.md index 1ba4bda..f57ac32 100644 --- a/CHANGES.md +++ b/CHANGES.md @@ -59,7 +59,7 @@ concern - readable here, never shipped as something to parse. --- -## 8.0.0-beta.44 - 2026-10-06 - export guidelines: the guideline pages as a generated GUIDELINES.md, pushed into the captured repositories behind the Guideline Push Gate +## 8.0.0-beta.45 - 2026-10-06 - kb/CONVENTIONS.md.template: the guideline filter is a default, not a setup question **Author:** Torben Nehmer @@ -155,8 +155,19 @@ concern - readable here, never shipped as something to parse. - kb/CONTRACT.md names unwritten scaffold sections and the Unfilled Template Sections finding - wiki-ingest and wiki-manage call xref add with --rel, not the --rel-a/--rel-b removed in 4.0.0 - raw accept: an occupied folder name held by a captured bundle points at --replaces-bundle +- kb/CONVENTIONS.md.template: the guideline filter is a default, not a setup question +### kb/CONVENTIONS.md.template: the guideline filter is a default, not a setup question + +The ยง Guidelines for other repositories section shipped with a `{...}` placeholder, and +`setup-instance.md` reads every placeholder in that template as a question to put to the user - +so the export's filter had quietly become a new setup question, one a fresh instance with no +pages cannot sensibly answer and `INSTALL.md` does not list. The section now states a default, +`--tag guideline`, to be changed in place once the instance decides otherwise. This instance's +own `kb/CONVENTIONS.md` points at `search --tag guideline` for the pages that carry the tag; four +concept pages now do (Gitea #179). + ### export guidelines: the guideline pages as a generated GUIDELINES.md, pushed into the captured repositories behind the Guideline Push Gate The other direction of `raw capture`. Project repositories each carried their own copy of the diff --git a/VERSION b/VERSION index 40a5ab9..fe74fa4 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -8.0.0-beta.44 +8.0.0-beta.45 diff --git a/kb/CONVENTIONS.md b/kb/CONVENTIONS.md index 1e0b0f3..997ad31 100644 --- a/kb/CONVENTIONS.md +++ b/kb/CONVENTIONS.md @@ -151,7 +151,7 @@ is written down here and nowhere else. **The filter is `--tag guideline`.** A page carries the tag when its content is a rule an agent working in another repository should follow there as it stands - written so that it reads without its links and citations, because the export turns `[[links]]` into plain text and drops every -footnote. No page in this corpus carries it yet. +footnote. `tools/wikitool search --tag guideline` lists the pages that carry it. ## Keeping this file honest diff --git a/kb/CONVENTIONS.md.template b/kb/CONVENTIONS.md.template index 21a63f9..4d3eb3b 100644 --- a/kb/CONVENTIONS.md.template +++ b/kb/CONVENTIONS.md.template @@ -120,8 +120,10 @@ disagreement between sources.} no type or field for a guideline - which pages are guidelines is this instance's decision, and it is written down here and nowhere else. -{The selection, as `search` predicates - for example `--tag guideline` - or "none" if this -instance exports no guidelines.} +**The filter is `--tag guideline`.** A page carries the tag when its content is a rule an agent +working in another repository should follow there as it stands. This is a default, not a setup +question: a new instance has no pages to choose from yet. Change the filter here once this +instance decides differently - nothing else has to follow. ## Keeping this file honest diff --git a/kb/concepts/decisions/Diff-Reviewable Agent Edits.md b/kb/concepts/decisions/Diff-Reviewable Agent Edits.md index 49779a6..b2a1146 100644 --- a/kb/concepts/decisions/Diff-Reviewable Agent Edits.md +++ b/kb/concepts/decisions/Diff-Reviewable Agent Edits.md @@ -1,7 +1,7 @@ --- type: types/concept.md concept_type: decision -tags: [agent-workflow, context-engineering, tooling] +tags: [agent-workflow, context-engineering, tooling, guideline] created: 2026-08-31 modified: 2026-08-31 related: diff --git a/kb/concepts/decisions/Structural Enforcement over Documented Rule.md b/kb/concepts/decisions/Structural Enforcement over Documented Rule.md index 3c90463..a407974 100644 --- a/kb/concepts/decisions/Structural Enforcement over Documented Rule.md +++ b/kb/concepts/decisions/Structural Enforcement over Documented Rule.md @@ -1,7 +1,7 @@ --- type: types/concept.md concept_type: decision -tags: [quality, tooling, tests, governance] +tags: [quality, tooling, tests, governance, guideline] created: 2026-08-31 modified: 2026-08-31 related: diff --git a/kb/concepts/problems/Ambient Environment Dependency.md b/kb/concepts/problems/Ambient Environment Dependency.md index f652fd4..be9d2ff 100644 --- a/kb/concepts/problems/Ambient Environment Dependency.md +++ b/kb/concepts/problems/Ambient Environment Dependency.md @@ -1,7 +1,7 @@ --- type: types/concept.md concept_type: problem -tags: [tests, ci, tooling, quality] +tags: [tests, ci, tooling, quality, guideline] created: 2026-08-31 modified: 2026-08-31 related: diff --git a/kb/concepts/problems/Green Suite Blind Spot.md b/kb/concepts/problems/Green Suite Blind Spot.md index 7031a33..11ab432 100644 --- a/kb/concepts/problems/Green Suite Blind Spot.md +++ b/kb/concepts/problems/Green Suite Blind Spot.md @@ -1,7 +1,7 @@ --- type: types/concept.md concept_type: problem -tags: [tests, regression, tooling, quality] +tags: [tests, regression, tooling, quality, guideline] created: 2026-08-31 modified: 2026-08-31 related: diff --git a/kb/log.md b/kb/log.md index 5686259..a9b8f44 100644 --- a/kb/log.md +++ b/kb/log.md @@ -245,3 +245,9 @@ Demo-Projektseiten nach Gitea #156 (E1): completed aus Gitea #119/#124, dormant entity_type person -> organization (neuer Subtyp, Gitea #172); Seite nach kb/entities/organizations/ verschoben, Typ-Zeile angepasst. --- + +## [2026-10-06] update | Guideline tag for export guidelines + +Tagged guideline (the filter kb/CONVENTIONS.md names for export guidelines): [[Diff-Reviewable Agent Edits]], [[Structural Enforcement over Documented Rule]], [[Green Suite Blind Spot]], [[Ambient Environment Dependency]] - general rules for agent and test work in any repository. Left out as tied to this wiki's tooling: [[Command Round-Trip Integrity]], [[Delete Rather Than Anonymize]]. + +---