source-management

Shared rules for storing, naming, downloading, and citing research sources in a textbook project.

In plain words
What is it for?
Organising papers, blog posts, and documentation by source type and website path, with all sources stored under the shared sources directory.
Why use it?
They keep sources in one central location and make them easier to reuse and attribute consistently across chapters.

Cursor rule for Cursor

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add rules/ai-learning-gems/ai-learning-gems.github.io/source-management
Clone the repo
git clone --depth 1 https://github.com/AI-Learning-Gems/AI-Learning-Gems.github.io

Made for: Cursor.

Per session 1,695 This file is loaded in full into every session.
When invoked 1,695 The same file — it is already loaded in full.
Security scan A 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.01695 $0.01695
Opus 5 $0.00847 $0.00847
Sonnet 5 $0.00339 $0.00339
Haiku 4.5 $0.00169 $0.00169

Measured 2d ago against content hash 5210a7e6bfea, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

source-management scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

2. Download LaTeX source: `curl -sL "https://arxiv.org/src/{PAPER_ID}" -o source.tar.gz && tar -xzf source.tar.gz`
.cursor/rules/source-management.mdc · 148 lines

How it starts

The opening of the file, as written. The whole thing — 148 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Source Management

Shared source handling rules for all textbook chapter workflows. For site-specific fetch strategies, see web-source-fetching.md. For the curated blog registry, see high-quality-blogs.md.


Centralized Source Storage (CRITICAL)

All sources are stored in AI-Learning-Gems/sources/ — NOT in each chapter folder.

This is a shared, centralized repository. The same source can be referenced by multiple chapters.

Source Folder Naming Conventions

Source Type Folder Pattern Example
arXiv papers sources/arxiv-{PAPER_ID} sources/arxiv-2010.11929/
Blog posts sources/{domain}/{path}/ sources/lilianweng.github.io/posts/2022-06-09-vlm/
d2l.ai chapters sources/d2l.ai/{chapter-path}/ sources/d2l.ai/chapter_attention-mechanisms-and-transformers/vision-transformer/
HuggingFace docs sources/huggingface.co/docs/{path}/ sources/huggingface.co/docs/transformers/model_doc/vit/
PyTorch docs sources/pytorch.org/{path}/ sources/pytorch.org/docs/stable/generated/torch.nn.MultiheadAttention/
Other sites sources/{domain}/{path}/ sources/distill.pub/2021/gnn-intro/

Blog/site URL → folder name rules:

  1. Strip https:// and http://
  2. Strip www.
  3. Use the remaining URL path as the folder path
  4. Store main content as content.md inside the folder
  5. Store images in images/ subfolder

arXiv rules:

  1. Use arxiv-{PAPER_ID} (hyphenated)
  2. Download LaTeX source: curl -sL "https://arxiv.org/src/{PAPER_ID}" -o source.tar.gz && tar -xzf source.tar.gz
  3. Contains .tex files, images/, .bib

Checking for Existing Sources (MANDATORY)

BEFORE downloading any source, check if it already exists:

ls "AI-Learning-Gems/sources/arxiv-2010.11929/" 2>/dev/null && echo "EXISTS" || echo "NEW"

If a source already exists, skip downloading and reference the existing path.


Source Downloading Quick Reference

Read the full file on GitHub · 148 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 148 lines · 1,695 tokens per session scan A 5210a7e6bfea

Subscribe to this mod's changes

source-management is a cursor rule published in the GitHub repository AI-Learning-Gems/AI-Learning-Gems.github.io (22 stars, last pushed 2mo ago), licensed MIT. It adds 1,695 tokens to every session, about $0.0085 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.