oliver-kriska/claude-elixir-phoenix / targets/codex/skills/phx-help
phx-help
VerifiedRecommend the right $elixir-phoenix:phx-* workflow. Use when choosing a plugin skill, not for Codex /help.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.7 KB |
| references/tool-catalog.md | markdown | 10.5 KB |
references/tool-catalog.md
View on GitHub# Tool Catalog — Complete Command Reference
Full catalog of all plugin commands, skills, and agents for `$elixir-phoenix:phx-help` routing.
## Workflow Commands (the main cycle)
These commands form a connected pipeline — each reads the previous phase's output.
### `$elixir-phoenix:phx-brainstorm <topic>` — Adaptive requirements gathering
- **When**: Vague idea, unclear scope, want to explore before planning
- **Input**: Topic or feature idea (can be very rough)
- **Output**: `.claude/plans/{slug}/interview.md` with structured requirements
- **Next step**: `$elixir-phoenix:phx-plan` (detects interview.md, skips clarification)
- **Agents used**: phoenix-patterns-analyst, web-researcher (research phase only)
**When to use brainstorm vs plan:**
| Signal | Use |
|--------|-----|
| Clear feature, know what you want | `$elixir-phoenix:phx-plan` directly |
| Vague idea, exploring options | `$elixir-phoenix:phx-brainstorm` |
| Multiple possible approaches | `$elixir-phoenix:phx-brainstorm` (research phase) |
| Requirements unclear, need to discuss | `$elixir-phoenix:phx-brainstorm` |
### `$elixir-phoenix:phx-plan <description>` — Create implementation plan
- **When**: New feature, multi-file change, anything needing structure
- **Input**: Feature description in natural language (or brainstorm interview.md)
- **Output**: `.claude/plans/{slug}/plan.md` with checkboxed tasks
- **Flags**: `--depth quick|standard|deep`, `--existing` (enhance existing plan)
- **Next step**: `$elixir-phoenix:phx-work .claude/plans/{slug}/plan.md`
- **Agents used**: research specialists (phoenix-patterns-analyst + selected); planning-orchestrator compresses the fan-out when 3+ agents are needed
### `$elixir-phoenix:phx-brief <plan-path>` — Interactive plan walkthrough
- **When**: Want to understand a plan before working on it
- **Input**: Path to a plan.md file
- **Output**: Ephemeral (conversation only, no files)
- **Next step**: `$elixir-phoenix:phx-work` or `$elixir-phoenix:phx-plan --existing` to enhance
### `$elixir-phoenix:phx-work <plan-path>` — Execute plan tasks
- **When**: Ready to implement a plan
- **Input**: Path to plan.md with checkboxed tasks
- **Output**: Code changes, updated checkboxes, `progress.md`
- **Flags**: `--continue` (resume from last checkpoint)
- **Next step**: `$elixir-phoenix:phx-review`
### `$elixir-phoenix:phx-review` — Parallel code review
- **When**: Implementation done, want quality check before merging
- **Input**: Git diff (changed files)
- **Output**: `.claude/plans/{slug}/reviews/{feature}-review.md`
- **Agents used**: 3-5 specialist reviewers in parallel
- **Next step**: Fix issues, then `$elixir-phoenix:phx-compound` for lessons learned
### `$elixir-phoenix:phx-triage` — Interactive review triage
- **When**: Review has many findings, need to prioritize
- **Input**: Review file from `$elixir-phoenix:phx-review`
- **Output**: Prioritized action list
### `$elixir-phoenix:phx-compound` — Capture solved problem
- **When**: Just solved a tricky bug or pattern worth remembering
- **Input**: Description of what was solved
- **Output**: `.claude/solutions/{category}/{fix}.md`
- **Why**: Builds searchable knowledge base for future sessions
### `$elixir-phoenix:phx-full <description>` — Autonomous full cycle
- **When**: Large feature, want plan→work→verify→review in one shot
- **Input**: Feature description
- **Output**: All workflow artifacts
- **Caution**: Best for well-defined features; complex ones benefit from manual phase control
## Standalone Commands
### `$elixir-phoenix:phx-quick <description>` — Fast implementation
- **When**: Small change (<50 lines), single file, clear scope
- **Input**: What to change
- **Output**: Direct code changes (no plan artifacts)
- **Examples**: "Add phone field to User schema", "Fix pagination bug in index"
### `$elixir-phoenix:phx-investigate` — Bug investigation
- **When**: Error, crash, unexpected behavior, failing test
- **Input**: Bug description or stack trace
- **Output**: Root cause analysis, fix suggestion
- **Agents used**: deep-bug-investigator (for complex bugs)
- **Checks**: `.claude/solutions/` first for known fixes
### `$elixir-phoenix:phx-verify` — Run all checks
- **When**: Before PR, before deploy, after large changes
- **Runs**: `mix compile --warnings-as-errors`, `mix format`, `mix credo`, `mix test`
- **Output**: Pass/fail report
### `$elixir-phoenix:phx-research <topic>` — Research with parallel workers
- **When**: "How to implement X", "Best practices for Y", "What library for Z"
- **Flags**: `--library <name>` (evaluate a specific Hex package)
- **Output**: Research summary with sources
- **Agents used**: 1-3 web-researcher agents in parallel
### `$elixir-phoenix:phx-pr-review` — Address PR review comments
- **When**: Got review comments on a PR, need to address them
- **Input**: PR number or URL
- **Output**: Code changes addressing each comment
### `$elixir-phoenix:phx-intro` — Interactive plugin tutorial
- **When**: New to the plugin, want to learn what's available
- **Flags**: `--section N` (jump to section 1-6)
### `$elixir-phoenix:phx-init` — Project setup
- **When**: Setting up plugin rules for a new project
- **Output**: Injects rules into project CLAUDE.md
### `$elixir-phoenix:phx-permissions` — Permission analyzer
- **When**: Too many "allow?" prompts, permission fatigue, after 5+ prompts in a session
- **Input**: Optional `--days=N` (default: 14), `--dry-run`
- **Output**: Scans session JSONL files for uncovered Bash commands, recommends `settings.json` changes
- **Triage**: Interactive GREEN/YELLOW/RED triage with AskUserQuestion
### `$elixir-phoenix:phx-challenge` — Rigorous review mode
- **When**: "Grill me", "challenge this", want thorough scrutiny before merging
- **Input**: Changed files (like review)
- **Output**: Aggressive questioning of Ecto changes, LiveView events, PR readiness
### `$elixir-phoenix:phx-document` — Documentation generator
- **When**: Need @moduledoc, @doc annotations, or README updates
- **Input**: Modules or contexts to document
- **Output**: Inline documentation in source files
### `$elixir-phoenix:phx-examples` — Pattern walkthroughs
- **When**: "How do I...", "show me an example of...", learning patterns
- **Input**: Pattern or topic description
- **Output**: Practical examples with working code
### `$elixir-phoenix:ecto-constraint-debug` — Constraint violation debugger
- **When**: unique_constraint, foreign_key_constraint, or check_constraint errors
- **Input**: Error message or constraint name
- **Output**: Traces triggers, checks migrations, finds duplicate data
## Analysis Commands
### `$elixir-phoenix:phx-perf` — Performance analysis
- **When**: "App is slow", "queries are slow", "LiveView is laggy"
- **Covers**: Ecto queries, LiveView renders, OTP bottlenecks
### `$elixir-phoenix:ecto-n1-check` — N+1 query detection
- **When**: Suspect N+1 queries, list pages are slow
- **Output**: Found N+1 patterns with fix suggestions
### `$elixir-phoenix:lv-assigns` — LiveView memory audit
- **When**: LiveView processes using too much memory, large assigns
- **Output**: Assigns size analysis, stream conversion suggestions
### `$elixir-phoenix:phx-audit` — Project health audit
- **When**: Want overall project quality assessment
- **Agents used**: 5 specialist agents in parallel
- **Output**: `.claude/audit/reports/` with findings per area
### `$elixir-phoenix:phx-techdebt` — Technical debt analysis
- **When**: Want to identify and track technical debt
- **Output**: Categorized debt items with severity
### `$elixir-phoenix:phx-boundaries` — Context boundary violations
- **When**: Suspect cross-context coupling, unclear module boundaries
- **Output**: Boundary violation report
### `$elixir-phoenix:phx-trace <function>` — Call chain tracing
- **When**: Need to understand how a function is called and what it calls
- **Agents used**: call-tracer, xref-analyzer
## Decision Helpers
### When to use `$elixir-phoenix:phx-plan` vs `$elixir-phoenix:phx-quick`
| Signal | Use |
|--------|-----|
| 1-2 files, clear change | `$elixir-phoenix:phx-quick` |
| 3+ files or unclear scope | `$elixir-phoenix:phx-plan` |
| New domain concept | `$elixir-phoenix:phx-plan` |
| "Add field to schema" | `$elixir-phoenix:phx-quick` |
| "Add notification system" | `$elixir-phoenix:phx-plan` |
### When to use `$elixir-phoenix:phx-investigate` vs just fixing
| Signal | Use |
|--------|-----|
| Know the cause, small fix | Fix directly |
| Stack trace, unknown cause | `$elixir-phoenix:phx-investigate` |
| Intermittent / race condition | `$elixir-phoenix:phx-investigate` |
| Test failing, obvious assertion | Fix directly |
### When to use `$elixir-phoenix:phx-full` vs manual phases
| Signal | Use |
|--------|-----|
| Well-defined feature, clear scope | `$elixir-phoenix:phx-full` |
| Exploratory, may pivot | `$elixir-phoenix:phx-plan` then decide |
| Want control between phases | Manual: plan → work → review |
| Large feature, new domain | `$elixir-phoenix:phx-full` (handles complexity) |
### When to use `$elixir-phoenix:phx-review` vs `$elixir-phoenix:phx-verify`
| Signal | Use |
|--------|-----|
| Want compile/test/format pass | `$elixir-phoenix:phx-verify` |
| Want architectural feedback | `$elixir-phoenix:phx-review` |
| Pre-PR checklist | Both: `$elixir-phoenix:phx-verify` then `$elixir-phoenix:phx-review` |
## Reference Skills (auto-loaded, not invoked directly)
These load automatically when you edit matching files:
| Skill | Triggers on |
|-------|-------------|
| `liveview-patterns` | `*_live.ex`, `*_component.ex`, `*.sface` |
| `ecto-patterns` | Migrations, schemas, changesets, `from(` |
| `phoenix-contexts` | Context modules, router, controllers |
| `security` | Auth files, session, password |
| `testing` | `*_test.exs`, factories, fixtures |
| `oban` | Workers, `use Oban.Worker` |
| `elixir-idioms` | GenServer, mix tasks, general `.ex` |
| `deploy` | Dockerfile, fly.toml, runtime.exs |
## Workflow Cheat Sheet
```text
New feature: $elixir-phoenix:phx-plan → $elixir-phoenix:phx-work → $elixir-phoenix:phx-review → $elixir-phoenix:phx-compound
Quick fix: $elixir-phoenix:phx-quick
Bug: $elixir-phoenix:phx-investigate
Full auto: $elixir-phoenix:phx-full
Pre-PR: $elixir-phoenix:phx-verify → $elixir-phoenix:phx-review
Research: $elixir-phoenix:phx-research [topic]
Evaluate lib: $elixir-phoenix:phx-research --library [name]
Resume work: $elixir-phoenix:phx-work --continue
Post-fix lesson: $elixir-phoenix:phx-compound
Permissions: $elixir-phoenix:phx-permissions
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |