Cluster — Utente
Documentazione per chi usa Prompt a Porter, sia il client desktop che gli strumenti integrati.
Inizio rapido
Se sei un nuovo utente, parti da qui:
getting-started.md— installazione, onboarding, primo prompt, prima compilazione (5 minuti).glossario-sintassi.md— reference della sintassi del body: segnaposti, globali, import, codici linter.scorciatoie-tastiera.md— tabella completa delle hotkey.casi-uso/— 7 ricette concrete (email, code review, summarize, riscrittura tono, brainstorm, traduzione, commit message).troubleshooting.md— FAQ e soluzioni ai problemi più comuni.
Documenti
| Doc | Descrizione |
|---|---|
getting-started.md | Guida al primo utilizzo: installazione, onboarding, primo prompt e prima compilazione |
glossario-sintassi.md | Reference sintassi body: segnaposti {{nome}}, globali {{globale ...}}, import {{import ...}}, codici linter |
scorciatoie-tastiera.md | Tabelle complete delle scorciatoie attive (shell, palette, modali, editor CodeMirror) |
casi-uso/ | Ricette pratiche con prompt completi pronti all'uso |
troubleshooting.md | FAQ + soluzioni a problemi noti (installazione, hotkey, editor, sync, backup) |
cli.md | Reference della CLI pap (Go + cobra): 5 comandi read-only per accedere al vault dal terminale, output in table/json/yaml/plain, completion bash/zsh/fish/powershell |
mcp.md | Integrazione Model Context Protocol: setup Claude Desktop, Cursor, custom client; 4 tool esposti (pap_search, pap_get, pap_list_recent, pap_render); trasporto stdio; troubleshooting |
formato-export-json.md | Schema del formato di export JSON v1: campi obbligatori/opzionali, modalità conflitti import (skip/overwrite/rename), garanzie round-trip lossless |
ricerca-semantica.md | Ricerca ibrida (FTS + embedding), modello scelto, alpha bilanciamento, idle-unload, performance e privacy |
linting-regole.md | Catalogo completo delle 11 regole di linting con esempi pratici (LEN/PH/PII/STY/IMP) |
cartelle.md | Modello dati e UX cartelle (anticipa permessi Fase 4) |
prompt-componibili.md | Sintassi {{import "..."}}, esempi, anti-pattern, depth limits e cicli |
varianti-prompt.md | A/B testing dei prompt: come creare varianti B/C/Z, navigazione, differenza con i fork (Fase 4) |
fork-prompt.md | Clone indipendente con tracciabilità: quando fare fork, banner "Fork di X", chain (Fase 4) |
rating-prompt.md | Rating discreto post-uso 👎/😐/👍, badge percentuale colorato, traiettoria nel tempo (Fase 4) |
regression-testing.md | Golden examples + provider AI (Ollama/Anthropic/OpenAI) + similarity functions + drift report — differenziatore strategico (Fase 4) |
auto-update.md | Aggiornamenti automatici (v1.0+): policy on-demand, firma Ed25519 + Authenticode, privacy, troubleshooting, FAQ |
Integrazioni avanzate
- Riga di comando: vedi
cli.md. La CLIpaplegge lo stesso vault del client. - Agenti AI (Claude Desktop, Cursor, ...): vedi
mcp.md. - Backup / migrazione: vedi
formato-export-json.md(JSON) emarkdown-import-export.md(Markdown / Obsidian / Foam).