v3.3.1 Setup wizard Wizard di configurazione

Set up your wiki, one step at a time. Configura la wiki, un passo alla volta.

You do not need to know the configuration files: run /power-platform-llm-wiki:init and answer the questions. For each step you find what the wizard asks, how to choose and how to verify you got it right.

Non devi conoscere i file di configurazione: lancia /power-platform-llm-wiki:init e rispondi alle domande. Per ogni passo trovi cosa ti chiede il wizard, come scegliere e come verificare di aver fatto bene.

Your environmentIl tuo ambiente

Where will you run the wizard?

Dove eseguirai il wizard?

Pick your tool: install, launch and the commands in the steps below adapt to it. Your choice is saved in this browser.

Scegli lo strumento: installazione, avvio e comandi dei passi qui sotto si adattano. La scelta resta salvata in questo browser.

🟦 Your setup in VS Code

  1. InstallEnable Chat › Plugins: Enabled, add raythekool/power-platform-plugins to Chat › Plugins: Marketplaces and install from the Extensions view (details in step 1).
  2. Open the projectOpen the folder of the project repository: it will host llm-wiki/.
  3. StartIn the chat type /power-platform-llm-wiki:init (not /init, which is the VS Code command that creates the project instructions). If it is not suggested, pick the LLM Wiki agent and ask for the setup in words.
  4. Good to knowAt step 3 choose vscode among the tools: /power-platform-llm-wiki:init writes .vscode/mcp.json and .github/copilot-instructions.md, which VS Code uses automatically.

🟦 Il tuo setup in VS Code

  1. InstallaAttiva Chat › Plugins: Enabled, aggiungi raythekool/power-platform-plugins a Chat › Plugins: Marketplaces e installa dalla vista Extensions (dettagli al passo 1).
  2. Apri il progettoApri la cartella del repository del progetto: ospiterà llm-wiki/.
  3. AvviaNella chat scrivi /power-platform-llm-wiki:init (non /init, che è il comando di VS Code per creare le istruzioni del progetto). Se non viene suggerito, scegli l'agente LLM Wiki e chiedi il setup a parole.
  4. Da sapereAl passo 3 scegli vscode tra gli strumenti: /power-platform-llm-wiki:init scrive .vscode/mcp.json e .github/copilot-instructions.md, che VS Code usa in automatico.

⌨️ Your setup in GitHub Copilot CLI

  1. Install Copilot CLI
    Skip this if copilot --version already answers. You need an active GitHub Copilot subscription and an organization that allows Copilot CLI. Run the command for your system:
    Copilot CLI
    # Windows
    winget install GitHub.Copilot
    # macOS or Linux
    brew install --cask copilot-cli
    # Any system with Node.js 22+
    npm install -g @github/copilot
    Then open a new terminal, start copilot and, if asked, type /login. More options: GitHub documentation.
  2. Install the plugin
    From a terminal:
    GitHub Copilot CLI
    copilot plugin marketplace add raythekool/power-platform-plugins
    copilot plugin install power-platform-llm-wiki@power-platform-plugins
  3. Open the projectGo to the project folder (cd) and start copilot.
  4. StartType /power-platform-llm-wiki:init (not /init, which is the Copilot CLI command that creates the project instructions). If it is not suggested, type /agent, pick LLM Wiki and ask for the setup in words.
  5. Good to knowAt step 3 choose copilot-cli among the tools: /power-platform-llm-wiki:init also writes .mcp.json, because Copilot CLI does not read .vscode/mcp.json. Accept the folder trust prompt so the servers load (details in step 8).

⌨️ Il tuo setup in GitHub Copilot CLI

  1. Installa Copilot CLI
    Salta questo punto se copilot --version risponde già. Servono un abbonamento GitHub Copilot attivo e un'organizzazione che consenta Copilot CLI. Esegui il comando del tuo sistema:
    Copilot CLI
    # Windows
    winget install GitHub.Copilot
    # macOS o Linux
    brew install --cask copilot-cli
    # Qualsiasi sistema con Node.js 22+
    npm install -g @github/copilot
    Poi apri un nuovo terminale, avvia copilot e, se richiesto, scrivi /login. Altre opzioni: documentazione di GitHub.
  2. Installa il plugin
    Da un terminale:
    GitHub Copilot CLI
    copilot plugin marketplace add raythekool/power-platform-plugins
    copilot plugin install power-platform-llm-wiki@power-platform-plugins
  3. Apri il progettoEntra nella cartella del progetto (cd) e avvia copilot.
  4. AvviaScrivi /power-platform-llm-wiki:init (non /init, che è il comando di Copilot CLI per creare le istruzioni del progetto). Se non viene suggerito, scrivi /agent, scegli LLM Wiki e chiedi il setup a parole.
  5. Da sapereAl passo 3 scegli copilot-cli tra gli strumenti: /power-platform-llm-wiki:init scrive anche .mcp.json, perché Copilot CLI non legge .vscode/mcp.json. Accetta la richiesta di fiducia nella cartella perché i server si carichino (dettagli al passo 8).

