bcquality/custom/setup/curabis-standard.agent.md

kind	id	version	title	description	inputs	outputs	domain	keywords
action-skill	curabis-standard-setup	1	CURABIS Standard — Project Setup	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.	repo-root	CLAUDE.md .mcp.json .github/.agents/* cspell.json projectmemory/	setup	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
francis.agent.md	{BASE}/templates/francis.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:

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:

# {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/francis.agent.md` - BCQuality rule proposer. Invoke at session end
  or when a pattern suggests a rule is missing. Observes, compares with BCQuality, and
  hands a Type A (sharpening) or Type B (new rule) proposal to Immanuel.
- `.github/.agents/immanuel.agent.md` - BCQuality rule guardian. Invoke after Francis
  has a proposal ready. Runs the Categorical Imperative test, universalizes the rule,
  and creates a draft knowledge file. Michael (mid) merges the BCQuality PR to approve.
## 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:

## 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:

{
  "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:

{
  "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
• {BASE}/templates/francis.agent.md → .github/.agents/francis.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:

# 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 + francis.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
.github/.agents/francis.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).