diff --git a/README.md b/README.md index 7572728..e098dec 100644 --- a/README.md +++ b/README.md @@ -39,12 +39,38 @@ Spec-Driven Development **flips the script** on traditional software development ### 1. Install Specify -Initialize your project depending on the coding agent you're using: +Choose your preferred installation method: + +#### Option 1: Persistent Installation (Recommended) + +Install once and use everywhere: + +```bash +uv tool install specify-cli --from git+https://github.com/github/spec-kit.git +``` + +Then use the tool directly: + +```bash +specify init +specify check +``` + +#### Option 2: One-time Usage + +Run directly without installing: ```bash uvx --from git+https://github.com/github/spec-kit.git specify init ``` +**Benefits of persistent installation:** + +- Tool stays installed and available in PATH +- No need to create shell aliases +- Better tool management with `uv tool list`, `uv tool upgrade`, `uv tool uninstall` +- Cleaner shell configuration + ### 2. Establish project principles Use the **`/constitution`** command to create your project's governing principles and development guidelines that will guide all subsequent development.