Sharkcode Environment Map · Per Noelia

Tutto quello che esiste in Sharkcode + filtro Path 6 utile per te. Quando dici "Claude, fai X", Claude sa che agenti/skills/templates usar automáticamenteamente.

Path 6 Phase 1.5 · audit completo Sharkcode environment · 23 maggio 2026 · noche tarde 5

Agenti · 15 prioritari per te

Claude orchestrates agenti automáticamenteamente. Tu non li invochi direttamente, ma saber COSA esiste ti aiuta a pedir meglio. Ejemplo: en lugar de "scrivimi del testo" dici "scrivimi del testo via italian-writer".

Tier 1 · Essential Day 1-7

sharkcode-italian-writer

Cuando lo usás: "Claude, scrivi il testo della homepage cliente Wedding in italiano naturale" → Claude invoca italian-writer + restituisce copy senza accenti errati, senza em-dash, tono caldo.

sharkcode-copywriting

Cuando lo usás: "Claude, migliora la headline di questo prodotto Etsy" → ritorna 2-3 versioni AIDA (Attention/Interest/Desire/Action).

sharkcode-brand

Cuando lo usás: "Claude, crea brand book per mio shop Etsy" → pipeline R0-R6 completa (persona + naming + palette OKLCH + visual identity + guidelines).

sharkcode-content-strategist

Cuando lo usás: "Claude, pianifica 12 post blog Etsy wedding stationery" → content calendar editorializzato 3 mesi.

sharkcode-seo

Cuando lo usás: "Claude, ottimizza titoli Etsy per ranking" → SEO checklist + keyword research + schema markup JSON-LD.

Tier 2 · Useful Week 2-4

sharkcode-design

Cuando lo usás: "Claude, audita design pagina prodotto Etsy" → heuristics scoring 12-point (impeccable framework).

sharkcode-frontend

Cuando lo usás: "Claude, verifica accessibility WCAG landing wedding" → checklist a11y + screenshot fixes.

sharkcode-sales

Cuando lo usás: "Claude, scrivi email outreach a 50 fotografi wedding Roma" → email template + personalizzazione 5-10 per batch.

sharkcode-seo-auditor

Cuando lo usás: "Claude, SEO audit completo landing wedding" → Lighthouse + Core Web Vitals + competitor pricing analysis.

sharkcode-accessibility

Cuando lo usás: "Claude, verifica accessibility Etsy product descriptions" → ARIA labels + alt text + contrast fixes.

Tier 3 · Advanced Week 4+

sharkcode-social-manager

Cuando lo usás: "Claude, crea 30 post Instagram Etsy shop" → content calendar + Reels template + hashtag research.

sharkcode-ux-researcher

Cuando lo usás: "Claude, progetta user research per entender buyer wedding" → interview script + persona template.

sharkcode-analytics

Cuando lo usás: "Claude, configura tracking vendite Etsy settimanale" → Counterscale setup + KPI CSV.

sharkcode-competitive-intel

Cuando lo usás: "Claude, analizza top 10 Etsy shop wedding Italia" → competitor matrix + pricing + messaging.

sharkcode-language-checker

Cuando lo usás: "Claude, verifica grammatica copy italiana" → accent fixer + linter (auto-run después italian-writer).

Nota: ci sono altri 30+ agenti in Sharkcode (sharkcode-orchestrator, gsd-planner, gsd-debugger, ecc.). NON serve a te conoscerli todos Day 1. Sopra ho selezionato quelli rilevanti Path 6 Etsy + Wedding.

Skills · 12 prioritari per te

Skills sono moduli specializzati che Claude carica on-demand. Spesso si invocano via `/skill-name args`.