🟠 Your setup in Claude Code

  1. Install
    Claude Code 2.1.275 or later, from a terminal:
    Claude Code
    claude plugin install power-platform-llm-wiki --marketplace raythekool/power-platform-plugins
  2. Open the projectGo to the project folder (cd) and start claude.
  3. StartType /power-platform-llm-wiki:init (not /init, which is the Claude Code command that creates CLAUDE.md). The other skills use the same prefix: :config, :update, :ingest, :query. The steps below always show the full name.
  4. Good to knowAt step 3 choose claude-code among the tools: /power-platform-llm-wiki:init also writes .mcp.json and a CLAUDE.md that imports the wiki instructions. At the next start approve the project servers (details in step 8).

🟠 Il tuo setup in Claude Code

  1. Installa
    Claude Code 2.1.275 o successivo, da un terminale:
    Claude Code
    claude plugin install power-platform-llm-wiki --marketplace raythekool/power-platform-plugins
  2. Apri il progettoEntra nella cartella del progetto (cd) e avvia claude.
  3. AvviaScrivi /power-platform-llm-wiki:init (non /init, che è il comando di Claude Code per creare CLAUDE.md). Le altre skill usano lo stesso prefisso: :config, :update, :ingest, :query. I passi qui sotto mostrano sempre il nome completo.
  4. Da sapereAl passo 3 scegli claude-code tra gli strumenti: /power-platform-llm-wiki:init scrive anche .mcp.json e un CLAUDE.md che importa le istruzioni della wiki. Al successivo avvio approva i server del progetto (dettagli al passo 8).

Before you startPrima di iniziare

The three answers you need.

Le tre risposte che ti servono.

Collect them before opening the wizard: it will be quick.

Raccoglile prima di aprire il wizard: lo renderanno veloce.

🏷️

What is the project called and which technology does it use?

Come si chiama il progetto e che tecnologia usa?

e.g. "Sales", Dynamics 365 CE + Finance & Operations

es. "Vendite", Dynamics 365 CE + Finance & Operations

🧬

Where is the code, and where do you want to publish the wiki?

Dove si trova il codice, e dove vuoi pubblicare la wiki?

e.g. Azure Repos, GitHub, TFS (TFVC) or a folder on your PC

es. Azure Repos, GitHub, TFS (TFVC) o una cartella sul PC

🛡️

Who certifies the content on the customer side?

Chi certifica i contenuti lato cliente?

e.g. a key user, with first and last name

es. un key user, con nome e cognome

The wizardIl wizard

Ten steps, from prerequisites to the first wiki.

Dieci passi, dai prerequisiti alla prima wiki.

Tick each step once verified: your progress is saved in this browser.

Spunta ogni passo dopo averlo verificato: l'avanzamento resta salvato in questo browser.

Step 0Passo 0

🧰 PrerequisitesPrerequisiti

You always need PowerShell 7, git and the tool you chose above. Everything else depends on the sources you will use.

If you will use… You need How to check
Your tool VS Code with GitHub Copilot Chat The Chat view opens
Your tool GitHub Copilot CLI copilot --version
Your tool Claude Code 2.1.275 or later claude --version
Any source PowerShell 7 pwsh --version
Code or publishing git git --version
Azure Repos or Azure DevOps Wiki Git Credential Manager git credential-manager --version
Code in TFS / TFVC tf.exe (Visual Studio) tf help in a Developer PowerShell for VS
Dataverse pacx (or pac) pacx --version
GitHub (activity or GitHub Wiki) GitHub CLI gh auth status
Word, PowerPoint, Excel, PDF documents markitdown markitdown --version

Note: the agent installs nothing on its own. /power-platform-llm-wiki:init runs a read-only check (Test-Prerequisites.ps1) before the wizard and again after you confirm, on the sources you chose: it tells you what is missing, with the install command, and lets you decide.

✅ Verify: the commands you need reply with a version number. If pwsh is missing, stop: the wiki does not work without PowerShell 7.

Servono sempre PowerShell 7, git e lo strumento scelto qui sopra. Il resto dipende dalle fonti che userai.

