A free, open-source educational platform that teaches senior software engineers how to build agentic AI systems by mapping 21 design patterns to classical software engineering concepts.

Live site: learnagenticpatterns.com

Each agentic AI pattern is mapped to a familiar SWE concept — so you learn new AI architectures through patterns you already know:

Includes interactive code examples, architecture diagrams, and an Agent Builder game with 21 hands-on exercises.

Code-free modules focused on AI architecture decisions and product tradeoffs for PMs working with agentic systems. Includes two challenge games: Ship or Skip and Budget Builder.

An interactive "Will AI Replace Me?" assessment powered by Google Gemini that provides personalized analysis across 40+ questions for 4 different roles.

• Framework: Next.js 14 (App Router), TypeScript
• Styling: Tailwind CSS, Radix UI, Framer Motion
• Database: PostgreSQL (auto-initializing schema)
• Auth: Email/password with bcrypt + JWT
• AI: Google Gemini API
• Email: Resend
• Analytics: PostHog (optional)
• Monitoring: Sentry (optional)

• Node.js 18+
• PostgreSQL database
• API keys for Gemini and Resend (see .env.example)

1. Clone the repo

   git clone https://github.com/mosatiii/learnagenticpatterns.git
   cd learnagenticpatterns

2. Install dependencies

   npm install

3. Configure environment variables

   cp .env.example .env.local

   Edit .env.local and fill in your values. See .env.example for all available options.

4. Run the development server

   npm run dev

5. Open http://localhost:3000

The PostgreSQL schema auto-initializes on first connection — no manual migrations needed.

app/                  # Next.js App Router pages & API routes
  api/                # REST endpoints (auth, assessment, stats)
  patterns/           # Developer track pattern pages
  pm/                 # Product manager track pages
  blog/               # Blog articles
  practice/           # Agent Builder game & exercises
components/           # React components (UI, game, layout)
contexts/             # Auth context provider
data/                 # Static content (patterns, questions, blog posts, exercises)
lib/                  # Utilities (db, jwt, email, validation, game logic)
docs/                 # Detailed technical documentation
public/               # Static assets

See the docs/ folder for comprehensive documentation of every module.

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

This project is licensed under the MIT License.