Skill	Cuando lo usás	Tier
`copywriting`	"Migliora headline prodotto Etsy" → framework AIDA italiano	Tier 1
`content-creator`	"Crea blog 12 post wedding" → content templates hook/problem/solution/CTA	Tier 1
`seo`	"Ottimizza keyword Etsy" → 5 sezioni (on-page, technical, speed, mobile, schema)	Tier 1
`impeccable`	"/impeccable audit landing wedding" → 12-point checklist (typo, spacing, color, motion, a11y)	Tier 1
`brandkit`	"Genera brand mood board" → premium visual system OKLCH	Tier 1
`canvas-design`	"Disegna banner Etsy shop wedding" → poster/image per social/email	Tier 2
`frontend-design`	"Redesign landing wedding" → React/Astro code component library + Tailwind v4	Tier 2
`page-cro`	"Aumenta conversioni landing wedding" → CRO framework heatmap + copy test	Tier 2
`social-content`	"Crea 30 post Instagram wedding" → content calendar + Reels template	Tier 2
`accessibility-auditor`	"Verifica WCAG Etsy shop" → screen reader test + contrast report	Tier 2
`schema-markup`	"Aggiungi rich snippet prodotto Etsy" → Product schema JSON-LD	Tier 2
`domain-name-brainstormer`	"Genera nomi dominio wedding shop" → 20 idee + availability check	Tier 3

Slash Commands · 8 per te

Slash commands sono shortcut per workflow complessi. Si invocano scrivendo /command-name args.

Command	Uso per te	Tier
`/run-pipeline`	`/run-pipeline mariposa-wedding brand` → esegue brand pipeline R0-R6 per cliente	Essential
`/load-research`	`/load-research copywriting` → carica L1 sidecar copywriting best practices	Essential
`/analyze-site`	Crawl Etsy shop tuo → SEO audit + competitor benchmark	High
`/web-design-reviewer`	`/web-design-reviewer URL` → design score + fixes	High
`/project-health-check`	Status progetto Path 6 → fasi completate, blocchi, ETA	Medium
`/publisher-linkedin`	Publish post wedding content LinkedIn → outreach fotografi/planner	Medium
`/screenshot-analyzer`	Analizza screenshot Etsy layout → a11y + mobile UX feedback	Low
`/create-prd`	Crea PRD wedding landing (requirements doc)	Low

Templates · qué existe

Templates riusabili cross-cliente. Tu non scrivi templates da zero, Claude pesca da qui.

Directory	Cosa contiene	Per te
`templates/brand/`	Brand pack boilerplate (persona, positioning, palette OKLCH, logo brief)	R0-R6 brand pipeline tuo Etsy + cliente Wedding
`templates/site-scaffold/sections/`	61 Section Astro+Tailwind v4 canonical variants	Scaffolding landing wedding cliente (Wedding-Templates ha pattern diverso, vedi guide separato)
`templates/legal/`	GDPR compliance (privacy, cookie, terms HTML templates)	Legal phase landing + Etsy policies
`templates/founding-partner/`	Proposal commerciale Sharkcode (cover + scope + timeline + pricing)	Reference solo Michel
`templates/sales-framework.md`	Pricing baseline + workflow Sharkcode	Reference quando rispondi a domande cliente costi

Tools · 8 chiave

Tools sono script TypeScript/Python che Michel + Claude usano backend. Tu NON tocchi direttamente, Claude li orchestra.

Tool	Cosa fa	Per te
`tools/orchestrator/run-pipeline.ts`	Orchestrate fase pipeline (brand → design → build → content)	Invocato via `/run-pipeline`
`tools/orchestrator/compile-brand.ts`	Genera brand pack PDF (persona + naming + palette + guidelines)	Output deliverable cliente Wedding
`tools/orchestrator/compile-pack-2-blocchi.ts`	PDF proposta commerciale 2 blocchi	Uso interno Michel
`tools/orchestrator/italian-text-cleanup.ts`	Fix accenti italiani automáticamente (è/à/ù/ì/ò)	Post-copy validation (italian-writer lo invoca auto)
`tools/pinna/`	Visual review tool Sharkcode (cliente comments su screenshot)	Pinna access dipende fix #3 multi-utente M5+
`tools/intel/check-skill-updates.ts`	Cron weekly skill updates monitoring	Uso interno
`tools/dashboard/`	Dashboard OS Sharkcode (status clienti, pipeline state)	Vai a localhost:4000 quando dev server attivo
`tools/ingest/`	Conversione PDF/Word/audio → markdown (markitdown)	Quando cliente manda brief PDF, Claude lo ingesta

