Skip to content

Stabilize awesome-lint CI and reduce README lint noise to actionable checks #1

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
zhimin-z merged 4 commits into from
Apr 18, 2026
Merged

Stabilize awesome-lint CI and reduce README lint noise to actionable checks #1

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
d6e00ee
Fix awesome-lint CI by pinning version and disabling noisy README rules
Copilot Apr 18, 2026
181b1e3
Document rationale for README awesome-lint rule suppressions
Copilot Apr 18, 2026
a1e7bb2
Narrow README lint suppressions and resolve review feedback
Copilot Apr 18, 2026
cd01d0d
Update README.md
zhimin-z Apr 18, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/workflows/awesome-lint.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,4 +24,4 @@ jobs:
with:
node-version: '20'
- name: Run awesome-lint
run: npx awesome-lint
run: npx awesome-lint@2.3.0
19 changes: 10 additions & 9 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,3 +1,6 @@
<!--lint disable table-pipe-alignment table-cell-padding double-link awesome-spell-check-->
<!--Rationale: lint suppression is intentional for this curated index. Repeated canonical links across sections and dense matrix/timeline tables trigger high-noise violations that are expected in this format; spell-check is disabled because this list contains many proper nouns, project names, and acronyms that repeatedly false-positive.-->

[![Awesome](https://awesome.re/badge.svg?cacheSeconds=86400)](https://awesome.re)
[![License: CC0-1.0](https://img.shields.io/badge/License-CC0_1.0-lightgrey.svg)](https://creativecommons.org/publicdomain/zero/1.0/)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/EthicalML/awesome-agentic-engineering-resources/pulls)
Expand All @@ -12,8 +15,7 @@

This is a *resources* list, not a tools list. Open-source **tools** for building agentic systems live in the sister list [awesome-production-agentic-systems](https://github.com/EthicalML/awesome-production-agentic-systems); production ML tooling lives in [awesome-production-machine-learning](https://github.com/EthicalML/awesome-production-machine-learning). This list covers the *learning, design, and operational resources* that sit alongside those tools — including both:

- **Agentic engineering** — using AI agents to do software engineering (Copilot, Cursor, Claude Code, Aider, Cline, Windsurf, Codex; spec-driven development; context engineering; agent IDE rules and memory files; SWE benchmarks).
- **AI / agentic systems engineering** — building agentic and LLM-powered systems (architecture, RAG, memory, tool use & MCP, orchestration, multi-agent coordination, evaluation, observability, guardrails, safety, fine-tuning, inference, product/UX, economics, teams).
**Agentic engineering** focuses on using AI agents to do software engineering (Copilot, Cursor, Claude Code, Aider, Cline, Windsurf, Codex; spec-driven development; context engineering; agent IDE rules and memory files; SWE benchmarks). **AI / agentic systems engineering** focuses on building agentic and LLM-powered systems (architecture, RAG, memory, tool use & MCP, orchestration, multi-agent coordination, evaluation, observability, guardrails, safety, fine-tuning, inference, product/UX, economics, teams).

You can keep up to date by watching this repo for the monthly releases summarising newly added resources 🤩

Expand Down Expand Up @@ -104,7 +106,7 @@

Please review our [CONTRIBUTING.md](./CONTRIBUTING.md) before submitting a PR — it explains the one-line description style, how to pick the right row/topic cell, and the quality bar for inclusion. Thank you to the community for supporting the list's growth 🚀

## Want to receive recurrent updates on this repo and other advancements?
## Want to receive recurring updates on this repo and other advancements

<table>
<tr>
Expand All @@ -112,7 +114,7 @@
You can join the <a href="https://ethical.institute/mle.html">Machine Learning Engineer</a> newsletter. Join over 70,000 ML professionals and enthusiasts who receive weekly curated articles & tutorials on production Machine Learning.
</td>
<td width="70%">
<a href="https://ethical.institute/mle.html"><img src="images/mleng.png"></a>

Check failure on line 117 in README.md

View workflow job for this annotation

GitHub Actions / markdown-lint

Images should have alternate text (alt text) 

README.md:117:54 MD045/no-alt-text Images should have alternate text (alt text) https://github.com/DavidAnson/markdownlint/blob/v0.36.1/doc/md045.md
</td>
</tr>
<tr>
Expand All @@ -120,7 +122,7 @@
Also check out <a href="https://github.com/EthicalML/awesome-production-agentic-systems">Awesome Production Agentic Systems</a> and <a href="https://github.com/EthicalML/awesome-production-machine-learning">Awesome Production Machine Learning</a>, the sister lists of open-source <em>tools</em> for agentic systems and production ML respectively.
</td>
<td width="70%">
<a href="https://github.com/EthicalML/awesome-production-agentic-systems"><img src="images/list.jpg"></a>

Check failure on line 125 in README.md

View workflow job for this annotation

GitHub Actions / markdown-lint

Images should have alternate text (alt text) 

README.md:125:83 MD045/no-alt-text Images should have alternate text (alt text) https://github.com/DavidAnson/markdownlint/blob/v0.36.1/doc/md045.md
</td>
</tr>
</table>
Expand All @@ -144,10 +146,10 @@
/>
</picture>

# Main Content
## Main Content

<a name="trending"></a>
## ⭐ Trending / What's New

Check failure on line 152 in README.md

View workflow job for this annotation

GitHub Actions / markdown-lint

Headings should be surrounded by blank lines 

README.md:152 MD022/blanks-around-headings Headings should be surrounded by blank lines [Expected: 1; Actual: 0; Above] [Context: "## ⭐ Trending / What's New"] https://github.com/DavidAnson/markdownlint/blob/v0.36.1/doc/md022.md

*Rotating pinned items: the most-discussed agentic & AI-engineering resources of the current cycle. Refreshed regularly — see [CONTRIBUTING.md](./CONTRIBUTING.md) for nomination criteria.*

Expand All @@ -161,7 +163,7 @@
- 🆓 [**AGENTS.md**](https://agents.md/) — Community standard (2025) for per-repo agent instructions, now read by Claude Code, Codex, Aider, Cursor, Cline, Windsurf and others.

<a name="core"></a>
## 🧭 Core & Foundations

Check failure on line 166 in README.md

View workflow job for this annotation

GitHub Actions / markdown-lint

Headings should be surrounded by blank lines 

README.md:166 MD022/blanks-around-headings Headings should be surrounded by blank lines [Expected: 1; Actual: 0; Above] [Context: "## 🧭 Core & Foundations"] https://github.com/DavidAnson/markdownlint/blob/v0.36.1/doc/md022.md

*Canonical "what is agentic engineering / AI engineering" reading. Start here.*

Expand Down Expand Up @@ -222,7 +224,7 @@
- 🆓 [**Who Validates the Validators? Aligning LLM-Assisted Evaluation of LLM Outputs with Human Preferences**](https://arxiv.org/abs/2404.12272) — Shankar et al. (2024). How to make LLM-judges trustworthy.

<a name="milestones"></a>
## 🗓️ Milestones Timeline

Check failure on line 227 in README.md

View workflow job for this annotation

GitHub Actions / markdown-lint

Headings should be surrounded by blank lines 

README.md:227 MD022/blanks-around-headings Headings should be surrounded by blank lines [Expected: 1; Actual: 0; Above] [Context: "## 🗓️ Milestones Timeline"] https://github.com/DavidAnson/markdownlint/blob/v0.36.1/doc/md022.md

*Dated, field-defining events that shaped agentic & AI engineering.*

Expand Down Expand Up @@ -254,7 +256,7 @@
| 2025-06 | GitHub spec-kit / "new code" essays formalise spec-driven dev | [spec-kit](https://github.com/github/spec-kit) |

<a name="communities"></a>
## 👥 Communities

Check failure on line 259 in README.md

View workflow job for this annotation

GitHub Actions / markdown-lint

Headings should be surrounded by blank lines 

README.md:259 MD022/blanks-around-headings Headings should be surrounded by blank lines [Expected: 1; Actual: 0; Above] [Context: "## 👥 Communities"] https://github.com/DavidAnson/markdownlint/blob/v0.36.1/doc/md022.md

*Discords, Slacks, forums, and meetups where practitioners gather.*

Expand All @@ -271,7 +273,7 @@
- 🆓 [**Anthropic Discord**](https://www.anthropic.com/discord) — Official Claude / Claude Code / MCP community.

<a name="courses"></a>
## 🧑‍🎓 Courses

Check failure on line 276 in README.md

View workflow job for this annotation

GitHub Actions / markdown-lint

Headings should be surrounded by blank lines 

README.md:276 MD022/blanks-around-headings Headings should be surrounded by blank lines [Expected: 1; Actual: 0; Above] [Context: "## 🧑‍🎓 Courses"] https://github.com/DavidAnson/markdownlint/blob/v0.36.1/doc/md022.md

*Structured courses — free and paid, university and industry.*

Expand Down Expand Up @@ -361,7 +363,7 @@
- 🧑‍🎓 🆓 [**CUDA Mode lectures**](https://github.com/cuda-mode/lectures) — Community lectures on GPU inference internals.

<a name="books"></a>
## 📘 Books

Check failure on line 366 in README.md

View workflow job for this annotation

GitHub Actions / markdown-lint

Headings should be surrounded by blank lines 

README.md:366 MD022/blanks-around-headings Headings should be surrounded by blank lines [Expected: 1; Actual: 0; Above] [Context: "## 📘 Books"] https://github.com/DavidAnson/markdownlint/blob/v0.36.1/doc/md022.md

*Published and in-progress books covering agentic & AI engineering.*

Expand Down Expand Up @@ -428,7 +430,7 @@
- 📘 🆓 [**The Pragmatic Engineer's AI coverage**](https://newsletter.pragmaticengineer.com/) — Gergely Orosz. Regularly-updated editorial that functions as a rolling book on AI-engineering org design.

<a name="articles"></a>
## ✍️ Articles & Essays

Check failure on line 433 in README.md

View workflow job for this annotation

GitHub Actions / markdown-lint

Headings should be surrounded by blank lines 

README.md:433 MD022/blanks-around-headings Headings should be surrounded by blank lines [Expected: 1; Actual: 0; Above] [Context: "## ✍️ Articles & Essays"] https://github.com/DavidAnson/markdownlint/blob/v0.36.1/doc/md022.md

*Long-form writing from canonical authors and engineering teams.*

Expand Down Expand Up @@ -1041,7 +1043,7 @@

- ⭐ 🎥 🆓 [**Intro to LLMs**](https://www.youtube.com/watch?v=zjkBMFhNj_g) — Andrej Karpathy. The reference "how LLMs work" talk.
- ⭐ 🎥 🆓 [**Let's build GPT: from scratch, in code**](https://www.youtube.com/watch?v=kCc8FmEb1nY) — Andrej Karpathy.
- ⭐ 🎥 🆓 [**[1hr Talk] Intro to LLMs (Nov 2024)**](https://www.youtube.com/watch?v=7xTGNNLPyMI) — Karpathy updated "Deep Dive into LLMs".
- ⭐ 🎥 🆓 [**1hr Talk: Intro to LLMs (Nov 2024)**](https://www.youtube.com/watch?v=7xTGNNLPyMI) — Karpathy updated "Deep Dive into LLMs".
- 🎥 🆓 [**State of GPT**](https://www.youtube.com/watch?v=bZQun8Y4L2A) — Andrej Karpathy (Microsoft Build 2023).
- 🎥 🆓 [**Stanford CS25: Transformers United**](https://web.stanford.edu/class/cs25/) — Full lecture series.

Expand Down Expand Up @@ -1255,11 +1257,10 @@

## Update cadence

- **Weekly** — PR triage, broken-link fixes.
- **Monthly** — Trending rotation, new-resource batches.
- **Quarterly** — full thoroughness pass against the checklist in [NOTES.md](./NOTES.md).
Weekly: PR triage and broken-link fixes. Monthly: trending rotation and new-resource batches. Quarterly: full thoroughness pass against the checklist in [NOTES.md](./NOTES.md).

<!--lint disable awesome-license-->
## License

[![CC0](https://i.creativecommons.org/p/zero/1.0/88x31.png)](https://creativecommons.org/publicdomain/zero/1.0/) — To the extent possible under law, the contributors have waived all copyright and related or neighboring rights to this work.

<!--lint enable awesome-license-->
Loading