skills/fission-ai__openspec

mirror of https://github.com/Fission-AI/OpenSpec.git synced 2026-09-14 20:16:53 +08:00

Files

T

Tabish Bidiwale 7ced2a8791 archive: apply delta-based spec updates and archive changes\n\n- adopt-delta-based-changes: fix MODIFIED/ADDED headers; update specs; archive\n- add-zod-validation: mark cli-diff validation as ADDED; archive\n- adopt-verb-noun-cli-structure: move Flags to MODIFIED; archive\n\nAlso adjust openspec-conventions deltas to reflect existing headers.

2025-08-20 03:11:00 +10:00

1.0 KiB

Raw Permalink Blame History

Delta: OpenSpec Conventions — Verb–Noun CLI Design

ADDED Requirements

Requirement: Verb–Noun CLI Command Structure

OpenSpec CLI design SHALL use verbs as top-level commands with nouns provided as arguments or flags for scoping.

Scenario: Verb-first command discovery

WHEN a user runs a command like openspec list
THEN the verb communicates the action clearly
AND nouns refine scope via flags or arguments (e.g., --changes, --specs)

Scenario: Backward compatibility for noun commands

WHEN users run noun-prefixed commands such as openspec spec ... or openspec change ...
THEN the CLI SHALL continue to support them for at least one release
AND display a deprecation warning that points to verb-first alternatives

Scenario: Disambiguation guidance

WHEN item names are ambiguous between changes and specs
THEN openspec show and openspec validate SHALL accept --type spec|change
AND the help text SHALL document this clearly