Wizardshit

wizardshit.ai

Joel's AI education platform. The crux: teach the exploratory journey of building systems with and around AI.

Not a polished curriculum factory — a system that teaches by showing the system being built. Digital garden philosophy applied to AI education.

Repositories

App: ~/Code/badass-courses/gremlin/apps/wizardshit-ai/

Next.js 16 app in the gremlin monorepo (badass-courses/gremlin). Uses the badass-courses platform:

• @badass-courses/core, @badass-courses/sdk, @badass-courses/next, @badass-courses/ui
• Convex backend via @badass-courses/convex-adapter
• Package name: @wizardshit/web

The gremlin monorepo has its own AGENTS.md — read it before any gremlin work:

cat ~/Code/badass-courses/gremlin/AGENTS.md

Brain/Design: ~/Code/joelhooks/manage/

Vercel manage repo with PARA-structured brain vault. Course design docs live here:

• brain/01 Projects/Agent Game Generation/ — The Claw course design bible
• skills/the-claw-course-design/SKILL.md — course design process skill
• docs/decisions/ — ADRs for the manage workspace

Key design documents (read in order):

1. Course Concept.md — canonical spec (~5K words)
2. Lesson Bookends.md — first and last lesson, fully workshopped
3. Game Design Patterns.md — 20 patterns mapping game mechanics → agent architecture
4. Research - Schell Lenses x Dwarf Fortress x The Claw.md
5. Research - 4CID Learning Design Bible.md
6. Research - Dwarf Fortress Design Philosophy.md
7. Research - just-bash as Game Engine.md
8. Research - Game Design Bibles.md — Koster + Schell
9. Research - Prior Art and Landscape.md
10. Research - Multi-Agent Frameworks as MUD Architecture.md
11. Research - MUD Architecture and Platform Primitives.md

Public gist (full design docs):

https://gist.github.com/joelhooks/99b7188fdd775b32b646ee72484774cc

Two Versions

1. Vercel Academy — toned-down business version. Vercel-native stack (Workflow, Sandbox, Queues, AI Gateway, just-bash). Draft: https://vercel.com/academy/draft/agent-game-generation
2. wizardshit.ai — the full unfiltered version. Free to use whatever infra. Inngest, k8s, Redis, self-hosted — whatever's best.

The Claw: Minions of Toil

The flagship course. A roguelite colony management sim where Zots (autonomous AI agents) toil in a fantasy dungeon generated from real codebases.

Core insight: the game mechanics ARE agent architecture patterns. Health bar = context window. Abilities = tools. Party = multi-agent delegation. Combat = error handling. The representation IS the thing.

Design foundations:

• Koster — fun = learning patterns in a safe space
• Schell — 100+ lenses for design evaluation
• 4C/ID — whole-task from day 1, scaffolding fades, driven by what breaks
• Dwarf Fortress — colony management, autonomous actors, "losing is fun", emergent narrative

Tech (wizardshit version — free to choose):

• just-bash — the game engine (virtual filesystem sandbox)
• AI SDK — Zot brains
• Inngest — tick engine, durable workflows
• Whatever persistence/state makes sense

Linear: DX-2875

Working With This Project

1. For gremlin app work: cd ~/Code/badass-courses/gremlin and read its AGENTS.md
2. For course design: cd ~/Code/joelhooks/manage and read the brain vault docs
3. For joelclaw integration: this is where wizardshit infra decisions may overlap with joelclaw patterns
4. Load the gremlin skill for gremlin-repo-specific guidance