Se userai… Ti serve Come controllare
Il tuo strumento VS Code con GitHub Copilot Chat Si apre la vista Chat
Il tuo strumento GitHub Copilot CLI copilot --version
Il tuo strumento Claude Code 2.1.275 o successivo claude --version
Qualsiasi fonte PowerShell 7 pwsh --version
Codice o pubblicazione git git --version
Azure Repos o Azure DevOps Wiki Git Credential Manager git credential-manager --version
Codice in TFS / TFVC tf.exe (Visual Studio) tf help in una Developer PowerShell for VS
Dataverse pacx (o pac) pacx --version
GitHub (attività o GitHub Wiki) GitHub CLI gh auth status
Documenti Word, PowerPoint, Excel, PDF markitdown markitdown --version

Nota: l'agente non installa nulla da solo. /power-platform-llm-wiki:init esegue un controllo in sola lettura (Test-Prerequisites.ps1) prima del wizard e di nuovo dopo la conferma, sulle fonti scelte: ti segnala cosa manca, con il comando per installarlo, e ti lascia decidere.

✅ Verifica: i comandi che ti servono rispondono con un numero di versione. Se pwsh manca, fermati: senza PowerShell 7 la wiki non funziona.

Step 1Passo 1

📦 Install the pluginInstalla il plugin

  1. In VS Code open Settings and enable Chat › Plugins: Enabled.
  2. In Chat › Plugins: Marketplaces add raythekool/power-platform-plugins.
  3. In the Extensions view search @agentPlugins power-platform-llm-wiki and install.

Steps 1 and 2 are equivalent to this snippet in settings.json:

  1. In VS Code apri Impostazioni e attiva Chat › Plugins: Enabled.
  2. In Chat › Plugins: Marketplaces aggiungi raythekool/power-platform-plugins.
  3. Nella vista Extensions cerca @agentPlugins power-platform-llm-wiki e installa.

I punti 1 e 2 equivalgono a questo frammento in settings.json:

settings.json
"chat.plugins.enabled": true,
"chat.plugins.marketplaces": [
  "raythekool/power-platform-plugins"
]

✅ Verify: in the chat, the agent list shows LLM Wiki.

✅ Verifica: nella chat, nell'elenco degli agenti compare LLM Wiki.

No Copilot CLI yet? Install it like thisNon hai ancora Copilot CLI? Installalo così

You need an active GitHub Copilot subscription, and your organization must allow it: an administrator can turn Copilot CLI off in the policies. On Windows you also need PowerShell 6 or later, already covered by PowerShell 7 from step 0.

Ti servono un abbonamento GitHub Copilot attivo e il via libera dell'organizzazione: un amministratore può disattivare Copilot CLI nelle policy. Su Windows serve anche PowerShell 6 o successivo, già coperto da PowerShell 7 del passo 0.

SystemSistema CommandComando
Windows winget install GitHub.Copilot
macOS or LinuxmacOS o Linux brew install --cask copilot-cli
Any system, with Node.js 22+Qualsiasi sistema, con Node.js 22+ npm install -g @github/copilot

Then open a new terminal and start copilot. If you are not signed in to GitHub, type /login in the session and follow the instructions on screen. Exit the session and come back here to install the plugin.

Poi apri un nuovo terminale e avvia copilot. Se non sei collegato a GitHub, scrivi /login nella sessione e segui le istruzioni a schermo. Esci dalla sessione e torna qui per installare il plugin.

✅ Verify: copilot --version answers with a version number. Other install methods: GitHub documentation.

✅ Verifica: copilot --version risponde con un numero di versione. Altri metodi di installazione: documentazione di GitHub.

Install from a terminal. Inside a session the same commands work as /plugin marketplace add ... and /plugin install ....

Installa da un terminale. In una sessione gli stessi comandi funzionano come /plugin marketplace add ... e /plugin install ....

GitHub Copilot CLI
copilot plugin marketplace add raythekool/power-platform-plugins
copilot plugin install power-platform-llm-wiki@power-platform-plugins

✅ Verify: copilot plugin list shows power-platform-llm-wiki, and in a session /agent lists LLM Wiki.

✅ Verifica: copilot plugin list mostra power-platform-llm-wiki e in una sessione /agent elenca LLM Wiki.

Claude Code 2.1.275 or later (claude --version). One step, from a terminal:

Claude Code 2.1.275 o successivo (claude --version). Un solo passo, da un terminale:

Claude Code
claude plugin install power-platform-llm-wiki --marketplace raythekool/power-platform-plugins

