tutor-setup

1# Tutor Setup — Knowledge to Obsidian StudyVault
2 
3## CWD Boundary Rule (ALL MODES)
4 
5> **NEVER access files outside the current working directory (CWD).**
6> All source scanning, reading, and vault output MUST stay within CWD and its subdirectories.
7> If the user provides an external path, ask them to copy the files into CWD first.
8 
9## Mode Detection
10 
11On invocation, detect mode automatically:
12 
131. **Check for project markers** in CWD:
14   - `package.json`, `pom.xml`, `build.gradle`, `Cargo.toml`, `go.mod`, `Makefile`,
15     `*.sln`, `pyproject.toml`, `setup.py`, `Gemfile`
162. **If any marker found** → **Codebase Mode**
173. **If no marker found** → **Document Mode**
184. **Tie-break**: If `.git/` is the sole indicator and no source code files (`*.ts`, `*.py`, `*.java`, `*.go`, `*.rs`, etc.) exist, default to Document Mode.
195. Announce detected mode and ask user to confirm or override.
20 
21---
22 
23## Document Mode
24 
25> Transforms knowledge sources (PDF, text, web, epub) into study notes.
26> Templates: [templates.md](references/templates.md)
27 
28### Phase D1: Source Discovery & Extraction
29 
301. **Auto-scan CWD** for `**/*.pdf`, `**/*.txt`, `**/*.md`, `**/*.html`, `**/*.epub` (exclude `node_modules/`, `.git/`, `dist/`, `build/`, `StudyVault/`). Present for user confirmation.
312. **Extract text (MANDATORY tools)**:
32…