bc-claude-plugin

bc-claude-plugin

Claude Code plugin met 19 skills en een ingebouwde knowledge base voor BC AL-ontwikkeling. Maakt Claude tot een BC-expert die direct productief is in elk AL-project.

---

Installatie

Via de plugin marketplace (aanbevolen)

In een Claude Code sessie:

/plugin marketplace add appfabriek/bc-claude-plugin
/plugin install bc-claude-plugin@bc-claude-plugin

Lokaal installeren

git clone https://github.com/appfabriek/bc-claude-plugin.git ~/code/bc-claude-plugin

In een Claude Code sessie:

/plugin install /pad/naar/bc-claude-plugin

Verwijderen

/plugin uninstall bc-claude-plugin

Vereisten

• Claude Code v1.0.33 of hoger (controleer: claude --version)
• GitHub CLI (gh) — vereist voor /diagnose en /bc-query
• VS Code met AL Language extensie — vereist voor /dev-publish

Setup voor /diagnose en /bc-query

Deze commands vereisen een GitHub Actions workflow in je AL-project. Kopieer het workflow template uit deze plugin naar je project:

cp ~/code/bc-claude-plugin/templates/bc-diagnostic.yaml \
   /pad/naar/jouw-al-project/.github/workflows/bc-diagnostic.yaml

Stel de volgende GitHub Secrets in voor je repo:

• BC_URL_DEV, BC_USER_DEV, BC_PASS_DEV
• BC_URL_TEST, BC_USER_TEST, BC_PASS_TEST
• BC_URL_ACCEPT, BC_USER_ACCEPT, BC_PASS_ACCEPT
• BC_URL_PRODUCTION, BC_USER_PRODUCTION, BC_PASS_PRODUCTION

Zorg dat je GitHub Actions runners de juiste runs-on labels hebben (dev, test, accept, production) en de AL-omgevingen kunnen bereiken.

---

Skills (19 commands)

Build & Deploy

Commando	Doel
/dev-publish	Compileer en publiceer AL-app naar BC dev server
/bc-ps [taak]	Genereer BcContainerHelper PowerShell scripts
/bc-devops [--init|--update]	Genereer/update GitHub Actions CI/CD workflows

Diagnostics & Data

Commando	Doel
/diagnose [vraag]	Remote AL-diagnostics via GitHub Actions
/bc-query [vraag]	Datavragen in gewoon Nederlands
/bc-env [omgeving]	Inspecteer BC-omgeving: apps, versies, vergelijk

Code Quality

Commando	Doel
/bc-review [bestand]	Review AL-code tegen Microsoft-richtlijnen
/bc-perf [--scan|--query]	Scan op performance anti-patterns
/bc-test [codeunit]	Genereer en voer AL-tests uit

Code Generation

Commando	Doel
/bc-new <type> [naam]	Scaffold nieuw AL-object
/bc-api <tabel> [--query]	Genereer API page of API query
/bc-copilot <naam>	Scaffold BC Copilot capability (System.AI)
/bc-events [--list|--subscribe|--publish]	BC events zoeken, subscriben, publiceren
/bc-permissions [--generate|--audit]	Genereer of audit permission sets
/bc-telemetry [--add|--review|--kql]	Telemetry toevoegen, reviewen, KQL genereren

Lifecycle

Commando	Doel
/bc-upgrade [--analyze|--generate]	Analyseer en genereer upgrade-codeunits
/bc-migrate [--from X --to Y]	BC versie-migratie assistent
/bc-translate	Vertalingen synchroniseren in alle XLF-bestanden
/bc-product [--spec|--roadmap|--changelog]	ISV product workflow

---

Knowledge Base

De plugin bevat een ingebouwde kennisbank van 19 bestanden zodat Claude direct productief is:

Categorie	Bestanden
AL Development	al-guidelines.md, bc-tables.md, bc-events.md, bc-static-analysis.md
Patterns	bc-api-patterns.md, bc-test-patterns.md, bc-copilot-patterns.md, bc-telemetry-patterns.md
Architecture	bc-architecture-decisions.md, bc-upgrade-patterns.md, bc-permissions.md, bc-reports.md
DevOps	bc-devops-patterns.md, bc-powershell.md, bc-debugging.md
ISV	bc-appsource.md, bc-version-matrix.md, bc-dataverse.md
Diagnostics	diagnostic-recipes.md

Skills lezen deze bestanden automatisch — geen extra setup nodig.

---

Development Workflow

De plugin volgt de Superpowers workflow:

1. Design before code — begrijp het probleem, stel oplossingen voor
2. Plan with exact details — concrete stappen, geen vage instructies
3. Compile-verify cycle — compileer na elke wijziging, verifieer op server
4. Systematic debugging — lees foutmeldingen, één hypothese per keer
5. Evidence over claims — toon compile output, nooit "het zou moeten werken"

---

Setup voor je team

Stap 1 — Plugin installeren

/install-plugin github:appfabriek/bc-claude-plugin

Stap 2 — .NET Framework reference assemblies (macOS)