new global standard

2026-08-08 10:26:52 +01:00 · 2026-06-21 12:22:54 +02:00 · 2026-06-21 12:22:54 +02:00 · 985faf9e8d
commit 985faf9e8d
parent bdda44ef8a
8 changed files with 818 additions and 0 deletions
--- a/custom/setup/curabis-standard.agent.md
+++ b/custom/setup/curabis-standard.agent.md
@ -0,0 +1,355 @@
+---
+kind: action-skill
+id: curabis-standard-setup
+version: 1
+title: CURABIS Standard — Project Setup
+description: >
+  Configures a new or existing repository to the CURABIS Standard development
+  environment. Writes CLAUDE.md, BCQuality agents, .mcp.json and cspell.json
+  from authoritative templates in BCQuality. Deploys bc-mcp-bridge.js to the
+  developer's machine. Also handles updates to an already-configured project.
+inputs: [repo-root]
+outputs: [CLAUDE.md, .mcp.json, .github/.agents/*, cspell.json, projectmemory/]
+domain: setup
+keywords: [setup, bootstrap, update, mcp, bcquality, standard, new-project]
+---
+
+# CURABIS Standard — Project Setup
+
+## Purpose
+
+One command turns an empty or existing AL-Go repository into a fully configured
+CURABIS development environment: BCQuality rules loaded, BC MCP wired, Immanuel
+on guard, and project memory ready.
+
+## Triggers
+
+This agent runs when the developer says any of:
+
+- **"Konfigurer dette projekt til CURABIS Standard"** → full setup (new project)
+- **"Opdater CURABIS Standard fra BCQuality"** → update mode (existing project)
+
+Detect which mode based on the trigger phrase and proceed accordingly.
+
+## Source URLs (BCQuality — always fetch fresh)
+
+```
+BASE = https://raw.githubusercontent.com/Curabis/BCQuality/main/custom/setup
+```
+
+| Artefakt | URL |
+|---|---|
+| bc-mcp-bridge.js | `{BASE}/bc-mcp-bridge.js` |
+| bc-mcp.config.template.json | `{BASE}/machine/bc-mcp.config.template.json` |
+| bcquality.agent.md | `{BASE}/templates/bcquality.agent.md` |
+| immanuel.agent.md | `{BASE}/templates/immanuel.agent.md` |
+| cspell.json | `{BASE}/templates/cspell.json` |
+
+CLAUDE.md and .mcp.json are generated dynamically — not fetched as static templates
+because they contain project-specific paths.
+
+---
+
+## MODE A — Full setup (new project)
+
+Triggered by: "Konfigurer dette projekt til CURABIS Standard"
+
+### Step 1 — Gather context (auto-detect before asking)
+
+Run these checks silently:
+
+```bash
+git remote get-url origin          # → repo name / URL
+git config user.email              # → developer identity
+git config user.name
+```
+
+Check whether these paths exist:
+- `.vscode/find-altool.ps1`        → AL MCP available
+- `CLAUDE.md`                      → already configured?
+- `~/.claude/bc-mcp-bridge.js`     → bridge already installed?
+- `~/.bc-mcp.config.json`          → BC credentials present?
+
+If `CLAUDE.md` already exists, ask: "CLAUDE.md eksisterer allerede. Overskrive? (ja/nej)"
+Stop if the developer answers no.
+
+### Step 2 — Ask exactly three questions
+
+Do not proceed until all three are answered.
+
+```
+1. Hvad er projektets navn?
+   (bruges som overskrift i CLAUDE.md og i projectmemory)
+
+2. Hvilke AL-app mapper er i repoen?
+   Eksempler:
+     a) Flad struktur — kildefiler direkte i roden (AppSource/)
+     b) .apps/<AppName>  (main app)
+     c) .apps/<AppName> + .apps/<AppName>.Test  (main + test)
+   Angiv de faktiske mapper.
+
+3. Hvad er dit brugernavn til projectmemory-filen?
+   (f.eks. "mid" → memoryupdates_mid.md)
+```
+
+### Step 3 — Deploy machine files
+
+#### 3a. bc-mcp-bridge.js
+
+1. Fetch `{BASE}/bc-mcp-bridge.js`
+2. Write to `~/.claude/bc-mcp-bridge.js` (overwrite silently — BCQuality is authoritative)
+3. Confirm: "bc-mcp-bridge.js er opdateret på din maskine."
+
+#### 3b. bc-mcp.config.json
+
+If `~/.bc-mcp.config.json` already exists: skip silently.
+
+If it does NOT exist:
+1. Fetch `{BASE}/machine/bc-mcp.config.template.json`
+2. Write it to `~/.bc-mcp.config.json` as-is
+3. Tell the developer:
+   > "⚠️ `~/.bc-mcp.config.json` er oprettet fra CURABIS-template.
+   >  Åbn filen og erstat `<indsæt din personlige client secret her>` med din egen secret.
+   >  Gem filen — BC MCP er klar når du genstarter Claude Code."
+
+### Step 4 — Write project files
+
+#### 4a. CLAUDE.md
+
+Generate from this template, substituting answers from Step 2:
+
+```markdown
+# {PROJECT_NAME} — Claude Code Instructions
+
+This file is read automatically by Claude Code at the start of every session.
+
+## BCQuality
+
+At the start of every session, before doing anything else:
+
+1. Read `.github/.agents/bcquality.agent.md`
+2. Fetch and read ALL knowledge files listed under Source - Layer 2:
+   - https://raw.githubusercontent.com/Curabis/BCQuality/main/custom/knowledge/architecture/pages-must-not-contain-business-logic.md
+   - https://raw.githubusercontent.com/Curabis/BCQuality/main/custom/knowledge/architecture/namespace-must-be-verified-from-source.md
+   - https://raw.githubusercontent.com/Curabis/BCQuality/main/custom/knowledge/architecture/al-identifiers-must-be-english.md
+   - https://raw.githubusercontent.com/Curabis/BCQuality/main/custom/knowledge/architecture/clarify-before-building.md
+   - https://raw.githubusercontent.com/Curabis/BCQuality/main/custom/knowledge/architecture/xliff-translation-workflow.md
+   - https://raw.githubusercontent.com/Curabis/BCQuality/main/custom/knowledge/architecture/new-file-requires-vscode-refresh.md
+   - https://raw.githubusercontent.com/Curabis/BCQuality/main/custom/knowledge/architecture/exposed-objects-must-be-in-a-permission-set.md
+   - https://raw.githubusercontent.com/Curabis/BCQuality/main/custom/knowledge/architecture/shared-project-memory-must-be-in-repo.md
+   - https://raw.githubusercontent.com/Curabis/BCQuality/main/custom/knowledge/architecture/commit-message-must-include-bc-task-id.md
+   - https://raw.githubusercontent.com/Curabis/BCQuality/main/custom/knowledge/architecture/branch-merge-to-main-workflow.md
+   - https://raw.githubusercontent.com/Curabis/BCQuality/main/custom/knowledge/testing/test-setup-must-use-library-codeunit.md
+   - https://raw.githubusercontent.com/Curabis/BCQuality/main/custom/knowledge/testing/test-data-must-be-random-and-complete.md
+   - https://raw.githubusercontent.com/Curabis/BCQuality/main/custom/knowledge/testing/tests-must-adapt-to-existing-code.md
+   - https://raw.githubusercontent.com/Curabis/BCQuality/main/custom/knowledge/testing/test-one-when-per-test.md
+   - https://raw.githubusercontent.com/Curabis/BCQuality/main/custom/knowledge/testing/ui-test-codeunit-naming.md
+   - https://raw.githubusercontent.com/Curabis/BCQuality/main/custom/knowledge/testing/test-feature-scenario-tags.md
+   - https://raw.githubusercontent.com/Curabis/BCQuality/main/custom/knowledge/mcp/api-page-flowfields-must-be-calcfields.md
+   - https://raw.githubusercontent.com/Curabis/BCQuality/main/custom/knowledge/mcp/stored-derived-fields-must-not-be-exposed-directly.md
+   - https://raw.githubusercontent.com/Curabis/BCQuality/main/custom/knowledge/mcp/api-page-key-fields-must-be-editable-on-insert.md
+   - https://raw.githubusercontent.com/Curabis/BCQuality/main/custom/knowledge/mcp/api-page-least-privilege-write-access.md
+   - https://raw.githubusercontent.com/Curabis/BCQuality/main/custom/knowledge/mcp/agent-must-not-write-business-process-status.md
+   - https://raw.githubusercontent.com/Curabis/BCQuality/main/custom/knowledge/mcp/bc-mcp-find-active-task-for-branch.md
+
+These rules are always active.
+
+## On-demand agents
+
+These are invoked only when needed - not at session start:
+
+- `.github/.agents/immanuel.agent.md` - BCQuality rule guardian. Invoke when the user
+  proposes adding a new rule to BCQuality. Runs the Categorical Imperative test and drafts
+  the knowledge file. Only Michael (mid) may approve and push rules to BCQuality.
+
+## AL projects
+
+{AL_PROJECTS_SECTION}
+
+## Shared project memory
+
+At session start, read **all files** in `projectmemory/` — they contain shared
+project observations from all team members and are version-controlled in git.
+
+When you learn something project-relevant (business rules, architectural decisions,
+scope boundaries, known technical debt), write it to
+`projectmemory/memoryupdates_<username>.md` for the active user.
+
+User-specific preferences (tone, workflow habits) stay in the local
+`~/.claude/projects/.../memory/` folder as before.
+
+## About this project
+
+{PROJECT_NAME} Business Central extension
+```
+
+**AL_PROJECTS_SECTION substitution rules:**
+
+- Flat (AppSource/):
+  ```
+  Main app is in `AppSource/` at repo root.
+  ```
+- .apps/\<Name\> only:
+  ```
+  The app is loaded via MCP hooks:
+  - .apps\<Name> — main app
+  ```
+- .apps/\<Name\> + .apps/\<Name\>.Test:
+  ```
+  Both apps are always loaded via MCP hooks:
+  - .apps\<Name> — main app
+  - .apps\<Name>.Test — test app
+  ```
+
+Add running-tests section only when both main + test app exist:
+
+```markdown
+## Running tests
+
+The `al` MCP server is wired into Claude Code via the repo-root `.mcp.json`.
+To run the test suite end to end:
+
+1. `al_auth_login` - authenticate to the BC sandbox (once per session).
+2. `al_downloadsymbols` - fetch dependency symbols.
+3. `al_compile` (or `al_build`) - confirm both apps build clean.
+4. `al_publish` - publish main + test app to the sandbox.
+5. `al_run_tests` - execute the tests; optionally filter to one codeunit.
+
+After creating any new `.al` file, reload the AL extension in VS Code
+(`Ctrl+Shift+P -> AL: Reload Extension`) before trusting diagnostics.
+```
+
+#### 4b. .mcp.json
+
+If `.vscode/find-altool.ps1` exists:
+```json
+{
+  "mcpServers": {
+    "al": {
+      "type": "stdio",
+      "command": "powershell",
+      "args": [
+        "-ExecutionPolicy", "Bypass",
+        "-File", "<ABS_PATH_TO_VSCODE>/find-altool.ps1",
+        "launchmcpserver", "--transport", "stdio"
+      ]
+    },
+    "businesscentral": {
+      "command": "node",
+      "args": ["C:\\Users\\<USERNAME>\\.claude\\bc-mcp-bridge.js"]
+    }
+  }
+}
+```
+
+If `.vscode/find-altool.ps1` does NOT exist:
+```json
+{
+  "mcpServers": {
+    "businesscentral": {
+      "command": "node",
+      "args": ["C:\\Users\\<USERNAME>\\.claude\\bc-mcp-bridge.js"]
+    }
+  }
+}
+```
+
+Substitute `<ABS_PATH_TO_VSCODE>` and `<USERNAME>` from detected values.
+
+If `find-altool.ps1` is missing, note after writing .mcp.json:
+> "ℹ️ AL MCP er ikke konfigureret endnu. Kør `Ctrl+Shift+P → AL: Configure MCP Server`
+>  i VS Code for at generere find-altool.ps1, og kør derefter
+>  'Opdater CURABIS Standard fra BCQuality' — AL MCP tilføjes automatisk."
+
+#### 4c. .github/.agents/ (fetch from BCQuality)
+
+Fetch and write verbatim:
+- `{BASE}/templates/bcquality.agent.md` → `.github/.agents/bcquality.agent.md`
+- `{BASE}/templates/immanuel.agent.md`  → `.github/.agents/immanuel.agent.md`
+
+Create `.github/.agents/` if it does not exist.
+
+#### 4d. cspell.json
+
+Fetch `{BASE}/templates/cspell.json` and write to repo root.
+If a `cspell.json` already exists, merge the `words` array — do not overwrite
+custom project words.
+
+#### 4e. projectmemory/
+
+Create `projectmemory/` if it does not exist.
+Create `projectmemory/memoryupdates_<username>.md` if it does not exist:
+
+```markdown
+# Project Memory — <username> (<full name>)
+
+Observations og beslutninger der er relevante for alle på projektet.
+Læses automatisk af Claude Code ved session-start (via CLAUDE.md).
+
+---
+
+(Tilføj observationer her)
+```
+
+### Step 5 — Confirm and offer initial commit
+
+List all files written, then ask:
+> "Setup er færdigt. Vil du have mig til at lave det første commit? (ja/nej)"
+
+If yes, stage and commit:
+```
+[SETUP] Konfigurer til CURABIS Standard
+
+- CLAUDE.md med BCQuality knowledge-liste
+- .github/.agents/bcquality.agent.md + immanuel.agent.md
+- .mcp.json med BC MMP bridge
+- cspell.json
+- projectmemory/ mappe
+
+Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
+```
+
+---
+
+## MODE B — Update (existing project)
+
+Triggered by: "Opdater CURABIS Standard fra BCQuality"
+
+Updates only the files that come directly from BCQuality.
+Never touches `CLAUDE.md`, `projectmemory/`, or `~/.bc-mcp.config.json`.
+
+### What gets updated
+
+| Fil | Handling |
+|---|---|
+| `~/.claude/bc-mcp-bridge.js` | Fetch fresh from BCQuality, overwrite |
+| `.github/.agents/bcquality.agent.md` | Fetch fresh from BCQuality, overwrite |
+| `.github/.agents/immanuel.agent.md` | Fetch fresh from BCQuality, overwrite |
+| `cspell.json` — words from template | Merge new words, keep project words |
+| `.mcp.json` — `al` entry | Add if `find-altool.ps1` now exists and entry is missing |
+
+### What does NOT get updated
+
+- `CLAUDE.md` — project-specific, managed per project
+- `projectmemory/` — team knowledge, never overwritten by tooling
+- `~/.bc-mcp.config.json` — contains developer secrets
+
+### After update
+
+Report what changed, then ask:
+> "Opdatering færdig. Vil du have mig til at committe ændringerne? (ja/nej)"
+
+If yes, commit:
+```
+[SETUP] Opdater CURABIS Standard fra BCQuality
+
+Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
+```
+
+---
+
+## Invocation note
+
+This agent is fetched on demand from BCQuality. Both commands work in any
+project — including one not yet configured — because Claude reads the URL
+from `~/.claude/CLAUDE.md` (global instructions, present on all CURABIS machines).