TaskFlow — Claude Mastery Curriculum

A small AI-augmented task & project tracker — Python (FastAPI) backend, TypeScript (React + Vite) frontend — built as the running project for a seven-phase curriculum in using Claude Code, Claude Desktop, and Cowork at an expert level: coding, agentic workflows, testing, CI/CD, deployment, and observability.

Full curriculum, phase-by-phase, with live progress: nickhargreaves.github.io/ClaudePowerUser

Live app: taskflow-nh-web.fly.dev (currently down — Fly's free trial ended and the account needs a credit card before the apps can run again; see CURRICULUM.md)

For the raw status checklist, see CURRICULUM.md.

Follow along yourself

This isn't just a writeup — it's meant to be forked and done. Each phase has a tagged reference commit and a step-by-step lesson: docs/lessons/.

The project

TaskFlow uses the Claude API itself — to triage new tasks — which gives the curriculum a real reason to touch every part of the lifecycle: an API to test, a UI to ship, an LLM call to observe, and a deploy target to watch in production.

Stack: FastAPI · React + Vite + TypeScript · pytest / vitest · GitHub Actions · Docker · Claude API Tool Runner · MCP

Running it locally

# backend
cd backend && uv run uvicorn app.main:app --reload --port 8000

# frontend (separate shell)
cd frontend && npm run dev

The frontend dev server proxies /api/* to http://127.0.0.1:8000.