# Claude Code-plugin — sjekkliste Fase-exit-kriterier for en plugin i ktg-privat-mønsteret. En `[skip]`-merket linje begrunnes i `00-context/pack-overrides.md`. ## A. Struktur & manifest - [ ] `.claude-plugin/plugin.json` finnes, gyldig JSON, `auto_discover: true`. - [ ] Mappestruktur følger mønsteret (`commands/`, `agents/`, `skills/`, `hooks/`, `templates/` etter behov). - [ ] `README.md` finnes og beskriver plugin-formål + hovedcommand. - [ ] `CLAUDE.md` finnes, **< 100 linjer**, tabell-basert. - [ ] `*.local.md` i `.gitignore`. - [ ] **`plugin-dev:plugin-validator` kjørt og passerer** (struktur, frontmatter, cross-komponent-koherens). ## B. Navnekonvensjoner - [ ] Commands: `command.md` → `/plugin:command`. - [ ] Agents: `descriptive-name-agent.md`. - [ ] Skills: `skill-name/SKILL.md` (+ `references/*.md` ved behov). ## C. Frontmatter - [ ] Hver command har `name`, `description`, `allowed-tools`, `model`. - [ ] Hver agent har `name`, multi-line `description` med **when-to-use** + eksempler, `model`, `color`, `tools`. - [ ] Hver skill har `name` + en `description` som beskriver hva **og når** (triggering-effektiv — kjør `plugin-dev:skill-reviewer`). ## D. Hooks (hvis pluginen har hooks) - [ ] `hooks/hooks.json` finnes; `hooks` er et **objekt** med event-nøkler. - [ ] `matcher` er en string, ikke et objekt. - [ ] Stier bruker `${CLAUDE_PLUGIN_ROOT}`. - [ ] `"hooks"` er **ikke** deklarert i `plugin.json`. - [ ] Hook-scripts er `.mjs` (eller bash 3.2-kompatible hvis bash er nødvendig). - [ ] Hver hook står i `CLAUDE.md`s hook-tabell (event, script, formål). ## E. Context-budget - [ ] Ingen agent-invokasjon laster > 3 knowledge-filer. - [ ] Ingen hele-katalog-lasting — spesifikke filer navngis. - [ ] Registrerte `subagent_type` brukes (ikke `general-purpose` + "les agentfilen"). - [ ] Sekvensiell agent-spawning som default (parallell begrunnet der brukt). - [ ] SKILL.md bruker progressive disclosure. ## F. Dokumentasjon & kvalitet - [ ] `CLAUDE.md` har alle påkrevde seksjoner: tittel/beskrivelse, commands-tabell, agents-tabell, hooks-tabell, arkitektur, state-håndtering (hvis relevant). - [ ] `CLAUDE.md` scorer **Grade B (70+/100)** på config-audit-kvalitetsvurderingen. - [ ] `CLAUDE.md`-oppdatering er i **samme commit** som endringen den dokumenterer. - [ ] Linear-label dokumentert i `CLAUDE.md` (hvis konvensjonen gjelder). ## G. Commit & release - [ ] Conventional Commits (`type(scope): beskrivelse`). - [ ] Versjonsbump → alle versjons-refererende filer oppdatert i samme commit (`plugin.json`, README-badges, CHANGELOG, konstanter). - [ ] Committet + pushet (Forgejo, ikke GitHub). - [ ] Marketplace-sync hvis pluginen er nyregistrert/omdøpt. ## H. Røyktest - [ ] Alle slash-commands kjører uten feil. - [ ] Agenter triggerer på sine beskrevne situasjoner. - [ ] Hooks fyrer og oppfører seg som forventet (ingen falske positiver som blokkerer arbeid).