development.md

Development Guide

Goal

Provide a single local quality gate that mirrors CI checks before opening a pull request.

Local prerequisites

• bash
• shellcheck
• actionlint
• node + npx (for markdown lint)

Commands

Run from repository root:

make help

Full quality gate:

make check

Individual checks:

make syntax-shell
make lint-shell
make lint-workflows
make lint-docs
make smoke

CI parity

make check maps directly to the CI workflow quality gates:

• shell lint
• shell syntax
• workflow lint
• docs lint
• bootstrap smoke