Kjell Tore Guttormsen
baff890789
Documents the 4-track procedure for updating plugin playground HTML when plugins are extended or upgraded: - Track A: Plugin HTML change (parsers, renderers, surfaces) - Track B: Shared design-system change (with vendor sync) - Track C: Visual verification (screenshots + manual QA) - Track D: Release (version bump + 3-doc rule) Lives at marketplace root because the procedure crosses the plugin/shared boundary. Marketplace-root CLAUDE.md gets a one-line pointer under Konvensjoner so Claude finds it automatically in future sessions. Includes architecture diagram, common pitfalls (replace_all scope, sync-without-testing, screenshot folder version mismatch, background orchestrator degradation), and guidance on when to hoist inline CSS to the shared DS vs keep it plugin-local. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
55 lines
3.2 KiB
Markdown
55 lines
3.2 KiB
Markdown
# ktg-plugin-marketplace
|
|
|
|
Open-source Claude Code plugin marketplace. Solo project by Kjell Tore Guttormsen.
|
|
|
|
## Repo-struktur
|
|
|
|
```
|
|
plugins/
|
|
ai-psychosis/ v1.0.0 — Interaction awareness (sycophancy, reinforcement loops)
|
|
config-audit/ v3.1.0 — Configuration intelligence (health, opportunities, auto-fix, whats-active)
|
|
graceful-handoff/ v2.1.0 — Auto-trigger handoff via Stop hook (skill + JSON pipeline + 4-step model-aware context resolution)
|
|
linkedin-thought-leadership/ v1.2.0 — LinkedIn content pipeline + analytics
|
|
llm-security/ v6.0.0 — Security scanning, auditing, threat modeling
|
|
ms-ai-architect/ v1.8.0 — Microsoft AI architecture (Cosmo Skyberg persona)
|
|
okr/ v1.0.0 — OKR guidance for Norwegian public sector
|
|
ultraplan-local/ v3.4.0 — Brief, research, plan, execute, review, continue (six-command universal pipeline + multi-session resumption + --gates autonomy chain)
|
|
|
|
shared/
|
|
playground-design-system/ v0.1 — Aksel/Digdir-aligned CSS design system + JSON schemas + self-hosted Inter/JetBrains Mono/Source Serif 4 fonts (Tier 1+2+3 wave 1+wave 2 = 20 Tier 3 components total). Consumed by ms-ai-architect, okr, llm-security, ultraplan-local, config-audit
|
|
playground-examples/ — Reference scenarios (ROS-Lier, OKR-Bærum, security-Direktorat) + showcase landing + 12 isolated Tier 3 wave 2 component demos under components/
|
|
```
|
|
|
|
Hvert plugin er selvstendig med egen CLAUDE.md, README, hooks, agents og commands. `shared/` inneholder marketplace-nivå infrastruktur som flere plugins bygger på.
|
|
|
|
## Konvensjoner
|
|
|
|
- **Språk:** Norsk dialog, engelsk kode/docs
|
|
- **Commits:** Conventional Commits — `type(scope): description`
|
|
- **Git:** Forgejo (`git.fromaitochitta.com/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).
|
|
|
|
## Sesjonsfiler (lokale, gitignored)
|
|
|
|
Alle plugins + root har:
|
|
- `REMEMBER.md` — Sesjonsstatus, sist gjort, viktige beslutninger
|
|
- `TODO.md` — Nærliggende oppgaver (1-4 uker)
|
|
- `ROADMAP.md` — Langsiktig retning (kvartal/halvår)
|
|
|
|
Disse trackes IKKE i git. Oppdater ved sesjonsslutt.
|
|
|
|
## Arbeidsflyt
|
|
|
|
1. `cd` til riktig plugin-mappe
|
|
2. Les pluginets CLAUDE.md for kontekst
|
|
3. Les REMEMBER.md og TODO.md for sesjonsstatus
|
|
4. Jobb innenfor scope
|
|
5. Oppdater REMEMBER.md ved avslutning
|