commit 98b15c75ee08122cfac21bead792e0d08c2bfa57
Author: Kjell Tore Guttormsen <hello@fromaitochitta.com>
Date:   Sat May 16 21:01:45 2026 +0200

    docs: add Communication patterns section to all plugin CLAUDE.md
    
    Standardize named-markdown-link guidance across all plugins so file://
    references render as independently clickable links in terminals like
    Ghostty (bare file:// URLs only make the first clickable).
    
    Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..ec7a807
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,60 @@
+# claude-design
+
+## Kontekst
+
+Plugin som skal være ekspert på **Claude Design** (claude.ai/design) — Anthropics surface for å lage interaktive artifacts via prompt.
+
+Skal dekke hele prosessen fra idé til ferdig artifact:
+
+1. Forstå hva brukeren vil lage
+2. Velge riktig artifact-type og prompt-strategi
+3. Generere effektive prompts for Claude Design
+4. Iterere og refine basert på preview
+5. Polere og levere
+
+Den endelige sammensetningen — skills, agenter, kommandoer — defineres gjennom Voyage-pipelinen og er IKKE fastlagt på forhånd.
+
+## Status
+
+`0.1.0-pre` — bootstrap. Innholdet bygges via `/trekbrief` → `/trekresearch` → `/trekplan` → `/trekexecute` → `/trekreview`.
+
+## Marketplace-kontekst
+
+Plugin ligger inne i `ktg-plugin-marketplace`. Ingen egen git-repo, ingen egen Forgejo-remote. Alle commits til marketplace-repoet på `git.fromaitochitta.com/open/ktg-plugin-marketplace`.
+
+Følg marketplace-konvensjonene fra rot-CLAUDE.md:
+
+- Norsk dialog, engelsk kode/dokumentasjon
+- Conventional Commits: `type(scope): description` — scope er `claude-design`
+- Hooks i Node.js (.mjs), ikke bash
+- Null npm-avhengigheter i hooks
+- Docs-trippel oppdatert i samme commit ved feature-endringer: plugin `README.md`, plugin `CLAUDE.md`, rot-`README.md`
+
+## Arbeidsflyt
+
+Pipelinen er sannhet inntil release:
+
+1. Brief lukker scope og scope-grenser
+2. Research samler eksterne kilder (Anthropic cookbook, claude.ai/design-dokumentasjon, community-mønstre)
+3. Plan beskriver fil-for-fil hva som skal lages
+4. Execute leverer kode/innhold
+5. Review er release-gate
+
+Voyage-policy: Opus på alle sub-agenter og orchestrator-faser.
+
+## Communication patterns
+
+### Linking to local files
+
+When pointing to local files in responses, always use markdown link syntax with a descriptive name:
+
+- Use `[Human-friendly name](file:///absolute/path)` — never bare `file:///...` URLs or autolinks `<file://...>`.
+- Always use absolute paths. Never `~/` or relative paths.
+- For multiple files, render as a bullet list of named markdown links.
+
+Why: bare `file://` URLs only render the first as clickable across multiple lines. Named markdown links make each entry independently clickable and look cleaner.
+
+Example:
+
+- [Brief](file:///Users/ktg/.../brief.html)
+- [Research summary](file:///Users/ktg/.../research/summary.md)