mirror of
https://github.com/microsoft/BCQuality.git
synced 2026-10-05 22:56:55 +01:00
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:
parent
2d0f1c1eec
commit
85b2acc372
3 changed files with 82 additions and 25 deletions
|
|
@ -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.
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue