Motivation

• Introduce automated linting and validation for governance Markdown to enforce consistent documentation quality and protect long-form policy artifacts from accidental reflow.
• Provide a repeatable local and CI check that verifies required ignore entries and preserves intentionally dense governance documents from strict line-reflow rules.
• Surface script syntax and shellstyle issues early in CI to avoid noisy PRs and broken documentation checks.

Description

• Add a GitHub Actions workflow governance-docs-lint.yml that runs syntax checks, shellcheck, and the make governance-docs-check target on relevant paths.
• Add a minimal markdownlint configuration file .markdownlint.json and an ignore file .markdownlintignore that exempts specified long-form governance files.
• Provide Makefile targets governance-docs-lint, governance-docs-test, and governance-docs-check to standardize local invocation of the checks.
• Add governance documentation and tooling: docs/README.md, docs/governance/README.md, docs/governance/LINTING_NOTES.md, the large AGI_ASI_GSIFI_Blueprint_2026_2030.md blueprint, the lint helper scripts/lint_governance_docs.sh, and the test harness tests/test_lint_governance_docs.sh.

Testing

• The CI workflow will run syntax validation using bash -n for scripts/lint_governance_docs.sh and tests/test_lint_governance_docs.sh, shellcheck on scripts and tests, and make governance-docs-check as part of its job.
• The included test harness tests/test_lint_governance_docs.sh was executed as the automated validation for the lint helper and completed successfully.
• Local validation commands exercised were bash scripts/lint_governance_docs.sh (strict and all modes) and make governance-docs-check, which are covered by the new CI job configuration.

Codex Task