From cdb897a6397d5101ecb7a20650c890da90db8d06 Mon Sep 17 00:00:00 2001
From: Kjell Tore Guttormsen <hello@fromaitochitta.com>
Date: Thu, 18 Jun 2026 10:26:15 +0200
Subject: [PATCH] docs(conventions): reframe docs-gate + playground refs for
 polyrepo split

---
 CONVENTIONS.md | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/CONVENTIONS.md b/CONVENTIONS.md
index 39b3551..571e5c5 100644
--- a/CONVENTIONS.md
+++ b/CONVENTIONS.md
@@ -7,14 +7,13 @@
 
 - **Språk:** Norsk dialog, engelsk kode/docs
 - **Commits:** Conventional Commits — `type(scope): description`
-- **Git:** Forgejo (`git.fromaitochitta.com/open/ktg-plugin-marketplace`). Aldri GitHub.
+- **Git:** Forgejo-org `git.fromaitochitta.com/open/` — hvert plugin/design-system er sitt eget repo (`open/<navn>`), katalogen er `open/ktg-plugin-marketplace`. Aldri GitHub.
 - **Hooks:** Alltid Node.js (.mjs), aldri bash. Cross-platform.
 - **Avhengigheter:** Null npm dependencies i hooks/scannere. `node:test` for tester.
 - **Bidrag:** Issues velkommen som signaler. PRs ikke akseptert. Fork-and-own er anbefalt adopsjonsmodell — se `GOVERNANCE.md`.
 - **Lisens:** MIT, alle plugins
-- **Docs ved endring (OBLIGATORISK):** Enhver feature-endring som pusher til Forgejo MÅ oppdatere alle tre doc-nivåer i SAMME commit eller umiddelbart etter:
-  1. Plugin `README.md` — detaljert dokumentasjon av endringen
-  2. Plugin `CLAUDE.md` — arkitektur/oversikt
-  3. Rot-`README.md` — marketplace-landingssiden (`git.fromaitochitta.com/open/ktg-plugin-marketplace`)
-- **Playground-oppdatering:** Ved endring av plugin playground HTML eller delt design-system, følg prosedyren i `shared/PLAYGROUND-MAINTENANCE.md` (4 spor: HTML-endring, DS-endring, screenshots, release).
+- **Docs ved endring (OBLIGATORISK):** Enhver feature-endring som pusher til Forgejo MÅ oppdatere dokumentasjonen. Etter polyrepo-splittet er dette to nivåer i to repo:
+  1. **I plugin-repoet** (SAMME commit): `README.md` (detaljert dokumentasjon av endringen) + `CLAUDE.md` (arkitektur/oversikt)
+  2. **I katalog-repoet** (`open/ktg-plugin-marketplace`), ved versjonsbump eller endret entry: oppdater `README.md`-landingssiden og `ref` i `.claude-plugin/marketplace.json` (egen commit i katalog-repoet)
+- **Playground / design-system:** Playground-HTML er vendored inn i hvert plugin-repo under `playground/vendor/playground-design-system/`. Endringer i det delte design-systemet gjøres i `open/playground-design-system`, tagges der, og re-vendres deretter inn i hver konsument (llm-security, ms-ai-architect, config-audit, okr, voyage).