Kjell Tore Guttormsen
2e0892cdaf
The v5.0.0 stop-gap had /trekbrief, /trekplan, and /trekreview each render
a read-only {artifact}.html (via scripts/render-artifact.mjs) AND print a
vague "run the /playground plugin" instruction. In practice the read-only
HTML was redundant with what /playground produces and the instruction
wasn't copy-paste-ready — the operator had to guess the right invocation.
v5.0.1 deletes scripts/render-artifact.mjs + its test + npm run render,
and makes each producing command end with a single boxed, literal,
copy-paste-ready line:
/playground build a document-critique playground for {artifact_path}
One paste from the operator launches the official playground skill's
document-critique template, which builds an interactive HTML — artifact
on the left, per-line Approve/Reject/Comment cards on the right, Copy
Prompt button at the bottom. Mark suggestions, click Copy Prompt, paste
back, Claude revises the .md. Doc-consistency test pins the literal
invocation so the prose cannot soften back into vagueness.
npm test green: 503 tests, 501 pass, 0 fail, 2 skipped.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
55 lines
3.7 KiB
Markdown
55 lines
3.7 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.13.1 — Microsoft AI architecture (Cosmo Skyberg persona) + manual KB-refresh slash command
|
|
okr/ v1.0.0 — OKR guidance for Norwegian public sector
|
|
voyage/ v5.0.1 — Brief, research, plan, execute, review, continue. Contract-driven Claude Code pipeline (six-command universal pipeline + multi-session resumption + --gates autonomy chain). At the end of /trekbrief, /trekplan, and /trekreview, the operator gets a literal copy-paste-ready `/playground build a document-critique playground for {artifact_path}` invocation — one paste launches an interactive annotation HTML, Copy Prompt button returns the operator notes to Claude, Claude revises the .md. v5.0.0 removed the v4.2/v4.3 bespoke playground + /trekrevise + Handover 8; v5.0.1 dropped the redundant standalone HTML render (`render-artifact.mjs`) and made the /playground invocation literal.
|
|
|
|
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, voyage, 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
|