content: four concept pages tagged guideline; the template's guideline filter is a default, not a setup question (#179)
CI / verify (push) Successful in 5m45s
CI / pwsh (push) Successful in 1m58s
Release / release (push) Successful in 33s

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 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SnAJ7Z3CpVD3PRbN73QtU2
This commit is contained in:
torbenandClaude Opus 5.5 committed 2026-10-06 07:03:49 +02:00
1 parent 283cdae8be
commit 40839d956d
9 files changed
+28 -9

No files matched your search

+12 -1
View File
@@ -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
<!-- /wikitool:bumps -->
### 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
+1 -1
View File
@@ -1 +1 @@
8.0.0-beta.44
8.0.0-beta.45
+1 -1
View File
@@ -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
+4 -2
View File
@@ -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
@@ -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:
@@ -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:
@@ -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:
@@ -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:
+6
View File
@@ -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]].
---