Or in two steps, from your shell or inside a session as /plugin ...:

Oppure in due passi, dalla shell o dentro una sessione come /plugin ...:

Claude Code
claude plugin marketplace add raythekool/power-platform-plugins
claude plugin install power-platform-llm-wiki@power-platform-plugins

The skills are called /power-platform-llm-wiki:init, :config, :update, :ingest and :query.

Le skill si chiamano /power-platform-llm-wiki:init, :config, :update, :ingest e :query.

✅ Verify: claude plugin list shows power-platform-llm-wiki; typing /power-platform-llm-wiki: in a session autocompletes the skills.

✅ Verifica: claude plugin list mostra power-platform-llm-wiki; scrivendo /power-platform-llm-wiki: in una sessione le skill si completano da sole.

Step 2Passo 2

🚪 Start /power-platform-llm-wiki:initAvvia /power-platform-llm-wiki:init

  1. Open in VS Code the folder of the project repository, the one that will host the llm-wiki/ folder.
  2. In the chat type /power-platform-llm-wiki:init, not /init (the VS Code command that creates the project instructions).
  1. In a terminal go to the folder of the project repository, the one that will host the llm-wiki/ folder, and start copilot.
  2. Type /power-platform-llm-wiki:init, not /init (the Copilot CLI command that creates the project instructions).
  1. In a terminal go to the folder of the project repository, the one that will host the llm-wiki/ folder, and start claude.
  2. Type /power-platform-llm-wiki:init.
  3. Answer the questions: the other skills use the same prefix.

The wizard first asks for the mode:

Recommended🧭 GuidedFirst time, or you do not know the configuration files.
📝 Self-serviceYou already know what you want: it creates a commented wiki.config.yml, you fill it in and then run /power-platform-llm-wiki:config.

The rest of this page follows the guided mode.

  1. Apri in VS Code la cartella del repository del progetto, quello che ospiterà la cartella llm-wiki/.
  2. Nella chat scrivi /power-platform-llm-wiki:init, non /init (il comando di VS Code che crea le istruzioni del progetto).
  1. In un terminale entra nella cartella del repository del progetto, quello che ospiterà la cartella llm-wiki/, e avvia copilot.
  2. Scrivi /power-platform-llm-wiki:init, non /init (il comando di Copilot CLI che crea le istruzioni del progetto).
  1. In un terminale entra nella cartella del repository del progetto, quello che ospiterà la cartella llm-wiki/, e avvia claude.
  2. Scrivi /power-platform-llm-wiki:init.
  3. Rispondi alle domande: le altre skill usano lo stesso prefisso.

Il wizard ti chiede subito la modalità:

Consigliato🧭 GuidatoPrima volta, o non conosci i file di configurazione.
📝 Self-serviceSai già cosa vuoi: crea un file wiki.config.yml commentato, lo compili tu e poi lanci /power-platform-llm-wiki:config.

Il resto di questa pagina segue la modalità guidata.

Step 3Passo 3

🏷️ Project, profiles and toolsProgetto, profili e strumenti

The wizard asks: project name, content language, profiles, agent tools.

  • Name: shown in the header of the published wiki. Example: Sales.
  • Language: it for Italian content (default), en for English.
  • Profiles: you can pick more than one.
power-platformDynamics 365 CE / Dataverse: plugins, PCF, web resources, flows, solutions.
dynamics-fnoFinance & Operations: tables, extensions, classes, data entities, security.
genericIntegrations, Azure Functions, APIs, .NET.

Agent tools: the tools the team will use with the wiki (more than one is fine). The wizard pre-selects the one you are running /power-platform-llm-wiki:init from.

vscodeGitHub Copilot in VS Code.Writes .vscode/mcp.json
copilot-cliGitHub Copilot CLI.Writes .mcp.json
claude-codeClaude Code.Writes .mcp.json and CLAUDE.md

✅ Verify: the chosen profiles match what is really in the code, and the tools match the team. When in doubt pick the ones you need now: you can change them later with /power-platform-llm-wiki:config.

Il wizard chiede: nome del progetto, lingua dei contenuti, profili, strumenti.

  • Nome: compare nell'intestazione della wiki pubblicata. Esempio: Vendite.
  • Lingua: it per contenuti in italiano (predefinito), en per inglese.
  • Profili: puoi sceglierne più di uno.
power-platformDynamics 365 CE / Dataverse: plugin, PCF, web resource, flow, soluzioni.
dynamics-fnoFinance & Operations: tabelle, estensioni, classi, data entity, sicurezza.
genericIntegrazioni, Azure Functions, API, .NET.

