Tilfoej Microsoft Learn MCP til udviklere + goer add_repo konkret

To ting fra QualityHub-sporet:

1. Udviklere faar nu samme Microsoft Learn MCP som Mode C-supportbrugere
   allerede havde (https://learn.microsoft.com/api/mcp, HTTP, ingen auth) -
   registreret maskin-globalt via sync-bcquality-knowledge.ps1, samme
   moenster som al/businesscentral. Lukker hullet hvor udviklere kun havde
   den statiske microsoft/-videnfil-snapshot og ingen live dokumentationssoegning.

2. add_repo-mekanismen i curabis-app-sources-must-be-checked-first.md var
   kun naevnt, aldrig defineret - intet vaerktoej med det navn findes i
   Claude Code CLI. Erstattet med en konkret, testet mekanisme: en
   vedvarende, opdateret klon i ~/.claude/reference-repos/<org>/<repo>/,
   samme moenster som BCQualitys egen kanal-klon. Testet live mod det
   faktiske microsoft/BCApps-repo (shallow clone ~52s, ~36.000 .al-filer,
   git pull --depth 1 til opdatering).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
Michael Dieringer 2026-07-31 20:03:10 +02:00
parent 2d0f1c1eec
commit 85b2acc372
3 changed files with 82 additions and 25 deletions

View file

@ -1,7 +1,7 @@
---
bc-version: [all]
domain: architecture
keywords: [dependency, source, add-repo, github, curabis, closed-source, test, symbol, black-box]
keywords: [dependency, source, reference-repos, clone, github, curabis, closed-source, test, symbol, black-box]
technologies: [al]
countries: [w1]
application-area: [all]
@ -17,10 +17,31 @@ customer project imports one of these apps, it typically arrives as a compiled
This makes the app look like a closed external dependency. It is not.
Before treating any CURABIS-owned dependency app as a black box, the agent
must check whether its source is available via `add_repo` (GitHub). Reverse-
engineering compiled symbol packages (`SymbolReference.json`, `.app` manifest
inspection) is always an inferior substitute for reading the actual production
source, and produces lower-confidence tests and code reviews.
must check whether its source is available on GitHub and read it directly.
Reverse-engineering compiled symbol packages (`SymbolReference.json`, `.app`
manifest inspection) is always an inferior substitute for reading the actual
production source, and produces lower-confidence tests and code reviews.
**How to actually get the source (2026-07-30 — was previously the underspecified
`add_repo <repo>`, which is not a real tool in most Claude Code sessions):**
- **Claude Code CLI** (this is the common case): maintain a persistent,
periodically-refreshed clone at `~/.claude/reference-repos/<org>/<repo>/` —
same pattern as BCQuality's own channel clone. Before reading, check if it
exists:
- Missing: `git clone --depth 1 <url> "$env:USERPROFILE\.claude\reference-repos\<org>\<repo>"`
(shallow — you need current source, not history)
- Exists: `git -C "$env:USERPROFILE\.claude\reference-repos\<org>\<repo>" pull --depth 1`
(refresh before trusting it — a stale clone from a prior session is a
silent source of wrong answers)
- Then `Read`/`Grep`/`Glob` it like any other local path.
- **Claude Code on web** (claude.ai/code): use the session's repo picker /
"add repository" action instead, if the UI offers one — there is no shell
to clone into in that environment.
Verify which of these your actual session supports before assuming either
works — do not silently fall back to symbol inspection if neither succeeds;
flag the limitation explicitly instead (see "When cloning fails" below).
## Known CURABIS app repos
@ -29,7 +50,7 @@ source, and produces lower-confidence tests and code reviews.
| Contract Management 365 app | https://github.com/Curabis/ContractMgmt365app.git | Main contract engine; depended on by most CURABIS customer projects |
| Project Management 365 app | https://github.com/Curabis/ProjectMgmt365app.git | |
| Cross Channel Management 365 app | https://github.com/Curabis/WebStore.git | |
| Summatim | https://github.com/MichaelDieringer/-summatim.git | Currently restricted — only mid has access; add_repo will fail for other team members |
| Summatim | https://github.com/MichaelDieringer/-summatim.git | Currently restricted — only mid has access; the clone will fail for other team members |
*Expand this table when new CURABIS apps are created. If an app is not listed here,
ask `mid` whether source is available before reverting to symbol inspection.*
@ -42,10 +63,12 @@ available at:
- https://github.com/microsoft/BCApps
Use `add_repo microsoft/BCApps` when you need to understand internals of
Microsoft standard codeunits (e.g. Sales-Post, Gen. Jnl.-Post Line, Copy Document
Mgt.) that are referenced by event subscribers but whose source is not visible in
the current project.
Clone it to `~/.claude/reference-repos/microsoft/BCApps/` (see the mechanism
above) when you need to understand internals of Microsoft standard codeunits
(e.g. Sales-Post, Gen. Jnl.-Post Line, Copy Document Mgt.) that are referenced
by event subscribers but whose source is not visible in the current project.
It is a large public monorepo — a shallow clone is still the right call, and
worth refreshing rather than re-cloning once it exists.
## Anti Pattern
@ -56,8 +79,9 @@ the current project.
## Best Practice
// CORRECT: add the source repo and read it directly
add_repo Curabis/ContractMgmt365app
// CORRECT: clone the source repo and read it directly
git clone --depth 1 https://github.com/Curabis/ContractMgmt365app.git `
"$env:USERPROFILE\.claude\reference-repos\Curabis\ContractMgmt365app"
// Then read the actual table definitions, codeunits, and any Test Library
// codeunits that may already exist in the repo's own test app.
@ -75,5 +99,8 @@ Apply at the start of any task involving:
- Building GIVEN helpers for a CURABIS-owned app's tables
- Code-reviewing changes to codeunits that extend CURABIS-owned apps
If `add_repo` fails due to access restrictions (see table above), flag the
limitation explicitly rather than silently falling back to symbol inspection.
## When cloning fails
If the clone fails due to access restrictions (see table above) or your
session has no shell to clone into, flag the limitation explicitly rather
than silently falling back to symbol inspection.