ALDC — Claude Code Instructions

@import ./docs/framework/ALDC-Core-Spec-v1.2.md

Overview

AL (Application Language) workspace for Microsoft Dynamics 365 Business Central. Architecture: ALDC Core v1.2 — 13 agents (5 core + 3 on-demand + 4 subagents + 1 extension) + 16 skills + 11 workflows + 9 instructions.

Core Principles

• Extension-only development — Never modify base application objects. Use tableextensions, pageextensions, event subscribers.
• Human-in-the-Loop (HITL) — All critical decisions require user confirmation before proceeding.
• TDD / spec-driven — Features follow: architecture (MEDIUM/HIGH) -> al-spec-agent via al-spec.create -> human approval -> test-plan -> implementation -> review.
• Least privilege — Generate only the minimum permissions required. Use XLIFF for all user-facing strings.

Agent Routing

Quick Routing

New feature (MEDIUM/HIGH)? -> al-architect -> /al-spec.create -> al-conductor
New feature (LOW)?         -> /al-spec.create -> al-developer
Bug fix / debugging?       -> al-developer
Architecture review?       -> al-architect
Full TDD cycle?            -> al-conductor
Project estimation?        -> al-presales

Workflows

11 workflows (6 core + 5 BC Agents pack). The 6 core, invoked via /workflow-name:

Skills

16 composable knowledge modules (8 required + 4 recommended + 3 BC Agents + 1 utility) loaded on-demand by agents (not invoked directly):

Skills Evidencing

Agents MUST declare which skills they loaded and which patterns they applied:

• al-architect -> > **Skills applied**: skill-api, skill-events at top of architecture.md
• al-developer -> > **Skills loaded**: skill-debug (root cause analysis) at start of response
• al-conductor -> Skills Applied in This Phase table in phase-complete.md

Auto-Applied Instructions

Active automatically based on file type (no invocation needed):

Always on *.al: al-guidelines, al-code-style, al-naming-conventions, al-performance Context-activated: al-error-handling (errors), al-events (events), al-testing (test files)

See instructions/ directory for full content.

Plans

Requirement sets live in .github/plans/, one subdirectory per requirement:

.github/plans/
  memory.md                          # Global memory (cross-session decisions)
  {req_name}/
    {req_name}.spec.md               # Functional-technical specification
    {req_name}.architecture.md       # Architecture decisions
    {req_name}.test-plan.md          # Test plan with acceptance criteria
    {req_name}-phase-<N>-complete.md # Phase completion reports
    {req_name}-complete.md           # Final completion report

Workflow with Plans

MEDIUM / HIGH complexity:

1. al-architect designs solution, creates {req_name}.architecture.md
2. /al-spec.create reads architecture, generates {req_name}.spec.md
3. al-conductor reads spec + architecture, orchestrates TDD
4. /al-pr-prepare prepares PR referencing the plan

LOW complexity:

1. /al-spec.create generates spec directly from codebase
2. al-developer implements using spec as blueprint

Complexity-Based Routing

Present the assessment and wait for user confirmation before proceeding.

BC Agents Pack (Extension)

For agent development with AI Development Toolkit. Includes al-agent-builder agent and skill-agent-task-patterns (8 SDK integration patterns). Workflows: /al-agent.create, /al-agent.task, /al-agent.instructions, /al-agent.test.

Build & Test

# Download symbols (requires app.json configured)
al-language: Download Symbols

# Build the extension
al-language: Package

# Publish to sandbox
al-language: Publish without Debugging

# Run tests
al-language: Run Tests

No npm/yarn build steps. AL compilation is handled by the AL Language VS Code extension.

Project Structure

instructions/          # Auto-applied instruction files (9)
agents/                # Agent definitions (5 core + 3 on-demand + 3 subagents + 1 extension)
skills/                # Composable knowledge modules (16 skill directories)
prompts/               # Workflow definitions (11 prompt files)
docs/framework/        # Normative spec (ALDC-Core-Spec-v1.2.md)
docs/templates/        # Immutable templates
.github/plans/         # Requirement sets & memory
src/                   # AL source code
app.json               # Extension manifest

Reference

• ALDC Core Spec v1.2 — Normative specification
• AL Language Reference
• BC Development Docs

Framework: ALDC Core v1.2 | Primitives: 13 agents + 16 skills + 11 workflows + 9 instructions

For direct Developer increments, use AL Developer Reviewer in an independent context before human approval. Dredd remains the advisory auditor. Both load skill-al-review-pipeline; Conductor phases keep their own review subagent.