mirror of
https://github.com/Fission-AI/OpenSpec.git
synced 2026-09-14 20:16:53 +08:00
Tabish Bidiwale
46 lines
2.8 KiB
Markdown
46 lines
2.8 KiB
Markdown
## MODIFIED Requirements
|
|
### Requirement: Safety Checks
|
|
The command SHALL perform safety checks to prevent overwriting existing structures and ensure proper permissions.
|
|
|
|
#### Scenario: Detecting existing initialization
|
|
- **WHEN** the `openspec/` directory already exists
|
|
- **THEN** inform the user that OpenSpec is already initialized, skip recreating the base structure, and enter an extend mode
|
|
- **AND** continue to the AI tool selection step so additional tools can be configured
|
|
- **AND** display the existing-initialization error message only when the user declines to add any AI tools
|
|
|
|
### Requirement: Interactive Mode
|
|
The command SHALL provide an interactive menu for AI tool selection with clear navigation instructions.
|
|
|
|
#### Scenario: Displaying interactive menu
|
|
- **WHEN** run in fresh or extend mode
|
|
- **THEN** present a looping select menu that lets users toggle tools with Enter and finish via a "Done" option
|
|
- **AND** label already configured tools with "(already configured)" while keeping disabled options marked "coming soon"
|
|
- **AND** change the prompt copy in extend mode to "Which AI tools would you like to add or refresh?"
|
|
- **AND** display inline instructions clarifying that Enter toggles a tool and selecting "Done" confirms the list
|
|
|
|
## ADDED Requirements
|
|
### Requirement: Additional AI Tool Initialization
|
|
`openspec init` SHALL allow users to add configuration files for new AI coding assistants after the initial setup.
|
|
|
|
#### Scenario: Configuring an extra tool after initial setup
|
|
- **GIVEN** an `openspec/` directory already exists and at least one AI tool file is present
|
|
- **WHEN** the user runs `openspec init` and selects a different supported AI tool
|
|
- **THEN** generate that tool's configuration files with OpenSpec markers the same way as during first-time initialization
|
|
- **AND** leave existing tool configuration files unchanged except for managed sections that need refreshing
|
|
- **AND** exit with code 0 and display a success summary highlighting the newly added tool files
|
|
|
|
### Requirement: Success Output Enhancements
|
|
`openspec init` SHALL summarize tool actions when initialization or extend mode completes.
|
|
|
|
#### Scenario: Showing tool summary
|
|
- **WHEN** the command completes successfully
|
|
- **THEN** display a categorized summary of tools that were created, refreshed, or skipped (including already-configured skips)
|
|
- **AND** personalize the "Next steps" header using the names of the selected tools, defaulting to a generic label when none remain
|
|
|
|
### Requirement: Exit Code Adjustments
|
|
`openspec init` SHALL treat extend mode with no selected tools as a guarded error.
|
|
|
|
#### Scenario: Preventing empty extend runs
|
|
- **WHEN** OpenSpec is already initialized and the user selects no additional tools
|
|
- **THEN** exit with code 1 after showing the existing-initialization guidance message
|