Strumenti: quelli che il team userà con la wiki (anche più di uno). Il wizard preseleziona quello da cui stai lanciando /power-platform-llm-wiki:init.

vscodeGitHub Copilot in VS Code.Scrive .vscode/mcp.json
copilot-cliGitHub Copilot CLI.Scrive .mcp.json
claude-codeClaude Code.Scrive .mcp.json e CLAUDE.md

✅ Verifica: i profili scelti corrispondono a ciò che c'è davvero nel codice e gli strumenti a quelli del team. In caso di dubbio scegli quelli che ti servono ora: li cambi più avanti con /power-platform-llm-wiki:config.

Step 4Passo 4

🔌 SourcesFonti

All sources are optional. The wizard proposes them one at a time: answer Yes only for those you have.

Source What it asks Notes
🧬 Code repository name, provider (azure-devops, github, tfvc, local), then URL, local folder and branch (git) or collection URL and $/... path (TFVC) Recommended: the code is the primary source of the as-built documentation
📋 Azure DevOps Boards organization, project, areas and iterations (optional) Sign-in with your Microsoft account: no PAT needed
🗄️ Dataverse solution unique names, publisher prefixes Uses the active pacx auth profile: check with pacx auth ping
🏭 F&O metadata folders of the custom packages (e.g. <repo>/Metadata/<Package>) Do not list Microsoft standard packages
🐙 GitHub activity list of owner/repo Pull requests, issues, branches
📂 SharePoint site URL and libraries Documents must be downloaded into raw/ by hand

Example for a CE project on Azure DevOps

  • Code repository: name crm-solution, provider azure-devops, branch develop, local folder ../crm-solution.
  • Boards: organization contoso, project Sales.
  • Dataverse: solution SalesCore, prefix cts_.

