---
name: learnstack
version: 1.0.0
description: |
  learnstack system overview and command reference. Entry point for new users.
  Shows all available skills, the session flow, and how to get started.
  To begin a session, run /orchestrate-learn. To set up a profile, run /profile.
allowed-tools:
  - Bash
  - Read
  - Write
  - AskUserQuestion
---

# learnstack

learnstack turns Claude Code into a personalized learning mentor. Every skill reads your learner profile and session history so each session builds on the last — you never start cold.

## Start here

**First time:**
```
/profile
```

**Every day after that:**
```
/orchestrate-learn
```

## Skills

| Skill | When to use |
|-------|-------------|
| `/profile` | First session, or when your goals change |
| `/orchestrate-learn` | Start of every learning day |
| `/review` | 5-min warm-up before every session — re-activates last session's key concepts |
| `/daily` | Set today's specific goal and session plan |
| `/socratic-tutor [topic]` | Main theory block |
| `/hands-on [exercise]` | Practice block |
| `/memory-drill` | After any lesson — Anki cards + mnemonics |
| `/examiner` | End of session (`--session`) or end of week (`--weekly`) |
| `/interview-sim` | Interview simulation — scored Q&A from all covered topics, tracks improvement across runs |
| `/feynman [concept]` | After theory block — always required before practice |
| `/unstuck` | When stuck and you don't know why |
| `/notes` | End of every session — saves everything |

## Daily session flow

```
/orchestrate-learn         ← reads history, shows progress, sets direction
  └─ /review               ← 5-min warm-up: re-activates last session (skipped on first session)
  └─ /daily                ← sets today's goal and timed blocks
  └─ /socratic-tutor       ← theory with Socratic questions (understanding gate)
  └─ /feynman              ← explain it back — required consolidation before practice
  └─ /hands-on             ← practice from confirmed resources (if applicable)
  └─ /memory-drill         ← Anki cards + mnemonics
  └─ /examiner --session   ← gap check, marks goal ✅/🔄/❌
  └─ /notes                ← saves session, updates PROGRESS.md, commits

/interview-sim             ← run anytime after lessons to test yourself
  Modes:
    /interview-sim                        all covered topics, screening format
    /interview-sim --topic [topic]        focus on one topic
    /interview-sim --type deep-dive       harder questions + follow-ups
    /interview-sim --type rapid-fire      10–12 quick questions, breadth test
    /interview-sim --review [N]           review a past run without re-running
```

## Where everything is saved

```
study-notes/
├── LEARNER.md                    ← your profile (all skills read this)
├── PROGRESS.md                   ← lesson log — what's done, what's next
├── INTERVIEW_PROGRESS.md         ← interview simulation score history
├── sessions/
│   └── YYYY-MM-DD.md             ← full notes: theory, practice, Q&A, summaries
├── interview-sims/
│   └── YYYY-MM-DD-[type]-[N].md  ← full Q&A log + scorecard per run
└── anki/
    └── YYYY-MM-DD.csv            ← ready-to-import Anki deck
```

## Hard rules

- No teaching without LEARNER.md
- Every fact cites a confirmed resource — no invented examples
- Every session ends with /examiner then /notes — in that order (examiner sets goal status, notes records it)
- If a session goal was not achieved, /orchestrate-learn continues from there tomorrow