gw-triage/README.md

gw-triage

Da uno screenshot e due righe su Telegram a una issue Jira fatta bene, assegnata al dev giusto.

Installazione (una volta sola)

Claude Code

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): esegui /gw-triage:setup e segui le istruzioni.

Codex CLI

1. Clona il repo dove preferisci: git clone https://git.growingway.com/giuse/gw-triage.git
2. Dalla cartella clonata esegui ./install-codex.sh — crea i link alle skill in ~/.agents/skills/. Nota: le skill si chiamano triage, setup e map-repo; se hai già altre skill con questi nomi entrano in conflitto.
3. Token API (qui obbligatorio — su Codex tutte le chiamate Jira lo usano): invoca $setup e segui le istruzioni.

Per aggiornare: git pull nella cartella clonata (i link restano validi). Su Claude Code: /plugin marketplace update gw-triage.

Token API Jira

Su Claude Code serve solo ad allegare gli screenshot alle issue (le altre operazioni passano dall'MCP Atlassian): senza token tutto funziona lo stesso, viene saltato solo l'allegato. Su Codex invece è obbligatorio: tutte le chiamate Jira lo usano.

Esegui il setup (/gw-triage:setup su Claude Code, $setup su Codex): ti guida nella creazione del token dalla pagina Atlassian, te lo chiede, lo verifica e lo salva in ~/.config/gw-triage/netrc (valido da subito, senza riavviare nulla). Se avevi già configurato il token in ~/.claude/settings.json, il setup lo migra da solo.

⚠️ Il token agisce a tuo nome su Jira: non condividerlo. Se trapela, revocalo da https://id.atlassian.com/manage-profile/security/api-tokens. Quando scade: su Claude Code /gw-triage:triage continua a funzionare (salta solo l'allegato), su Codex si ferma e ti rimanda al setup. Rilancia il setup per sostituirlo.

Uso quotidiano

1. Allega uno screenshot (trascina il file nel prompt, così può essere allegato alla issue) e/o scrivi una breve descrizione del problema, sufficiente a identificarlo, poi invoca /gw-triage:triage (Claude Code) o $triage (Codex).
2. Rispondi all'eventuale domanda di chiarimento, conferma la bozza → la issue viene creata e ricevi il link.

Se l'immagine è incollata dagli appunti anziché trascinata come file, l'allegato va poi 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 (Claude Code) o $map-repo (Codex) e segui le istruzioni: il profilo aggiornato viene pushato qui e gli altri lo ricevono con /plugin marketplace update gw-triage (Claude Code) o git pull nella cartella clonata (Codex).

Problemi comuni

• "MCP Atlassian non disponibile" → passi 1–2 dell'installazione Claude Code.
• "Allegato saltato" → esegui il setup (token mancante, scaduto o revocato).
• Su Codex le skill non compaiono → riesegui ./install-codex.sh dalla cartella clonata e controlla i link in ~/.agents/skills/.
• 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/.