name: add-tool-to-stack description: Aggiungi uno o piu tool software/SaaS/web app al CH Tool Stack. Normalizza URL, verifica duplicati/alias, ricerca web aggiornata, propone i dati all'utente, inserisce in DB con ch_status NULL e aggiorna Notion.

Skill: Aggiungere Tool al CH Tool Stack

Trigger

Usa questa skill quando l'utente chiede di aggiungere, continuare, importare o classificare tool software/SaaS/web app nel Tool Stack di CryptoHelvetia. È operativa: porta il batch fino a proposta, inserimento dopo conferma, aggiornamento Notion e verifica finale — non fermarti a metà.

Regole

• Conferma sempre prima di inserire, salvo conferma permanente o richiesta esplicita dell'utente di non chiedere ad ogni batch nel thread corrente. In quel caso procedi, ma segnala comunque in modo evidente duplicati, scarti e rischi.
• ch_status sempre NULL in inserimento; lo imposta l'utente dopo dalla UI.
• URL ufficiale di prodotto/azienda, mai endpoint tecnici, landing temporanee, link regionali o URL di feature. Un link tecnico che è solo una funzionalità di un prodotto esistente (es. endpoint MCP di HubSpot/Intercom) è un alias, non un nuovo record: usa il prodotto ufficiale.
• Nome = display name per la UI, iniziale maiuscola o numero anche se il brand è tutto minuscolo (bunny.net → Bunny.net, iubenda → Iubenda). Mantieni maiuscole interne riconoscibili (insMind, n8n.io, v0.dev) solo se il primo carattere è già non minuscolo o numerico.
• Mai doppioni: in caso di dubbio fermati e proponi merge/alias/deprecazione invece di inserire.
• Storage attuale: Supabase. Non introdurre nuovo accoppiamento; se in futuro si userà Convex per questi dati, adatta solo lo step DB, lasciando invariati normalizzazione, proposta e verifica.

Schema DB

Tabella tools:

broad_field, narrow_product, narrow_stage sono solo label di proposta: non esistono come nomi colonna nel DB.

Processo

1. Batch e anteprima

Se il batch viene da una pagina Notion sorgente, leggila e prendi il prossimo blocco coerente (di norma 8-10 tool).

Mostra una breve anteprima e chiedi conferma prima di verifica+ricerca:

```txt Sto per analizzare questi tool:

1. Nome - https://...
2. Nome - https://...

Procedo con verifica duplicati e ricerca web? ```

Salta la richiesta solo se l'utente ha già dato il via libera per il thread corrente; in quel caso puoi arrivare fino all'inserimento senza fermarti, mantenendo comunque ben segnalati duplicati/scarti/rischi nella proposta.

2. URL canonico

Per ogni URL: rimuovi query string/fragment/trailing slash superfluo, forza https, valuta www vs root come alias dello stesso sito, segui i redirect principali, evita URL localizzati (/it/, /en/) salvo siano il prodotto principale. Se il link è una feature/endpoint di un prodotto esistente, trattalo come alias e usa il prodotto ufficiale (es. mcp.hubspot.com → HubSpot, mcp.intercom.com → Intercom).

3. Duplicati

Un solo controllo batch nel DB (carica almeno id,name,url), ma confronta più varianti: URL esatto, senza trailing slash, http/https, www/root domain, nome simile o già noto.

Se trovi un duplicato: non inserirlo, segnala l'ID esistente. Se il link nuovo è più corretto del vecchio, proponi update del record esistente. Se è un alias tecnico o non voluto, rimuovilo dalla sorgente Notion dopo conferma. Se esiste già un doppione creato per errore, deprecalo/eliminalo solo dopo aver verificato che il record canonico esiste.

4. Ricerca web e scarti

