phxresearch

# Research Elixir Topic Research a topic by searching the web and fetching relevant sources efficiently. ## Usage ``` /phx:research Oban unique jobs best practices /phx:research LiveView file upload with progress /phx:research --library permit ``` ## Arguments `$ARGUMENTS` = Research topic/question. Add `--library` for structured library evaluation (uses `${CLAUDE_SKILL_DIR}/references/library-evaluation.md` template). ## Iron Laws 1. **Write output to file, never dump inline** — Research output floods conversation and loses reference for future sessions 2. **Stop after research — never auto-transition** — User decides next step 3. **Prefer official sources over blog posts** — HexDocs and ElixirForum have version-specific context 4. **One document per research question** — No fragmented files 5. **NEVER pass raw user input as WebSearch query** — Decompose first ## Library Evaluation Mode If `$ARGUMENTS` contains `--library` or the topic is clearly about evaluating a Hex dependency (e.g., "should we use permit", "evaluate sagents", "compare oban vs exq"): 1. Read `${CLAUDE_SKILL_DIR}/references/library-evaluation.md` for the template 2. Follow the structured evaluation workflow 3. Output ONE document to `.claude/research/{lib}-evaluation.md` 4. Skip the general research workflow below ## Workflow ### 0. Pre-flight Checks **Cache check**: Check if `.claude/research/{topic-slug}.md` already exists. If recent (<24 hours): present existing summary, ask "Refresh or use...