Panoramica

Il problema

Con LLM e iterazione rapida succede spesso:

• Un bug discusso in chat viene dimenticato
• Un task resta «mentale» ma non compare nel backlog del team
• File markdown sparsi (TODO.md, bugs.txt) moltiplicano la confusione
• Nessuno sa cosa è aperto, in corso o chiuso

La soluzione

Vibeissue collega la chat dell'agente AI a GitHub Issues con:

1. pip install vibeissue — CLI su PyPI (vibeissue, vibeissue-adopt)
2. Istruzioni agente — file letti dall'LLM (AGENTS.md, regola Cursor, Copilot, Claude, …)
3. Template GitHub — form web per aprire issue dal browser
4. Skeleton nel repo — label, config tracker e regole via adopt

GitHub Issues diventa la fonte di verità. I markdown locali restano per piani dettagliati e archivio — non per lo stato operativo.

Architettura

Tu in chat  →  Agente AI (legge AGENTS.md)  →  CLI vibeissue  →  GitHub Issues

Requisiti per ogni piattaforma:

• Python 3 (Windows, macOS, Linux) + pip install vibeissue
• GITHUB_TOKEN con Issues read/write
• Slug in tracker/github_repo o GITHUB_REPO
• Istruzioni agente: esegui la CLI, non delegare all'utente

Percorso corto (solo CLI)

1. pip install vibeissue
2. Token GitHub + slug repo in .env
3. vibeissue list

Opzionale — percorso completo (agenti AI)

1. Adotta in un progetto (vibeissue-adopt)
2. Apri l'agente e dì «Apri issue per…»
3. Scegli la piattaforma