MCP Servers · 17 attivi

MCP = Model Context Protocol. Sono "plugin" che danno a Claude accesso a servizi esterni (Sanity, Tavily, browser automation, ecc.).

MCP Server	Cosa fa	Uso per te
`context7`	Fetch current library docs (React, Tailwind, ecc.)	Claude consulta docs aggiornate quando lavora codice
`playwright`	Browser automation + screenshot	"Claude, fai screenshot della mia Etsy shop" → Playwright screenshot
`tavily`	Web search competitor analysis + market research	Tutte le ricerche Etsy + Wedding
`sharkcode-core`	Query brain graph Sharkcode (cliente data + memorie)	"Claude, mostra status cliente Mary" → query graph
`sharkcode-local-llm`	Fast embedding + classification local Phi-4	Auto-retrieval memorie + classification testi
`sanity`	CMS for blog + content cliente Wedding (NON Wedding-Templates)	Quando cliente Sharkcode standard usa Sanity
`docuseal`	PDF contract signing (proposta cliente → firma)	Michel-only, Phase 4+ se firmi anche tu
`klaviyo`	Email marketing automation (Lindorug client only)	NON Path 6 scope
`gsap-master`	GSAP animation library expert	"Claude, animation hero landing wedding" via GSAP
`magicui`	Magic UI components premium	Component library quando build dashboard suo
`aceternityui`	Aceternity UI components premium	Component library landing premium
`universal-icons`	Icon library Lucide + Material	Icone landing siti + Etsy
`astro-docs`	Astro framework docs lookup	Reference Astro quando lavora landing
`tailkits/flowbite/flyonui`	Tailwind component libraries	Variants UI extra
`lottiefiles`	Lottie animations	Animated product showcase Etsy
`memory`	Persistent memory cross-session	"Claude, recordáti che ho deciso X" → saved

Pattern · come Claude lavora con te

Esempi conversazionali di come l'environment lavora juntos quando tu chiedi cose.

Pattern 1 · Etsy listing nuovo

Vos decís: "Claude, voglio creare un nuovo listing planner academico 2026-2027 español per il mio Etsy shop."

Claude internamente:

Invoca sharkcode-italian-writer per copy IT (se richiesto)
Invoca sharkcode-copywriting per copy ES + EN
Usa skill copywriting framework AIDA
Usa skill seo per tags + meta
Tavily MCP per competitor analysis
Restituisce: titolo + description + tags + competitor analysis ready-paste Etsy

Pattern 2 · Cliente Wedding modifica design

Vos decís: "Claude, il cliente Mariposa Wedding vuole cambiáre palette a verde menta + dorado."

Claude internamente:

Naviga repo Wedding-Templates al template Mariposa
Edita src/styles/theme.css Tailwind @theme block
Avvia pnpm dev + apre URL localhost
Aspetta tuo feedback "ok" / "no, più calda"
Quando ok, fa git commit + push

Pattern 3 · Brand identity tuo Etsy shop

Vos decís: "Claude, genera brand identity per il mio Etsy shop wedding stationery."

Claude internamente:

Invoca sharkcode-brand agent (pipeline R0-R6)
R0: voice extraction (questionario 4-5 domande)
R1: naming exploration (8-10 candidati + dominio check)
R2: positioning + USP
R3: visual identity (palette OKLCH + tipografia)
R4: logo direction
R5-R6: Canva brand kit setup + bio copy multilingua