Code not in git? Common in older F&O projects with the code in TFS. Use provider: tfvc with tf.exe (Visual Studio), the collection URL (e.g. https://tfs.contoso.local/tfs/DefaultCollection), the $/Project/Trunk/Main path and a local folder; on an F&O developer VM use the folder the workspace already maps. No tf.exe? Download the folder from the web portal (Repos → Files → Download as Zip) and use provider: local. The agent only reads TFVC (get, history), never checks in or out; without git, changes are found by file hashes and pages cite the changeset (fno@C1234:...).

Important: never write passwords, tokens or keys in the answers or in the configuration file. Access uses your account (Microsoft Entra ID, az login, pacx auth).

✅ Verify: for every repository the local folder exists (or will be cloned). For Dataverse, pacx auth ping replies.

Tutte le fonti sono facoltative. Il wizard le propone una per volta: rispondi Sì solo a quelle che hai.

Fonte Cosa ti chiede Note
🧬 Repository di codice nome, provider (azure-devops, github, tfvc, local), poi URL, cartella locale e branch (git) oppure URL della collection e percorso $/... (TFVC) Consigliata: il codice è la fonte primaria della documentazione as-built
📋 Azure DevOps Boards organizzazione, progetto, aree e iterazioni (facoltative) Accesso con il tuo account Microsoft: non serve nessun PAT
🗄️ Dataverse nomi univoci delle soluzioni, prefissi del publisher Usa il profilo pacx auth attivo: controlla con pacx auth ping
🏭 Metadati F&O cartelle dei package personalizzati (es. <repo>/Metadata/<Package>) Non indicare i package standard Microsoft
🐙 Attività GitHub elenco owner/repo Pull request, issue, branch
📂 SharePoint URL del sito e librerie I documenti vanno scaricati in raw/ a mano

Esempio per un progetto CE su Azure DevOps

  • Repository di codice: nome crm-solution, provider azure-devops, branch develop, cartella locale ../crm-solution.
  • Boards: organizzazione contoso, progetto Vendite.
  • Dataverse: soluzione VenditeCore, prefisso cts_.

Il codice non è in git? Capita spesso nei progetti F&O più vecchi, con il codice in TFS. Usa provider: tfvc con tf.exe (Visual Studio), l'URL della collection (es. https://tfs.contoso.local/tfs/DefaultCollection), il percorso $/Progetto/Trunk/Main e una cartella locale; su una VM di sviluppo F&O usa la cartella già mappata dal workspace. Niente tf.exe? Scarica la cartella dal portale web (Repos → Files → Download as Zip) e usa provider: local. L'agente legge TFVC soltanto (get, history), non fa mai check-in né check-out; senza git le modifiche si riconoscono dagli hash dei file e le pagine citano il changeset (fno@C1234:...).

Importante: non scrivere mai password, token o chiavi nelle risposte o nel file di configurazione. L'accesso avviene con il tuo account (Microsoft Entra ID, az login, pacx auth).

✅ Verifica: per ogni repository la cartella locale esiste (o verrà clonata). Per Dataverse, pacx auth ping risponde.

Step 5Passo 5

🌐 PublishingPubblicazione

The wizard asks: where to publish the wiki.

Most common🔷 Azure DevOps - project wikiThe wiki of the Azure DevOps project.Asks: organization, project, wiki name
🔷 Azure DevOps - code wikiThe wiki is a folder of a repository.Asks: repository, branch, folder
🐙 GitHub WikiThe project lives on GitHub.Asks: owner/repo
⏭️ NoneFor now you read the wiki only in your own tool.

Optional: a parent page (for example Knowledge Base) under which the whole wiki is mounted.

Note: automatic publishing without confirmation is off by default: before every push you see the changes and must confirm.

✅ Verify: you have the details to access the target wiki at hand (write permission included). You can also choose "None" and configure it later.

Il wizard chiede: dove pubblicare la wiki.

Caso più comune🔷 Azure DevOps - project wikiLa wiki del progetto Azure DevOps.Chiede: organizzazione, progetto, nome wiki
🔷 Azure DevOps - code wikiLa wiki è una cartella di un repository.Chiede: repository, branch, cartella
🐙 GitHub WikiIl progetto vive su GitHub.Chiede: owner/repo
⏭️ NessunaPer ora consulti la wiki solo nel tuo strumento.

Facoltativo: una pagina madre (esempio Knowledge Base) sotto cui montare tutta la wiki.

Nota: la pubblicazione automatica senza conferma è disattivata per impostazione predefinita: prima di ogni push vedrai le modifiche e dovrai confermare.

✅ Verifica: hai a portata di mano i dati per accedere alla wiki di destinazione (permessi di scrittura inclusi). Puoi anche scegliere "Nessuna" e configurarla più tardi.

Step 6Passo 6

🛡️ GovernanceGovernance

The wizard asks:

Question Recommended Meaning
Redact personal data? Yes Only names and roles of participants are kept
After how many days is a page "stale"? 30 The lint flags pages not updated beyond this threshold
Who certifies the pages? first and last names Optional; tells who can declare a page "certified"

✅ Verify: you have at least one name for certification, typically a key user or a customer contact. The full process is in governance.md.

Il wizard chiede:

Domanda Valore consigliato Significato
Redigere i dati personali? Sì Dei partecipanti restano solo nomi e ruoli
Dopo quanti giorni una pagina è "vecchia"? 30 Il lint segnala le pagine non aggiornate oltre questa soglia
Chi certifica le pagine? nomi e cognomi Facoltativo; serve a sapere chi può dichiarare una pagina "certificata"

✅ Verifica: hai almeno un nome per la certificazione, tipicamente un key user o un referente del cliente. Il processo completo è in governance.md.

Step 7 · GitHub repositories onlyPasso 7 · solo repository su GitHub

🤖 AutomationAutomazione

The wizard asks this only if the host repository is on GitHub.

To startweeklyAutomatic weekly update.
dailyUpdate every day.
manualNo automation: you update with /power-platform-llm-wiki:update --full.

If you choose a schedule, the agent gives you the text to paste in Repository → Agents → Automations → Create new → On a schedule. If the repository is on Azure DevOps, skip this step and run /power-platform-llm-wiki:update --full from your tool when needed.

Sprint (Azure DevOps Boards only): length (default 2 weeks) and name format (YYYY-SNN).

Il wizard te lo chiede solo se il repository ospite è su GitHub.

Per iniziareweeklyAggiornamento settimanale automatico.
dailyAggiornamento ogni giorno.
manualNessuna automazione: aggiorni tu con /power-platform-llm-wiki:update --full.

Se scegli una pianificazione, l'agente ti dà il testo da incollare in Repository → Agents → Automations → Create new → On a schedule. Se il repository è su Azure DevOps, salta questo passo e lancia /power-platform-llm-wiki:update --full dal tuo strumento quando serve.

Sprint (solo con Azure DevOps Boards): durata (predefinita 2 settimane) e formato del nome (YYYY-SNN).

Step 8Passo 8

✅ Confirm and verifyConferma e verifica

  1. The wizard shows a summary of the configuration and the list of files it creates or changes. Review it calmly.
  2. Answer Yes to proceed, No to cancel without writing anything.

At the end the project contains:

What What it is for
llm-wiki/wiki.config.yml Your choices (edit by hand or with /power-platform-llm-wiki:config)
llm-wiki/raw/ Where you put FDD, TDD, minutes and other documents
llm-wiki/wiki/ The wiki itself (Markdown pages)
llm-wiki/.engine/ and AGENTS.md The engine managed by the plugin: do not edit
.vscode/mcp.json VS Code: the Azure DevOps connection, if you use Boards
.mcp.json Copilot CLI and Claude Code: the same connection
.github/copilot-instructions.md The instructions that make the agent use the wiki (VS Code, Copilot CLI)
CLAUDE.md Claude Code: imports the same instructions with @.github/copilot-instructions.md

MCP files appear only when a server is needed (Boards or MarkItDown), and only for the chosen tools.

First start of Claude Code: approve the servers from .mcp.json when prompted, then sign in to ado-remote with /mcp. With /context check that CLAUDE.md is listed under Memory files.

First start of Copilot CLI: accept the folder trust prompt when you start copilot: servers from .mcp.json load only in trusted folders. Check with /mcp that ado-remote is there.

Wiki created with an older plugin version? Run /power-platform-llm-wiki:config, choose agent tools and add your tool: it creates the missing files without touching the rest.

Final check (the agent runs it, but you can repeat it):

  1. Il wizard mostra un riepilogo della configurazione e l'elenco dei file che crea o modifica. Controllalo con calma.
  2. Rispondi Sì per procedere, No per annullare senza scrivere nulla.

Al termine il progetto contiene:

Cosa A cosa serve
llm-wiki/wiki.config.yml Le tue scelte (puoi modificarlo a mano o con /power-platform-llm-wiki:config)
llm-wiki/raw/ Dove metti FDD, TDD, verbali e altri documenti
llm-wiki/wiki/ La wiki vera e propria (pagine Markdown)
llm-wiki/.engine/ e AGENTS.md Il motore gestito dal plugin: non modificarli
.vscode/mcp.json VS Code: il collegamento ad Azure DevOps, se usi le Boards
.mcp.json Copilot CLI e Claude Code: lo stesso collegamento
.github/copilot-instructions.md Le istruzioni che fanno usare la wiki all'agente (VS Code, Copilot CLI)
CLAUDE.md Claude Code: importa le stesse istruzioni con @.github/copilot-instructions.md

I file MCP compaiono solo se serve un server (Boards o MarkItDown), e solo per gli strumenti scelti.

Primo avvio di Claude Code: approva i server di .mcp.json quando te lo chiede, poi accedi ad ado-remote con /mcp. Con /context controlla che CLAUDE.md compaia tra i Memory files.

Primo avvio di Copilot CLI: accetta la richiesta di fiducia nella cartella quando avvii copilot: i server di .mcp.json si caricano solo nelle cartelle attendibili. Controlla con /mcp che ado-remote compaia.

Wiki creata con una versione precedente del plugin? Lancia /power-platform-llm-wiki:config, scegli strumenti e aggiungi il tuo: crea i file mancanti senza toccare il resto.

Verifica finale (la fa l'agente, ma puoi ripeterla):

PowerShell
pwsh llm-wiki/.engine/scripts/Test-WikiLint.ps1 -WikiPath llm-wiki/wiki

✅ Verify: the result shows 0 errors. Then commit the created files.

✅ Verifica: il risultato deve indicare 0 errori. Poi fai commit dei file creati.

Step 9Passo 9

🚀 Build the first wikiCostruisci la prima wiki

Choose based on the sources you enabled:

If you enabled… Tell the agent
🧬 Code /power-platform-llm-wiki:update --source code
🗄️ Dataverse /power-platform-llm-wiki:update --source dataverse
🏭 F&O /power-platform-llm-wiki:update --source fno
📋 Boards /power-platform-llm-wiki:update --source devops
📄 Existing documents copy the files into llm-wiki/raw/analysis/, specs/ or meetings/, then /power-platform-llm-wiki:ingest raw/<folder>/<file>

When you are done:

  1. /power-platform-llm-wiki:update --lint checks the quality (it must stay at 0 errors).
  2. /power-platform-llm-wiki:query "how is the sales module built?" tries a question on the wiki.
  3. /power-platform-llm-wiki:update --publish publishes, if you configured publishing.

Scegli in base alle fonti che hai attivato:

Se hai attivato… Scrivi all'agente
🧬 Codice /power-platform-llm-wiki:update --source code
🗄️ Dataverse /power-platform-llm-wiki:update --source dataverse
🏭 F&O /power-platform-llm-wiki:update --source fno
📋 Boards /power-platform-llm-wiki:update --source devops
📄 Documenti già pronti copia i file in llm-wiki/raw/analysis/, specs/ o meetings/, poi /power-platform-llm-wiki:ingest raw/<cartella>/<file>

Quando hai finito:

  1. /power-platform-llm-wiki:update --lint controlla la qualità (deve restare a 0 errori).
  2. /power-platform-llm-wiki:query "come è fatto il modulo vendite?" prova una domanda sulla wiki.
  3. /power-platform-llm-wiki:update --publish pubblica, se hai configurato la pubblicazione.

After the wizardDopo il wizard

Change your mind later.

Cambiare idea più tardi.

No need to run /power-platform-llm-wiki:init again. Type /power-platform-llm-wiki:config and choose what to change: sources, profiles, language, publishing, governance, automation. After a plugin update run /power-platform-llm-wiki:config --refresh-engine, then /power-platform-llm-wiki:update --lint.

Non devi rifare /power-platform-llm-wiki:init. Scrivi /power-platform-llm-wiki:config e scegli cosa cambiare: fonti, profili, lingua, pubblicazione, governance, automazione. Dopo un aggiornamento del plugin lancia /power-platform-llm-wiki:config --refresh-engine, poi /power-platform-llm-wiki:update --lint.

🩺 If something does not workSe qualcosa non funziona

The LLM Wiki agent (or its commands) does not appearL'agente LLM Wiki (o i suoi comandi) non compare

Check Chat › Plugins: Enabled and that the plugin is installed; restart VS Code.

Controlla Chat › Plugins: Enabled e che il plugin sia installato; riavvia VS Code.

Run copilot plugin list: if the plugin is missing, repeat the install, then restart the session and try /agent.

Esegui copilot plugin list: se il plugin manca, ripeti l'installazione, poi riavvia la sessione e prova /agent.

Run claude plugin list: if the plugin is missing, repeat the install and restart the session. The commands start with /power-platform-llm-wiki:: type it and use autocomplete.

Esegui claude plugin list: se il plugin manca, ripeti l'installazione e riavvia la sessione. I comandi iniziano con /power-platform-llm-wiki:: scrivilo e usa il completamento.

pwsh not foundpwsh non trovato

Install PowerShell 7 and reopen your tool (VS Code or the terminal).

Installa PowerShell 7 e riapri il tuo strumento (VS Code o il terminale).

Cloning from Azure Repos keeps asking for credentialsIl clone di Azure Repos chiede le credenziali di continuo

Install Git Credential Manager and sign in with your account.

Installa Git Credential Manager e accedi con il tuo account.

tf not found (code in TFVC)tf non trovato (codice in TFVC)

Open a Developer PowerShell for VS, or switch to provider: local with a copy downloaded from the web portal.

Apri una Developer PowerShell for VS, oppure passa a provider: local con una copia scaricata dal portale web.

TFVC reports pending changes in the workspaceTFVC segnala modifiche in sospeso nel workspace

The agent stops so it never touches your work: check in or undo your changes yourself, or use a dedicated workspace.

L'agente si ferma per non toccare il tuo lavoro: fai check-in o annulla le modifiche tu, oppure usa un workspace dedicato.

Dataverse does not respondDataverse non risponde

Run pacx auth list and pacx auth ping; select the right profile with pacx auth select.

Esegui pacx auth list e pacx auth ping; seleziona il profilo giusto con pacx auth select.

Boards return no dataLe Boards non restituiscono dati

Check organization and project with /power-platform-llm-wiki:config and make sure you have access to the project.

Controlla organizzazione e progetto con /power-platform-llm-wiki:config e verifica di avere accesso al progetto.

The lint reports errors after /power-platform-llm-wiki:initIl lint segnala errori dopo /power-platform-llm-wiki:init

Read the error list (or the llm-wiki/wiki/lint-*.md report generated by /power-platform-llm-wiki:update --lint), fix and run /power-platform-llm-wiki:update --lint again.

Leggi l'elenco degli errori (o il report llm-wiki/wiki/lint-*.md generato da /power-platform-llm-wiki:update --lint), correggi e rilancia /power-platform-llm-wiki:update --lint.

You want to start overVuoi ripartire da zero

Run /power-platform-llm-wiki:init again: it does not overwrite pages or documents already in raw/.

Rilancia /power-platform-llm-wiki:init: non sovrascrive le pagine né i documenti già presenti in raw/.