phx-help

Invoke phx-help with a short description of what you want to do, or with no arguments to let it analyze your git status and existing plans. It returns one recommended command with exact syntax, expected artifacts, and the suggested next step.

Use phx-quick for small changes under 50 lines in one or two files with clear scope, such as adding a field to a schema. Use phx-plan for multi-file features, new domain concepts, or anything needing structured tasks.

Use phx-investigate when you have a stack trace, unknown cause, intermittent failure, or race condition. If you already know the cause and the fix is small, fix it directly without the investigation workflow.

Yes. With no arguments it gathers ambient context in parallel: existing plans under .claude/plans, git status for uncommitted changes, and prior solution documents. It then classifies your situation and recommends a command.

It gives exactly one recommendation and asks at most one clarifying question, so vague requests may need a follow-up. It never blocks users who already know which command they want to run.