Initial release: triage and map-repo skills, zeus knowledge profile, Jira routing config

README.md

@@ -0,0 +1,68 @@
+# gw-triage
+
+Da uno screenshot e due righe su Telegram a una issue Jira fatta bene,
+assegnata al dev giusto.
+
+## Installazione (una volta sola)
+
+1. **Plugin Atlassian** — in Claude Code:
+   `/plugin install atlassian@claude-plugins-official`
+2. **Login Atlassian** — esegui `/mcp`, seleziona `atlassian` e completa
+   il login nel browser con l'account aziendale. Verifica che risulti
+   *connected*.
+3. **Installa gw-triage**:
+   `/plugin marketplace add https://git.growingway.com/giuse/gw-triage.git`
+   `/plugin install gw-triage`
+4. **Token API** (per allegare gli screenshot — facoltativo ma
+   consigliato): sezione sotto.
+
+## Token API Jira
+
+Serve solo ad allegare gli screenshot alle issue (l'MCP Atlassian non
+supporta gli allegati). Senza token tutto funziona lo stesso: viene
+saltato solo l'allegato.
+
+1. Apri <https://id.atlassian.com/manage-profile/security/api-tokens>
+   (login con l'account Atlassian aziendale).
+2. **Create API token** → etichetta `gw-triage` → scegli la scadenza →
+   **copia subito il token** (viene mostrato una volta sola).
+3. Aggiungi le credenziali al profilo della shell:
+   - bash/zsh: `export JIRA_EMAIL="tu@azienda.it"` e
+     `export JIRA_API_TOKEN="<token>"`
+   - fish: `set -Ux JIRA_EMAIL tu@azienda.it` e
+     `set -Ux JIRA_API_TOKEN <token>`
+4. Verifica:
+   `curl -s -u "$JIRA_EMAIL:$JIRA_API_TOKEN" https://growingway.atlassian.net/rest/api/3/myself`
+   deve restituire il tuo profilo in JSON.
+
+⚠️ Il token agisce a tuo nome su Jira: non committarlo mai. Se trapela,
+revocalo dalla stessa pagina. Quando scade, `/gw-triage:triage` continua a
+funzionare — salta solo l'allegato finché non ne esporti uno nuovo.
+
+## Uso quotidiano
+
+1. Salva lo screenshot dal messaggio Telegram.
+2. In Claude Code: **trascina il file nel prompt** (così può essere
+   allegato alla issue), incolla il messaggio e invoca
+   `/gw-triage:triage`.
+3. Rispondi all'eventuale domanda di chiarimento, conferma la bozza →
+   la issue viene creata e ricevi il link.
+
+Funziona anche senza screenshot (solo testo) o con l'immagine incollata
+dagli appunti — in quel caso l'allegato va trascinato in Jira a mano.
+
+## Aggiornare la conoscenza dei repo
+
+Quando la tua codebase cambia in modo visibile agli utenti, dalla
+cartella del repo esegui `/gw-triage:map-repo` e segui le istruzioni:
+il profilo aggiornato viene pushato qui e gli altri lo ricevono con
+`/plugin marketplace update gw-triage`.
+
+## Problemi comuni
+
+- **"MCP Atlassian non disponibile"** → passi 1–2 dell'installazione.
+- **"Allegato saltato"** → controlla `JIRA_EMAIL` / `JIRA_API_TOKEN`
+  (sezione Token API).
+- **La issue finisce nell'epic sbagliata** → correggi in Jira e apri
+  una issue su questo repo per aggiustare `config/routing.json` o il
+  profilo in `knowledge/`.