Per ogni tool non duplicato, ricerca aggiornata (usa l'anno corrente e il precedente nelle query), in ordine di priorità: sito ufficiale/docs/changelog → Crunchbase/PitchBook/news funding → GitHub/ProductHunt/HN/Reddit/X → stampa tech (TechCrunch, The Verge, blog ufficiali). Se un dominio risponde in modo ambiguo, verifica anche via richiesta HTTP — un 401/403 può essere normale per endpoint autenticati, ma non basta a capire se sia URL canonico o solo tecnico.

Scarta se: dominio offline/parked/404 stabile/malware, prodotto dismesso o azienda chiusa, progetto personale senza pagina funzionante, o non pertinente allo stack. Non scartare solo per assenza di news recenti se è una libreria stabile, un framework maturo, uno standard tecnico, una utility evergreen o un prodotto corporate senza changelog pubblico.

Motiva ogni scarto nella proposta. Dopo conferma, rimuovilo anche dalla sorgente Notion (annotandolo in "Scartati - deprecati" se utile).

5. Campi

Compila: name, url, description, founded_year, ai, blockchain, hot, broad_media, broad_field, narrow_product, narrow_stage.

• ai=true: AI/ML è core, o dichiarata nel marketing/nelle feature del prodotto.
• blockchain=true: crypto/web3/DeFi/NFT è core o infrastruttura essenziale del prodotto.
• hot=true: giudizio evidence-based su segnali pubblici degli ultimi 12 mesi, non sensazione. Richiede almeno 2 segnali positivi concreti, oppure 1 molto forte (es. round Series B/C recente, ARR pubblico in crescita, traction forte al lancio). Con segnali misti, spiega il tradeoff nella proposta. Popolarità, uso di AI o appartenenza a una categoria di moda da soli non bastano.

• narrow_stage: Indie Maker (personale/micro-team) · Open Collective (open source/community-driven) · Early Startup (pre-seed/seed, <~5M) · Growth Startup (Series A/B, ~5-50M) · High-Growth Startup (Series C/D, ~50-200M) · Unicorn / Late Stage (valuation >1B o late stage) · Corporate / Public Company (quotata o grande corporate) · Calm Company (bootstrapped/profittevole, non VC-backed). Se il funding non è pubblico, usa il miglior stage inferibile e segnala l'incertezza nella proposta — non bloccare il batch per questo.

6. Descrizione

180-250 caratteri, italiano chiaro. Non iniziare col nome del tool, niente marketing vuoto: cosa fa, per chi, cosa lo distingue (limiti solo se utili).

``txt Editor video AI che permette di modificare clip editando il testo della trascrizione. Genera B-roll, sottotitoli e correzioni visive da prompt, utile per creator e team marketing. ``

7. Proposta e conferma

Tabella sintetica dei nuovi inserimenti + sezione separata per duplicati/scarti (con ID esistente o motivo) + fonti principali usate. Chiedi conferma esplicita, salvo conferma permanente già data nel thread:

``txt Confermi questi dati e la rimozione dalla coda dei duplicati/scarti indicati? Procedo con l'inserimento? ``

8. Inserimento DB

Insert in batch su Supabase con select di ritorno per avere gli ID (id,name,url), ch_status: null, nomi colonna reali. Se l'insert fallisce per duplicato, verifica il record esistente e correggi la proposta invece di forzare.

``js { name: "Nome", url: "https://example.com", description: "Descrizione...", founded_year: 2026, ai: true, blockchain: false, hot: true, ch_status: null, broad_media_category_ids: ["uuid-media"], broad_field_category_id: "uuid-field", narrow_product_category_id: "uuid-product", narrow_stage_category_id: "uuid-stage" } ``

Per correggere un doppione già creato per errore: aggiorna il record canonico se serve, elimina/depreca quello errato solo se sei certo che non sia l'unico record valido, poi verifica con una query finale.

9. Notion

Pagine: parent storico 2f032d3c-262f-801887c4febe7bd4a851, sorgente 21b32d3c-262f-8089-817d-cb71364baddc, titolo giornaliero Aggiunte al Tool Stack il [data odierna].

• Trova o crea la pagina giornaliera sotto il parent storico; aggiungici solo i tool realmente inseriti o corretti come canonici in questa run.
• Scarti/deprecati → sotto-pagina "Scartati - deprecati" con URL e motivo.
• Rimuovi dalla pagina sorgente tutti i link gestiti (inseriti, duplicati confermati, alias tecnici, scarti). Se il batch non viene da una pagina sorgente ma da URL passati direttamente in chat, salta solo questo sotto-step: il resto (pagina giornaliera) va comunque fatto.
• Se un replace sul markdown fallisce, rifai il fetch della pagina e riprova con lo snippet aggiornato.

Prima di scrivere "Notion non disponibile", prova davvero a chiamare un tool Notion: lo stato di autenticazione mostrato a inizio contesto può essere stantio (connettore ancora in fase di connessione).

10. Audit finale

Prima di chiudere, verifica sempre: query DB sui record inseriti/duplicati/alias, fetch della pagina Notion giornaliera e della sorgente. Se la richiesta tocca anche UI/codice, rg per URL sbagliati; se il progetto ha Convex, controlla anche lì.

Nel riepilogo finale indica: ID inseriti, duplicati rimossi dalla coda, scarti/deprecati, problemi trovati e come sono stati risolti, eventuali limiti residui (es. "nessuna pagina sorgente da ripulire, batch passato direttamente in chat").

Riferimento Categorie con UUID

broad_media (7) - selezione multipla

broad_field (10)

narrow_product (33)

narrow_stage (8)