al-spec-create

al-spec-create is a command for Claude Code from javiarmesto/ALDC-AL-Development-Collection. It costs 56 tokens per session (3,137 once invoked), scanned A, original, MIT.

A command for writing a detailed technical specification for Microsoft Business Central features. A technical specification is an implementation blueprint describing objects, fields, procedures, events, and code patterns.

In plain words
What is it for?
Use it to create specification files under the required planning directory while leaving production AL objects unchanged.
Why use it?
It turns a requirement and existing architecture decisions into concrete instructions for implementation.

Command for Claude Code

Written for Claude Code: allowed-tools in frontmatter. Also seen: mentions subagents.

Part of the aldc plugin — 10 commands, 1 hook shipped together

Good fit Use it to create specification files under the required planning directory while leaving production AL objects unchanged.

Compare 6 commands from other repositories ↓
Install with agentmods
npx agentmods add commands/javiarmesto/aldc-al-development-collection/al-spec-create
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Clone the repo
git clone --depth 1 https://github.com/javiarmesto/ALDC-AL-Development-Collection

Made for: Claude Code.

Or install aldc, the plugin that ships this one along with the rest of its 10 commands, 1 hook.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for al-spec-create

README.md
[![agentmods](https://agentmods.dev/badge/commands/javiarmesto/aldc-al-development-collection/al-spec-create/github.svg)](https://agentmods.dev/commands/javiarmesto/aldc-al-development-collection/al-spec-create)
Your own site
<a href="https://agentmods.dev/commands/javiarmesto/aldc-al-development-collection/al-spec-create"><img src="https://agentmods.dev/badge/commands/javiarmesto/aldc-al-development-collection/al-spec-create/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for al-spec-create

Your own site · 80×15
<a href="https://agentmods.dev/commands/javiarmesto/aldc-al-development-collection/al-spec-create"><img src="https://agentmods.dev/badge/commands/javiarmesto/aldc-al-development-collection/al-spec-create.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 56 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 3,137 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00056 $0.03137
Opus 5 $0.00028 $0.01569
Sonnet 5 $0.00011 $0.00627
Haiku 4.5 $0.00006 $0.00314

Measured 10d ago against content hash 6165de31ddb4, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

al-spec-create scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 10d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

claude-plugin/commands/al-spec-create.md · 409 lines

How it starts

The opening of the file, as written. The whole thing — 409 lines — stays where its author put it; the contents beside it link to each section on GitHub.

AL Technical Specification Workflow

Your goal is to generate a detailed implementable technical specification for ${input:req_name} (complexity: ${input:Complexity}).

This is NOT the architecture phase. This phase produces the implementable blueprint: exact object IDs, field types, procedure signatures, event patterns, and AL code snippets.

Guardrails

  • Never create or modify real AL objects during this phase
  • Never output to /specs/ — always output to .github/plans/{req_name}/
  • If {req_name}.architecture.md exists, read it first — the spec must implement what the architect designed
  • If spec already exists, confirm with user before overwriting
  • Complexity drives depth: LOW = lighter spec, MEDIUM/HIGH = full spec with all sections

Step 1 — Read Context

1.1 Read global memory

Read .github/plans/memory.md

Extract: project app ID range, naming conventions (prefix), existing table IDs in use, current extension patterns.

1.2 Read architecture document (if exists)

Read .github/plans/${input:req_name}/${input:req_name}.architecture.md

If it exists: the spec MUST align with the architectural decisions (data flows, chosen patterns, integration points). If it does not exist: proceed — spec will define structure from scratch (typical for LOW complexity).

1.3 Analyze codebase

Search for:

  • Existing objects with similar patterns (Grep/Glob; al-symbols-mcp al_search_objects for symbol-level)
  • Naming conventions in /src
  • Available object ID ranges in app.json
  • Existing event publishers relevant to this feature
  • Existing API pages or codeunits if integration is involved

Verify every base-app event you subscribe to against symbols — this is the spec's job, not the planner's. For each event the feature hooks into, confirm it exists in the current BC version via al-symbols-mcp (al_search_object_members / al_get_object_definition; download symbols first if absent). Record the verified publisher object + exact event name in §5. If you cannot confirm an event exists, it does not enter the spec as fact — move it to §12 Open Questions. (A wrong or nonexistent event name passed downstream silently becomes a blind search burst in planning and a defect the reviewer must catch. Verify it once, here, at the cheapest point.)

Read the full file on GitHub · 409 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 10d ago First seen · 409 lines · 56 tokens per session scan A 6165de31ddb4

Subscribe to this mod's changes

al-spec-create is a command published in the GitHub repository javiarmesto/ALDC-AL-Development-Collection (103 stars, last pushed 3d ago), licensed MIT. It adds 56 tokens to every session and 3,137 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.