Learn Workflow
Turn a topic / paper / lesson into reusable, durable knowledge.
Start
- Route-confirm (see
CONVENTIONS.md): in one line, say this is the learn workflow and which mode you suggest; wait for the go-ahead. - Confirm mode: default 🧠 Philosopher; the user may switch to ⚙️ Engineer.
- (Optional) Anchor the material to the user's own focus area so new knowledge connects to what they care about.
🧠 Philosopher mode (default)
Goal: truly understand, reusable for life. Slow is fine; half-baked is not.
- Frame — What is this? What field? Why does it matter?
- Decompose to first principles — Break down to irreducible concepts; at each layer ask "why this way, why not otherwise?"
- Feynman check (optional) — Have the user explain it back in plain words. Where they stumble = not yet understood → go back and fill the gap. Skippable on request.
- Connect — Link to what they already know (prior topics, notes).
- Capture — Write
outputs/notes/note_<english-slug>.md: one-sentence essence + 3 key insights + open questions.
⚙️ Engineer mode
Goal: get usable conclusions, time-boxed. For exams / reproducing a result / looking up one thing.
- Anchor the goal — What will you do with this? (exam / reproduce / ship)
- Extract — Go straight to takeaways + key formulas / APIs; skip derivations.
- Action list — Turn it into executable steps or a code skeleton.
- Capture — Write
outputs/notes/cheat_<english-slug>.md: a quick-reference card.
Wrap-up conventions
- Live-search principle: look up external facts (papers, recipes, APIs, data) online; don't rely on training memory. Pure reasoning / math is exempt.
- Promote: if it's directional/reusable, offer to save it to long-term memory; one-off outputs stay put.
- Filenames use English slugs (e.g.
note_transformers.md). - Follow the host repo's
CLAUDE.mdstyle if present.