Skip to content

Update README with project initialization instructions#1772

Open
lubatti wants to merge 1 commit intogithub:mainfrom
lubatti:patch-1
Open

Update README with project initialization instructions#1772
lubatti wants to merge 1 commit intogithub:mainfrom
lubatti:patch-1

Conversation

@lubatti
Copy link

@lubatti lubatti commented Mar 6, 2026

Description

Specified instructions for One-time Usage for new and existing project.

AI Disclosure

  • I did not use AI assistance for this contribution
  • I did use AI assistance (describe below)

Added instructions for creating a new project and initializing in an existing project.
@lubatti lubatti requested a review from mnriem as a code owner March 6, 2026 13:32
Copilot AI review requested due to automatic review settings March 6, 2026 13:32
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the README “Get Started” instructions to clarify how to initialize Spec Kit via one-time uvx usage for both new projects and existing directories.

Changes:

  • Adds an explicit “Create new project” comment to the one-time usage example.
  • Adds an explicit “initialize in existing project” one-time usage command (specify init . via uvx).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

uvx --from git+https://github.com/github/spec-kit.git specify init <PROJECT_NAME>

# Or initialize in existing project
uvx --from git+https://github.com/github/spec-kit.git specify init .
Copy link

Copilot AI Mar 6, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In the one-time usage example, you only show initialization via . but elsewhere in the README (and in other docs) you also present the --here variant. Consider adding the uvx ... specify init --here alternative (or a brief note that . and --here are equivalent) to keep the instructions consistent and avoid confusion on shells/OSes where . can be ambiguous.

Suggested change
uvx --from git+https://github.com/github/spec-kit.git specify init .
uvx --from git+https://github.com/github/spec-kit.git specify init .
# or
uvx --from git+https://github.com/github/spec-kit.git specify init --here

Copilot uses AI. Check for mistakes.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants