Skip to content

Add GitHub Copilot instructions for FYLIA project#9

Draft
Copilot wants to merge 3 commits intomainfrom
copilot/setup-copilot-instructions
Draft

Add GitHub Copilot instructions for FYLIA project#9
Copilot wants to merge 3 commits intomainfrom
copilot/setup-copilot-instructions

Conversation

Copy link
Contributor

Copilot AI commented Jan 20, 2026

Establishes comprehensive Copilot guidance for FYLIA, a conversational development environment for Termux/Android that generates Python code from Italian language descriptions.

Changes

  • Created .github/copilot-instructions.md with project-specific guidance:
    • Architecture constraints: 3-panel TUI (30%-40%-30%), AST-based code mapping, provider pattern for AI integration
    • Python 3.8+ compatibility: Type hints using typing.List, typing.Dict (not list[], dict[])
    • Termux compatibility: stdlib-first approach, minimal dependencies (click, textual)
    • Italian language requirement: All user-facing output in Italian, with specific examples
    • Code style: MVP-first, educational clarity over optimization, clean separation of CLI/TUI/logic

Example from instructions

from typing import List

def _extract_imports(self, tree: ast.Module) -> List[str]:
    """Estrae le import da un modulo Python"""
    # ✅ Type hints compatible with Python 3.8
    # ✅ Italian docstring for user-facing code
    # ✅ Educational style with clear intent

The instructions guide Copilot to maintain FYLIA's philosophy: code as a learning tool, not a black box.

Original prompt

This section details on the original issue you should resolve

<issue_title>✨ Set up Copilot instructions</issue_title>
<issue_description>Agisci come un senior software architect e CLI/TUI designer.

Stiamo sviluppando un tool chiamato FYLIA, pensato per funzionare in TERMUX su Android.
Il progetto è in Python ed è organizzato come CLI + TUI (interfaccia testuale a pannelli).

OBIETTIVO GENERALE
Costruire uno strumento che permetta all’utente di:

  • scrivere o parlare in italiano
  • descrivere cosa vuole costruire (codice)
  • ricevere codice generato o modifiche al codice esistente
  • visualizzare una mappa concettuale della struttura del progetto (file, moduli, funzioni/classi)
  • lavorare interamente da terminale (no interfaccia web)

VINCOLI TECNICI

  • Ambiente: Termux (Android)
  • Linguaggio: Python 3
  • UI: TUI a pannelli (chat a sinistra, editor/diff al centro, mappa concettuale a destra)
  • Tutto deve funzionare in terminale
  • Codice semplice, modulare, leggibile, educativo

STRUTTURA PROGETTO (già creata)
src/fylia/
cli.py → entrypoint CLI
tui.py → interfaccia testuale a pannelli
mapgen.py → generazione mappa concettuale del codice
patcher.py → applicazione patch/diff ai file
providers/
mock.py → provider finto per test (nessuna API reale)
tests/

COMPITI PER TE (Copilot)

  1. Genera codice Python reale, non pseudocodice.
  2. Parti sempre da un MVP funzionante.
  3. Commenta il codice in modo chiaro (didattico ma non prolisso).
  4. Preferisci librerie compatibili con Termux.
  5. Quando modifichi file, mostra sempre cosa aggiungi o cambi.
  6. Mantieni separazione netta tra:
    • logica
    • interfaccia
    • parsing del codice
  7. La mappa concettuale deve almeno:
    • mostrare albero file
    • estrarre funzioni e classi dai file Python
  8. Tutte le interazioni utente sono in italiano.

STILE DI RISPOSTA

  • Diretto, tecnico, ordinato
  • Prima spiega cosa stai facendo (breve)
  • Poi fornisci il codice
  • Evita soluzioni “magiche” o non spiegate

Ora inizia implementando:

  • un comando CLI fylia chat
  • una TUI base con 3 pannelli (chat / output / mappa)
  • una prima versione di mapgen.py che genera una mappa del progetto</issue_description>

Comments on the Issue (you are @copilot in this section)


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Copilot AI and others added 2 commits January 20, 2026 04:18
Co-authored-by: meseb <206750850+meseb@users.noreply.github.com>
Co-authored-by: meseb <206750850+meseb@users.noreply.github.com>
Copilot AI changed the title [WIP] Set up Copilot instructions for FYLIA tool Add GitHub Copilot instructions for FYLIA project Jan 20, 2026
Copilot AI requested a review from meseb January 20, 2026 04:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

✨ Set up Copilot instructions

2 participants