AI Hero Dev — Learning Workspace

Personal workspace for the AI Coding for Real Engineers cohort (2026-04) by Matt Pocock at AI Hero. It keeps the course project, skill-building exercises, shared skills, and exercise CLI together as local learning snapshots.

Prerequisites

• A Bash-compatible shell and Git with network access to GitHub
• Node.js v22 or newer
• pnpm v9 or newer

Warning

setup.sh downloads four third-party GitHub repositories and then permanently removes each downloaded repository's .git directory. The resulting folders are untracked, git-free snapshots, not normal clones. Review the script before running it, and keep work you need to preserve somewhere else before replacing any snapshot.

Quick Start

This is the recommended path to a running copy of the main course project:

git clone https://github.com/r3dlex/ai-hero-dev.git
cd ai-hero-dev
./setup.sh

cd cohort-003-project
pnpm install
pnpm db:migrate
pnpm db:seed
pnpm dev

The first successful result is the seeded Cadence course-platform home page at http://localhost:5173/. Keep pnpm dev running while you use the app.

Rerunning and Updating Safely

• Rerunning ./setup.sh is non-destructive for existing snapshot directories: the script prints SKIP (exists) and leaves them unchanged.
• setup.sh does not update or pull an existing snapshot. To refresh one, first preserve any work inside it, then remove or move only that snapshot directory and rerun ./setup.sh.
• pnpm db:seed drops and recreates the course project's local SQLite tables. Run it again only when resetting that sample data is acceptable.
• The four snapshot directories are ignored by this workspace's Git repository and must not be committed here.

Workspace Contents

Path	Purpose
cohort-003-project/	Main React Router, TypeScript, SQLite, and Drizzle exercise project
cohort-003-skill-building/	Standalone skill-building exercises
skills/	Matt Pocock's Claude Code skills library
ai-hero-cli/	Exercise navigation CLI
COURSE.md	Course structure, lesson map, and skill reference
spec/	Detailed specifications for each snapshot
AGENTS.md	Workspace conventions and agent guidance
CLAUDE.md	Claude Code entrypoint

The snapshot sources are:

• ai-hero-dev/cohort-003-project
• ai-hero-dev/cohort-003-skill-building
• mattpocock/skills
• mattpocock/ai-hero-cli

Troubleshooting

• ./setup.sh: permission denied: run bash setup.sh from the workspace root.
• A clone fails: confirm GitHub is reachable and rerun the script. If an incomplete destination remains, preserve anything useful, remove or move that one directory, and rerun; otherwise it will be skipped as existing.
• pnpm is unavailable: confirm node --version reports v22 or newer, then install pnpm v9+ before continuing. If your Node distribution includes Corepack, corepack enable can make pnpm available.
• Dependency or SQLite native-module installation fails: confirm the active Node version is supported, then rerun pnpm install inside cohort-003-project.
• The app reports missing tables or data: run pnpm db:migrate; run pnpm db:seed only if resetting the local sample database is acceptable.
• Port 5173 is already in use: stop the process using it or open the alternative URL printed by pnpm dev.

AI SDLC v3

This repo follows the v3 AI-SDLC layout. See .ai/matrix.json, .memory/human-override/, and docs/architecture/adr/. Modules at r3dlex/skills/ai-sdlc-init/modules/.