Summary

This repository provides a curated collection of Substack articles on AI fundamentals, tips, and workflows, formatted for direct consumption by AI coding agents. It transforms these articles into a teachable resource, enabling AI instructors to guide users through complex topics, answer questions, and cite specific source material, thereby offering a personalized and efficient learning experience for developers and AI tool users.

How It Works

The core innovation lies in structuring published Substack articles into machine-readable formats (CLAUDE.md/AGENTS.md). When cloned into an IDE and accessed by compatible AI agents like Claude Code, Cursor, or Codex, the repository acts as a knowledge base. The AI can then query this base, providing contextually relevant answers and precise citations to the original articles and sections, facilitating a self-paced, interactive learning environment directly within the developer's workflow.

Quick Start & Requirements

• Install: Clone the repository: git clone https://github.com/in-the-weeds-hannah-stulberg/substack-articles.git.
• IDE: Open the cloned folder in Cursor or VS Code.
• AI Tool: Initiate Claude Code via claude in the terminal. Other AI tools can leverage the AGENTS.md file.
• Prerequisites: Git, a compatible IDE, and an AI coding agent.
• Links:
  • Repository: https://github.com/in-the-weeds-hannah-stulberg/substack-articles
  • Practice Repo: sidwyn/acme-ops (for GitHub 101)
  • Community/Updates: hannahstulberg.substack.com

Highlighted Details

• Structured learning paths include a 7-part "Claude Code for Everything" series and a 2-part "Tool School."
• AI agents function as personal instructors, answering questions and citing specific article sections.
• A dedicated practice repository (sidwyn/acme-ops) is provided for hands-on GitHub exercises.
• Articles are designed for standalone comprehension, requiring no prior technical background.

Maintenance & Community

This repository is maintained by Hannah Stulberg, with several articles co-authored by Sidwyn Koh, Akshat Khandelwal, and Joel Salinas. Community interaction and updates are primarily facilitated through the In the Weeds subscriber chat on Substack and the author's Substack newsletter.

Licensing & Compatibility

The content is licensed under CC BY-NC 4.0 (Creative Commons Attribution-NonCommercial 4.0 International). This license permits use and distribution but strictly prohibits commercial applications and requires attribution.

Limitations & Caveats

The CC BY-NC 4.0 license imposes a significant restriction, limiting the repository's use to non-commercial purposes only. The full interactive learning experience is dependent on the user employing compatible AI coding agents. The scope of knowledge is confined to the topics covered within Hannah Stulberg's published Substack articles.