al-design

Produces feature-level architecture documents for AL and Business Central development.

4|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/FBakkensen/bc-agentic-dev-tools-marketplace --skill al-design-fbakkensen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: al-design
Source: https://github.com/FBakkensen/bc-agentic-dev-tools-marketplace/tree/main/plugins/al-agentic-dev/skills/al-design
Command: npx skills add https://github.com/FBakkensen/bc-agentic-dev-tools-marketplace --skill al-design-fbakkensen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a sharpened feature idea into a concrete AL/Business Central architecture is error-prone: modules get invented without justification, seams lack real adapters, and BaseApp facts go unverified. This Skill settles the feature architecture and writes a verified architecture.md that downstream scoping and implementation steps can consume directly. ## Core Features & Use Cases - Architecture authoring: Defines slices, module maps, BC patterns per module, and the R → P → W (read / pure / write) boundary, then writes architecture.md into the feature's spec folder. - Design disciplines: Enforces the deletion test for modules, the two-adapter rule for seams, AL realisation per slice with new/extends markers, and AppSource sanity checks for BaseApp modification and shipped-field renames. - Parallel design-twice: For non-trivial calls, runs three delegated design passes with divergent constraints and compares them along depth, locality, and seam placement. - Use Case: After running /al-event-model on a user-facing feature, invoke this Skill to produce a verified architecture.md naming modules, patterns, and testability constraints, ready for /al-scope to decompose into tasks. ## Quick Start Ask the agent to design the AL feature architecture from the current event model and write architecture.md into the spec folder.

Frequently Asked Questions about al-design

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design a Business Central feature architecture?

Run this Skill after event modeling or ADR sharpening; it defines slices, a module map, a BC pattern per module, and the R → P → W boundary, then writes architecture.md into the feature's spec folder for downstream scoping.

What is the R → P → W boundary in AL architecture?

R is reads and inputs, P is a pure procedure with no database or side effects, and W is effects like Insert, Modify, Delete, and events. The split pulls decision logic out of read/write context so unit testing works without database state.

When should I run al-design versus al-event-model?

Run al-event-model first for user or API-facing features to settle user-side slots, then al-design for the AL architecture. For backend-only features, run al-grill-adr first and al-design can create the branch and spec folder itself.

Does this Skill verify BaseApp object names before writing?

Yes. Every BC-specific name in architecture.md must meet an evidence bar: names are verified against workspace evidence via symbol search or grep, and BaseApp behaviour or pattern fitness questions route through the al-research skill.

What are the limitations of the two-adapter rule for seams?

A seam without two adapters is rejected as hypothetical; production plus test adapters count, as do two real production variants. An interface created only for testability with no fake actually written does not qualify.