Files
upo-app-agents/docs/Docs_Obsolescenza_Report.md
Simo 4ba44abb19 Better Prompt (#45)
* Enhance report generation and team leader prompts with conditional output rules for empty sections.

* Update .gitignore and configuration for model adjustments; refine query classification prompt

* Enforce max response length in prompts

* Documentazione tool essenziale per il loro utilizzo da parte degli LLM.

* istruzioni chiare sui tool disponibili nei promt degli agenti

* corretto incongruenze nel report generation prompt

* convertito i promt in file markdown
2025-10-29 15:45:05 +01:00

3.2 KiB
Raw Blame History

Report Obsolescenza Documenti (docs/)

Valutazione dei documenti esistenti rispetto allo stato attuale del codice.

Valutazione Documenti

  • App_Architecture_Diagrams.md

    • Stato: parzialmente aggiornato.
    • Criticità: contiene sezioni su "Signers Architecture" (src/app/signers/…) che non esistono nel repo attuale; riferimenti a auto-detection provider non presenti esplicitamente nei wrappers (lattuale gestione usa WrapperHandler e assert su env). Alcuni numeri/esempi sono illustrativi.
    • Azioni: mantenere i diagrammi generali; rimuovere/aggiornare la sezione Signers; allineare provider e flusso al workflow Query Check → Info Recovery → Report Generation.
  • Async_Implementation_Detail.md

    • Stato: aspirazionale/roadmap tecnica.
    • Criticità: la Pipeline è già asincrona per il workflow (interact_async), ma i singoli wrappers sono sincroni; il documento descrive dettagli di async su MarketAgent che non esiste come classe separata, e prevede parallelizzazione sui provider non implementata nei wrappers.
    • Azioni: mantenere come proposta di miglioramento; etichettare come "future work"; evitare di confondere con stato attuale.
  • Market_Data_Implementation_Plan.md

    • Stato: piano di lavoro (utile).
    • Criticità: parla di Binance mock/signers; nel codice attuale esiste BinanceWrapper reale (autenticato) e non ci sono signers; la sezione aggregazione JSON è coerente come obiettivo ma non implementata nativamente dai tools (aggregazione base è gestita da WrapperHandler.try_call_all).
    • Azioni: aggiornare riferimenti a BinanceWrapper reale; chiarire che laggregazione avanzata è un obiettivo; mantenere come guida.
  • Piano di Sviluppo.md

    • Stato: generico e parzialmente disallineato.
    • Criticità: fa riferimento a stack (LangChain/LlamaIndex) non presente; ruoli degli agenti con naming differente; database/persistenza non esiste nel codice.
    • Azioni: etichettare come documento legacy; mantenerlo solo se serve come ispirazione; altrimenti spostarlo in docs/legacy/.
  • Progetto Esame.md

    • Stato: descrizione obiettivo.
    • Criticità: allineata come visione; non problematica.
    • Azioni: mantenere.

Raccomandazioni

  • Aggiornare App_Architecture_Diagrams.md rimuovendo la sezione "Signers Architecture" e allineando i diagrammi al workflow reale (agents/pipeline.py).
  • Aggiungere Current_Architecture.md (presente) come riferimento principale per lo stato attuale.
  • Spostare Piano di Sviluppo.md in docs/legacy/ o eliminarlo se non utile.
  • Annotare Async_Implementation_Detail.md e Market_Data_Implementation_Plan.md come "proposals"/"future work".

Elenco Documenti Obsoleti o Parzialmente Obsoleti

  • Parzialmente Obsoleti:

    • App_Architecture_Diagrams.md (sezione Signers, parti di provider detection)
    • Async_Implementation_Detail.md (dettagli Async MarketAgent non implementati)
    • Market_Data_Implementation_Plan.md (Binance mock/signers)
  • Legacy/Non allineato:

    • Piano di Sviluppo.md (stack e ruoli non corrispondenti al codice)

Nota

Queste raccomandazioni non rimuovono immediatamente file: il mantenimento storico può essere utile. Se desideri, posso eseguire ora lo spostamento in docs/legacy/ o la cancellazione mirata dei documenti non necessari.