ktg-plugin-marketplace/CONVENTIONS.md

1.7 KiB

Conventions — ktg-plugin-marketplace catalog

Extracted from the marketplace CLAUDE.md (D6). These are the marketplace-wide conventions every plugin repo inherits under fork-and-own. See GOVERNANCE.md for the governance model.

Konvensjoner

  • Språk: Norsk dialog, engelsk kode/docs
  • Commits: Conventional Commits — type(scope): description
  • 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 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).