$ course --description [+][-]
This workshop guides humanities scholars through the emerging landscape of agentic coding—building functional tools and applications through collaboration with AI, rather than writing code from scratch. We begin with Claude Artifacts for rapid prototyping and Claude Code Web for browser-based development, then transition to the Claude Code CLI for the remainder of the week. Participants will work through Simon Willison’s agentic engineering framework, learn to build and share reusable skills using the Superpowers methodology, integrate external tools via the Model Context Protocol (MCP), and deploy smaller open-source models from Hugging Face for specialized tasks like transcription. The final deliverable is a working tool with either a local model or MCP integration relevant to participants’ own research and teaching.
No prior programming experience is required—but bring curiosity, a laptop with admin access, and a willingness to think critically about what it means to build with AI.
$ course --prerequisites [+][-]
- Claude Pro subscription — Required for full access to Artifacts, Code Web, and Claude Code CLI. Sign up at claude.ai.
- GitHub account — Use a .edu email if possible for GitHub Education benefits. Create one at github.com.
- Visual Studio Code — Install from code.visualstudio.com.
- Git — Install from git-scm.com. Required for version control in agentic workflows.
- GitHub Desktop (optional) — A visual Git client if you prefer not to use the command line. Install from desktop.github.com.
- Claude Code CLI — We will walk through installation on Day 2, but you can get started early by following the setup guide.
- Ollama — For running local models. Install from ollama.com. We will configure it on Day 2, but having it installed in advance saves time.
- Administrative laptop access — You will need to install software during the workshop.
$ course --readings [+][-]
Complete these before the first session. They provide the conceptual framework we’ll build on all week.
- Martin, Meredith. “Command Lines for the Humanities.” PMLA 139.3 (2024): 541–547.
- Mitchell, Melanie. “On Evaluating Cognitive Capabilities in Machines (and Other ‘Alien’ Intelligences).” AI: A Guide for Thinking Humans. January 14, 2026.
- Benjamin, Ruha. “The New Artificial Intelligentsia.” Los Angeles Review of Books. October 18, 2024.
- Ford, Paul. “Timing My Vibe Coding.” The Aboard Podcast. July 29, 2025.
- Willison, Simon. “Not All AI-Assisted Programming is Vibe Coding (But Vibe Coding Rocks).” simonwillison.net. March 19, 2025.
- Noble, Safiya Umoja. “Algorithms Aren’t Neutral: Safiya Noble on AI, Bias, and Building Public-Interest Technology.” My Robot Teacher podcast. California Education Learning Lab. 2025. (Transcript available on Substack.)
$ day-1 --am [+][-]
Session 1: Positioning and Prototyping with Artifacts
Readings:
- Mollick, Ethan. “Claude Code and What Comes Next.” One Useful Thing. January 7, 2026.
- Willison, Simon. “Agentic Engineering Patterns” (Introduction and “What is Agentic Engineering?”). simonwillison.net. February 23, 2026.
- Cohen, Dan. “The Index and the Vector.” Humane Ingenuity.
Topics:
- Welcome and introductions: who’s in the room, what do you want to build?
- The agentic coding spectrum: vibe coding → distant coding → agentic engineering
- Willison’s framework: what changes when code is cheap to write?
- Hands-on: Claude Artifacts for rapid prototyping — building a text analysis tool, a quiz, or a timeline in the browser without leaving the chat
- Discussion: what can Artifacts do, and where do they hit a wall?
Exercise: Build a small interactive artifact relevant to your research or teaching. Share it with the group. We’ll revisit this project on Day 5.
$ day-1 --pm [+][-]
Session 2: Claude Code Web — Beyond the Chat Window
Readings:
- Willison, Simon. “Beyond Vibe Coding.” simonwillison.net. September 4, 2025.
- Cohen, Dan. “The Writing Is on the Wall for Handwriting Recognition.” Humane Ingenuity.
Topics:
- From Artifacts to Code Web: when you need files, persistence, and real deployment
- Working in Code Web: projects, file management, GitHub integration
- Demo: building a multi-page GitHub Pages site from a research project
- Discussion: the spectrum from chat to code — when do you need each tool?
Exercise: Take the artifact you built this morning and rebuild or extend it in Code Web. Deploy it to GitHub Pages.
$ day-2 --am [+][-]
Session 3: Claude Code CLI — Setup and First Principles
Readings:
- Willison, Simon. “Writing Code Is Cheap Now” (Chapter from Agentic Engineering Patterns).
- Babich, Nick. “7 Essential Claude Code Slash Commands.” UX Planet. March 2026.
Topics:
- Installing and configuring Claude Code CLI
- The terminal as creative workspace: navigating the command line for humanists
- Running terminal commands from within Claude: how the agent executes bash, installs packages, and interacts with your file system — and when to let it vs. when to intervene
- Slash commands: built-in commands (
/help,/init,/clear,/compact) and how they structure your workflow (Claude Code CLI reference) - Building a custom slash command: creating
.claude/commands/files as reusable prompt templates for your own research workflows (Custom slash commands guide) - Demo: setting up a project from scratch with Claude Code, including writing a custom slash command
Exercise: Initialize a new project with Claude Code. Create a custom slash command for a task you repeat often (e.g., /analyze-text, /format-citations, /summarize-source). Use Claude Code to scaffold a basic tool.
$ day-2 --pm [+][-]
Session 4: Context Engineering and Local Models
Readings:
- Willison, Simon. “Using Git with Coding Agents.” (Chapter from Agentic Engineering Patterns).
- Willison, Simon. “Hoard Things You Know How to Do.” (Chapter from Agentic Engineering Patterns).
- Willison, Simon (with Grace Huckins). “How to Run an LLM on Your Laptop.” MIT Technology Review. July 17, 2025.
Topics:
- Context engineering: CLAUDE.md files, project memory, and teaching the agent about your work
- Git basics for agentic workflows: why version control matters more, not less, with AI
- Why local models? Privacy, cost, offline access, and running specialized tasks without the cloud
- Installing and configuring Ollama: pulling models, understanding model sizes and hardware requirements
- Connecting Ollama to Claude Code: using
ollama launch claudeand environment variable configuration (Ollama integration guide) - When to use local vs. cloud models: the tradeoffs for humanities researchers
- Demo: setting up Ollama, running a local model, and connecting it to Claude Code for a text analysis task
Exercise: Write a CLAUDE.md file that describes your research domain and goals. Install Ollama and pull a small model (e.g., Llama 3.2 3B or Qwen 3). Connect it to Claude Code and compare the experience of working with a local model vs. Claude for a simple task.
$ day-3 --am [+][-]
Session 5: The Model Context Protocol
Readings:
- Anthropic. “Introduction to Model Context Protocol.” Anthropic Documentation.
- Cohen, Dan. “AI and Libraries, Archives, and Museums, Loosely Coupled.” Humane Ingenuity.
- Cohen, Dan. “The Reboot of Digital Humanities Now.” Humane Ingenuity.
Topics:
- What is MCP? The “USB-C for AI” — connecting Claude to external tools and data
- The MCP ecosystem: servers, clients, and the community registry
- Demo: connecting Claude Code to GitHub, a file system, and a web browser via MCP
- The Zotero MCP: connecting your reference library directly to Claude for citation-aware workflows
- The Hugging Face MCP: accessing open-source models from within Claude Code
- Demo: using the Hugging Face MCP to find and deploy a transcription model (Whisper) for archival audio
- Discussion: what data sources and tools matter for your research?
Exercise: Configure at least one MCP server with your Claude Code installation. Use the Hugging Face MCP to identify a small model relevant to your research (transcription, OCR, classification, translation). Build a simple pipeline that integrates it.
$ day-3 --pm [+][-]
Session 6: The Superpowers Workflow
Readings:
- Vincent, Jesse. “Superpowers: How I’m Using Coding Agents in October 2025.” blog.fsck.com. October 9, 2025.
- Willison, Simon. “Subagents” (Chapter from Agentic Engineering Patterns).
Topics:
- The Superpowers framework: Brainstorm → Spec → Plan → Subagent Development → Review → Finalize
- Installing and configuring the Superpowers plugin
- The /brainstorm command: Socratic dialogue before code
- Subagent-driven development: dispatching parallel tasks with built-in review
- Demo: walking through the full Superpowers workflow on a real DH tool
- Discussion: structured methodology vs. improvisation — when does each serve humanities work?
Exercise: Use the full Superpowers workflow to brainstorm, plan, and begin implementing your final project tool.
$ day-4 --am [+][-]
Session 7: Building and Sharing Skills
Readings:
- Willison, Simon. “2025: The Year in LLMs.” simonwillison.net. December 31, 2025.
- Mollick, Ethan. “On Holding Back the Strange AI Tide.” One Useful Thing.
Topics:
- What are skills? Reusable SKILL.md files that encode expertise
- Anatomy of a skill: frontmatter, instructions, examples, and pressure-testing
- Building a custom skill for a humanities workflow (e.g., a “distant reading” skill, a “metadata extraction” skill, an “archival transcription” skill)
- Sharing skills: the community ecosystem and the Anthropic marketplace
- Demo: authoring, testing, and installing a custom skill
Exercise: Design and write a skill that encodes a workflow from your discipline. Test it by having Claude Code use it on a sample project. Share it with the group.
$ day-4 --pm [+][-]
Session 8: Building Your Tool
Readings:
- Underwood, Ted. “A More Interesting Upside of AI.” The Stone and the Shell. July 2, 2025.
- Underwood, Ted. “The Marionette Theater of AI.” The Stone and the Shell. February 8, 2026.
- MLA Executive Council. “Educational Technologies and AI Agents.” MLA News. January 30, 2026.
Topics:
- Dedicated build session: complete your final tool with instructor support
- Integration patterns: combining MCP connections, local models, and custom skills into a single workflow
- Troubleshooting and peer review
- Deployment options: GitHub Pages, local tools, shareable packages
$ day-5 --am [+][-]
Session 9: Presentations and Futures
Readings:
- Mollick, Ethan. “The Future of Education in a World of AI.” One Useful Thing.
Topics:
- Participant presentations: demo your tool, explain your process, reflect on what you learned
- Discussion: what does this mean for how we teach programming in DH?
- Pedagogical takeaways: designing assignments around agentic coding for your own courses
- Resources for continuing: communities, documentation, and next steps
Deliverable: A working tool with either local model or MCP integration, deployed or shareable, accompanied by a brief reflection on the process of building it.
Friday PM: Free
$ course --resources [+][-]
Agentic Engineering
- Willison, Simon. Agentic Engineering Patterns (full guide, updated regularly)
- Vincent, Jesse. Superpowers (GitHub repository and documentation)
- Anthropic. Claude Code Documentation
- Anthropic. MCP Documentation
- Anthropic. Skilljar: Introduction to Model Context Protocol (free course)
Local Models and Ollama
- Ollama. Quickstart Guide
- Ollama. Claude Code Integration
- Ollama. “ollama launch.” Ollama Blog. January 23, 2026.
- Willison, Simon (with Grace Huckins). “How to Run an LLM on Your Laptop.” MIT Technology Review. July 17, 2025.
Hugging Face and Open Models
- Hugging Face. Open Source Models Hub
- Hugging Face. “Supercharge Your OCR Pipelines with Open Models”
- OpenAI. Whisper (speech-to-text) on Hugging Face
Digital Humanities and AI Pedagogy
- Salter, Anastasia & John Murray. DHSI 2025: DH Programming Pedagogy in the Age of AI (previous iteration)
- Salter, Anastasia & Lai-Tze Fan. Distant Coding for the Digital Humanities (MLA 2026)
- Johnson, Emily K. & Anastasia Salter. Critical Making in the Age of AI (companion resources)
- Locke, Brandon. “Digital Humanities Pedagogy as Essential Liberal Education.” DHQ 11.3 (2017).
Practitioner Blogs
- Mollick, Ethan. One Useful Thing (Substack)
- Willison, Simon. simonwillison.net
- Cohen, Dan. Humane Ingenuity
- Underwood, Ted. The Stone and the Shell