From 28b0e7433ee3e66ad226f5f528309aacbba67a7a Mon Sep 17 00:00:00 2001 From: Hugh Hackman Date: Fri, 20 Mar 2026 02:04:35 +0000 Subject: [PATCH 1/3] fix: restore CI workflow with markdownlint config The previous CI workflow was removed, leaving the agents repo with no CI. This restores markdownlint-based CI with a config that disables rules incompatible with agent prompt files (bare URLs, inline HTML, emphasis headings). Uses ARC runners and actions/checkout@v6. Co-Authored-By: Claude Opus 4.6 --- .github/workflows/ci.yaml | 17 +++++++++++++++++ .markdownlint.yaml | 6 ++++++ 2 files changed, 23 insertions(+) create mode 100644 .github/workflows/ci.yaml create mode 100644 .markdownlint.yaml diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml new file mode 100644 index 0000000..e12970b --- /dev/null +++ b/.github/workflows/ci.yaml @@ -0,0 +1,17 @@ +name: CI + +on: + push: + branches: [main] + pull_request: + branches: [main] + +jobs: + lint: + runs-on: runners-privilegedescalation + steps: + - uses: actions/checkout@v6 + - name: Lint Markdown + uses: DavidAnson/markdownlint-cli2-action@v19 + with: + globs: "**/*.md" diff --git a/.markdownlint.yaml b/.markdownlint.yaml new file mode 100644 index 0000000..2b36cc9 --- /dev/null +++ b/.markdownlint.yaml @@ -0,0 +1,6 @@ +# Markdownlint configuration for the agents repo. +# Agent prompt files intentionally use bare URLs (curl commands), +# inline HTML (template variables), and emphasis-as-headings. +MD033: false # no-inline-html +MD034: false # no-bare-urls +MD036: false # no-emphasis-as-heading -- 2.52.0 From 1e3d4d6e884c95de5e2e27b6413a6ab3b6b5e180 Mon Sep 17 00:00:00 2001 From: Samuel Stinkpost Date: Fri, 20 Mar 2026 23:06:38 +0000 Subject: [PATCH 2/3] fix: disable strict markdownlint rules for agent prompt files Agent prompts, operational docs (OPERATIONS.md, POLICIES.md, TOOLS.md), and marketing SOUL files intentionally use long lines, compact heading style, and fences inside blockquotes. Disabling MD013, MD022, MD031, and MD040 prevents false-positive CI failures on these files. Co-Authored-By: Paperclip --- .markdownlint.yaml | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/.markdownlint.yaml b/.markdownlint.yaml index 2b36cc9..1d434da 100644 --- a/.markdownlint.yaml +++ b/.markdownlint.yaml @@ -1,6 +1,10 @@ # Markdownlint configuration for the agents repo. # Agent prompt files intentionally use bare URLs (curl commands), -# inline HTML (template variables), and emphasis-as-headings. +# inline HTML (template variables), emphasis-as-headings, and long lines. +MD013: false # no-line-length — prompts and ops docs use long lines intentionally +MD022: false # no-blanks-around-headings — ops docs use compact heading style +MD031: false # no-blanks-around-fences — ops docs use fences inside blockquotes MD033: false # no-inline-html MD034: false # no-bare-urls MD036: false # no-emphasis-as-heading +MD040: false # no-fenced-code-language — shell snippets often omit language tag -- 2.52.0 From 5de71389533c59ad1f4fe93b542bb41f9b125b06 Mon Sep 17 00:00:00 2001 From: Samuel Stinkpost Date: Fri, 20 Mar 2026 23:09:30 +0000 Subject: [PATCH 3/3] fix: disable additional markdownlint rules for agent prompt files MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit AGENTS.md files are prose-first (no heading required — MD041), mix list styles (MD004), and use tight lists in compact docs (MD032). These are structural choices for agent prompts, not markdown errors. Co-Authored-By: Paperclip --- .markdownlint.yaml | 21 ++++++++++++--------- 1 file changed, 12 insertions(+), 9 deletions(-) diff --git a/.markdownlint.yaml b/.markdownlint.yaml index 1d434da..fc696ae 100644 --- a/.markdownlint.yaml +++ b/.markdownlint.yaml @@ -1,10 +1,13 @@ # Markdownlint configuration for the agents repo. -# Agent prompt files intentionally use bare URLs (curl commands), -# inline HTML (template variables), emphasis-as-headings, and long lines. -MD013: false # no-line-length — prompts and ops docs use long lines intentionally -MD022: false # no-blanks-around-headings — ops docs use compact heading style -MD031: false # no-blanks-around-fences — ops docs use fences inside blockquotes -MD033: false # no-inline-html -MD034: false # no-bare-urls -MD036: false # no-emphasis-as-heading -MD040: false # no-fenced-code-language — shell snippets often omit language tag +# Agent prompt files are structured prose, not standard markdown docs. +# Many style rules conflict with how agent prompts are intentionally written. +MD004: false # ul-style — ops docs mix asterisk and dash list styles +MD013: false # line-length — prompts and ops docs use long lines intentionally +MD022: false # blanks-around-headings — ops docs use compact heading style +MD031: false # blanks-around-fences — ops docs use fences inside blockquotes +MD032: false # blanks-around-lists — tight lists used in tables and compact docs +MD033: false # inline-html — agent prompts use template variables like +MD034: false # bare-urls — agent prompts contain raw curl command URLs +MD036: false # emphasis-as-heading — agent prompts use emphasis for structure +MD040: false # fenced-code-language — shell snippets often omit language tag +MD041: false # first-line-heading — AGENTS.md files are prose-first by design -- 2.52.0