docs: update claude setup

refactor: Move some things to roles
refactor: fix some linting

templates/claude-templates.md

@@ -155,9 +155,38 @@
 
 ---
 
-## Template 4: Session Handoff
+## Template 4A: Light Handoff
 
-**Use when:** A session is ending (context limit approaching OR phase complete)
+**Use when:** A quick-task session produced output worth continuing in a future session.
+
+**Write to:** `./docs/summaries/handoff-[YYYY-MM-DD]-[topic].md`
+
+```markdown
+# Handoff: [Topic]
+**Date:** [YYYY-MM-DD]
+**Focus:** [one sentence]
+
+## Accomplished
+- [task] → `[output path]`
+
+## Key Numbers & Decisions
+- [metric/decision]: [value/outcome] — [rationale if not obvious]
+
+## Open Questions
+- [ ] [question] — impacts [what]
+
+## Next Action
+[Specific first thing to do next session, with file path if relevant]
+
+## Files to Load Next Session
+- `[file path]` — [why needed]
+```
+
+---
+
+## Template 4B: Full Session Handoff
+
+**Use when:** A sustained-work session is ending (context limit approaching OR phase complete)
 
 **Write to:** `./docs/summaries/handoff-[YYYY-MM-DD]-[topic].md`