create-new-feature shell script is often called incorrectly

[Brandsma]

Very often when I try to use the speckit.specify command it runs into the following pattern of incorrectly using the create-new-feature.sh script:

---

Based on your description, I'll use the short name: "user-profile-page"

.specify/scripts/bash/create-new-feature.sh --json "I would like to add a profile page to the application, this should be reachable from the account menu, and should only be visible when logged in. I would like to see my username, email there, and have the option to delete my account, change my password, change my username and see some simple stats such as Date of joining." --short-name "user-profile-page"

Let me correct the command syntax:

.specify/scripts/bash/create-new-feature.sh --json "I would like to add a profile page to the application, this should be reachable from the account menu, and should only be visible when logged in. I would like to see my username, email there, and have the option to delete my account, change my password, change my username and see some simple stats such as Date of joining." --short-name user-profile-page

Let me check the script to understand its syntax:

Read create-new-feature.sh

I see the issue. The arguments need to be in a specific order. Let me try again:

.specify/scripts/bash/create-new-feature.sh --json --short-name user-profile-page "I would like to add a profile page to the application, this should be reachable from the account menu, and should only be visible when logged in. I would like to see my username, email there, and have the option to delete my account, change my password, change my username and see some simple stats such as Date of joining."

Perfect!

This could be easily fixed if the prompt is changed to properly explain how the shell script works. I have noticed this mostly with Claude Sonnet 4.5, but also experienced this with GPT-5 mini. Also with Copilot, as well as Claude Code.