[Bug]: markdownlint CI job lints 0 files — glob quoting makes lint.yml a no-op
Nobody has claimed this yet.
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 72/100
- Issue type
- Bug
- Clarity
- Mostly clear
- Activity status
- Active
- Tech stack
- github-actions
- Domain
- ci-cd, documentation
Research direction
Inspect .github/workflows/lint.yml and reproduce the markdownlint-cli2 command from the issue, comparing the quoted and unquoted glob behavior. Confirm that the intended tracked Markdown scope is matched and that CI reports existing lint violations rather than passing with zero files; the cleanup plan for those violations needs maintainer direction.
Written by the indexing model from the issue text.
Description
Bug Description
The markdownlint job in .github/workflows/lint.yml lints zero files on every run, so it reports success unconditionally. Markdown formatting has not been enforced in CI since 2026-02-10.
Steps to Reproduce
- Open Lint workflow run 34513299255 for commit c173bf19a6654e3b05386ec3599349a55282b897 and inspect the markdownlint job. It reports Linting: 0 files and Summary: 0 issues in 0 files.
- Reproduce locally with: npx --yes markdownlint-cli2@0.23.2 "'/*.md'" "!extensions//*.md".
- Remove the single quotes; the command then matches files and reports the existing violations.
Expected Behavior
The job should lint the tracked Markdown files it is intended to cover (/*.md except extensions//*.md) and fail when they contain lint errors.
Actual Behavior
The job matches no files and always passes.
Specify CLI Version
Not applicable — CI workflow defect at main @ c173bf19a6654e3b05386ec3599349a55282b897
AI Agent
Alquimia AI
Operating System
Windows 11 host; behavior confirmed in the live ubuntu-latest runner log
Python Version
Not applicable — workflow defect
Error Logs
markdownlint-cli2 v0.23.2 (markdownlint v0.41.1)
Finding: '**/*.md' !extensions/**/*.md
Linting: 0 files
Summary: 0 issues in 0 files
Additional Context
Root cause: the YAML block scalar in .github/workflows/lint.yml preserves the single quotes around **/*.md, so markdownlint-cli2 receives a quoted glob that matches nothing. The issue was introduced by commit f14a47e. Running the intended scope against tracked files reports 277 issues across 32 files. Removing the quotes would make CI meaningful but red, so maintainer direction is needed for the intended scope and cleanup plan.
AI Assistance Disclosure: AI assistance was used for repository inspection, reproduction, evidence gathering, and drafting this report. The finding was checked against the frozen commit, live CI log, local reproduction output, and all-state issue/PR searches; no code changes were made for this report. Related issue #1030 does not report this exact defect.
- Dominant language
- Python
- Stars
- 138k
- Forks
- 12.4k
- Avg merge
- 3d 6h
- Merged PRs (30d)
- 145
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from github/spec-kit
-
triage-can-wait
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
-
enhancement needs-triage triage-can-wait
Difficulty 2/5 1-3 hours Newbie friendliness 62/100
-
bundle-submission needs-info triage-can-wait validation-failed
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
-
author-awaiting enhancement needs-triage preset-submission triage-can-wait validation-failed
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
-
author-awaiting enhancement extension-submission needs-triage triage-can-wait validation-failed
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
Similar issues
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 90/100
learningequality/ricecooker#747 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
BSData/horus-heresy-3rd-edition#3171 ·
-
enhancement
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
run-llama/llama_index#23199 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
KhronosGroup/glTF-Blender-IO#2769 ·