# 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/`.