[Bug]: markdownlint CI job lints 0 files — glob quoting makes lint.yml a no-op

Open Beginner friendly
#4,526 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
74/100
Issue type
Bug
Clarity
Mostly clear
Activity status
Active
Tech stack
github-actions, markdown
Domain
ci-cd, tooling

Research direction

Start with .github/workflows/lint.yml and the markdownlint job, then reproduce the quoted-glob command from the issue and inspect workflow run 34513299255. Confirm that the intended tracked Markdown scope is matched and that existing violations cause the job to fail; maintainer guidance is needed for the resulting 277 issues across 32 files.

Written by the indexing model from the issue text.

Description

triage-nice-to-have
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
  1. 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.
  2. Reproduce locally with: npx --yes markdownlint-cli2@0.23.2 "'/*.md'" "!extensions//*.md".
  3. 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

DeepSeek Harness

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.

Specific model and mode: OpenAI Codex (GPT-5), autonomous mode.

Dominant language
Python
Stars
138k
Forks
12.4k
Avg merge
3d 6h
Merged PRs (30d)
145

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from github/spec-kit

All issues in github/spec-kit

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.