Documentation assumes prior knowledge of `uv` and its origin

[MrHinsh]

The installation instructions currently show only:

uv tool install specify-cli --from git+https://github.com/github/spec-kit.git

The documentation assumes that users already know this is a Python-based implementation and that uv is installed. This is a false assumption and significantly limits accessibility.

Since uv is a third-party tool developed by [Astral](https://github.com/astral-sh/uv), and this is not mentioned anywhere, it seems that you expect potential users to just magically know this information. Please update the documentation to:

• Explain that uv is a Python tool manager from Astral.
• Include installation instructions or a link to [uv’s documentation](https://docs.astral.sh/uv/getting-started/installation/).
• Clarify that uv must be installed before running the command.

Suggested Fix

Add a short clarification under “⚡ Get Started → 1. Install Specify CLI”, explaining what uv is and how to install it.
For example:

#### Prerequisite: Install uv

The following installation command uses **[uv](https://docs.astral.sh/uv/)** — a modern Python package and environment manager by Astral.  
`uv` is not included in any operating system and must be installed separately.

You can install it via:
<pre>```bash
# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows (PowerShell)
irm https://astral.sh/uv/install.ps1 | iex
````</pre>

Ensure you have **Python 3.11+** installed before running `uv`.

Then, continue with the existing installation section:

uv tool install specify-cli --from git+https://github.com/github/spec-kit.git

Rationale

This small addition would:

• Prevent confusion for non-Python developers.
• Improve onboarding by clearly identifying the required tooling.
• Acknowledge the dependency on Astral’s uv, giving proper attribution and context.

[anchildress1]

@localden FYI - I'll put this one on my list. It might take me a week or so to get back to it though, so just lmk if somebody else can grab it before then.

[sdudnic-ingerop]

• what is UV, and why should i install it on my machine?
• is there a way to install the tool without uv?

[bsquidwrd]

I like what @sdudnic-ingerop proposes, with a brief explanation being added and maybe alternatives (if it's possible).

There's currently already a Prerequisites section in the README that mentions uv is required, but it should probably be mentioned in the Get Started section, or maybe re-ordering so Prerequisites are before Get Started.

spec-kit/README.md

Lines 299 to 307 in e6d6f3c

	## 🔧 Prerequisites
	- **Linux/macOS/Windows**
	- [Supported](#-supported-ai-agents) AI coding agent.
	- [uv](https://docs.astral.sh/uv/) for package management
	- [Python 3.11+](https://www.python.org/downloads/)
	- [Git](https://git-scm.com/downloads)
	If you encounter issues with an agent, please open an issue so we can refine the integration.

[sdudnic-ingerop]

also it's not clear

Install once and use everywhere:
uv tool install specify-cli --from git+https://github.com/github/spec-kit.git

Then use the tool directly:

specify init <PROJECT_NAME>
specify check

Not clear if the command is to create a new project in a not yet existing folder or to apply to an existing project, in an existing folder?

[mnriem]

Delivered by #2465