bc-alm-template

Implements Business Central AL objects to a spec, enforcing coding standards, version bumping app.json, and generating test codeunits. Use when: implement an AL feature, write AL code, build from a spec, create tableextension/codeunit/page, add a field, bump app.json version, generate test codeunit, code a BC change.

Authors the Business Central spec folder (index, brief, plan, acceptance-criteria, change-log) under its module/functional area so a developer can implement without guessing. Use when: create a spec, write the spec folder, draft brief and plan, prepare a feature for development, spec out an AL change, technical specification for BC.

Turns a raw Business Central request, ADO ticket, or meeting note into a crisp user story with testable acceptance criteria, ready to be specced. Use when: plan a BC feature, write a user story, break down a ticket, clarify requirements, draft acceptance criteria, what should this feature do, turn a request into a story.

Breaks a parent Business Central Feature/Epic into child user stories (with story points) plus one estimate-carrying task per story, in Azure DevOps or GitHub. Use when: break a feature into user stories, plan a feature in ADO, decompose an epic, create child stories with story points and hours, feature breakdown, split a feature into estimable work, create sub-issues for an epic.

Generates customer-facing functional documentation and a changelog entry for a shipped Business Central feature, checking spec-vs-implementation divergence first. Use when: write functional docs, document a feature for the customer, update the changelog, PROD documentation gate, end-user docs for BC, how-to documentation.

Guides an adopter through initializing this BC ALM template for their own project — interviews them for prefix, object ID range, publisher, repo, work-item system, branching and commit conventions, runs scripts/Initialize-Template.ps1 to apply everything, then regenerates project-specific copilot-instructions grounded in the real app. Use when: initialize the template, set up this repo for my project, customize the template, run guided setup, configure prefix and object range, onboard a new BC repo, replace ABC placeholders, first-time setup, generate project-specific copilot-instructions, my copilot-instructions still describe the template.

Runs a pre-PR self-review of a Business Central feature branch against the AL quality gate before a pull request is opened. Use when: self review before PR, check AL quality, review my changes, pre-PR check, did I miss anything, validate before pull request, lint my AL feature.

Composes a high-quality Business Central pull request — description from spec and commits, AL quality checklist, and Azure DevOps work-item link. Use when: open a PR, write a pull request description, prepare the PR, fill the PR template, link the ADO work item, ready for review.

Composes a Business Central release branch from selected merged features and guides deployment to TEST and PROD. Use when: compose a release branch, build a release wave, deploy to TEST, deploy to PROD, cut a release, select features for a wave, BC Admin Center deployment, hotfix deployment.

Author and maintain CI/CD for a Business Central AL app — GitHub Actions workflows or AL-Go for GitHub. Use when: set up CI/CD, create a GitHub Actions workflow, configure AL-Go for GitHub, add a build/test/publish pipeline, fix a failing workflow, add a deployment environment, automate AL compile and test.

Intake, triage, prioritize, and groom Business Central work items in Azure DevOps or GitHub Issues so the backlog is clean and the next item is ready to plan. Use when: triage a ticket, groom the backlog, prioritize work, label or categorize an issue, check for duplicates, intake a new request, manage work items, prepare the backlog for planning.

Formats git commit messages for Business Central work using conventional commits with Azure DevOps work-item linking. Use when: write a commit message, what commit type, how to format a commit, conventional commit, link a commit to an ADO work item, commit convention.