1# Agent Tools Delta — Semantic Spec Diff23## MODIFIED Requirements45### Requirement: Artifact listing and inspection6The plugin SHALL provide tools that map directly to OpenSpec list/show/status/instructions workflows while smoothing known CLI rough edges that would otherwise block fresh-repository agent workflows and SHALL expose a filesystem-backed semantic spec diff tool for comparing specs at the requirement and scenario level without the CLI.78#### Scenario: List changes or specs9- **WHEN** an agent calls `openspec_list` with kind `changes` or `specs`10- **THEN** the tool invokes the OpenSpec CLI JSON list command for that kind and respects supported sort options1112#### Scenario: Show a change or spec13- **WHEN** an agent calls `openspec_show` with a target name and optional flags14- **THEN** the tool invokes the OpenSpec CLI JSON show command with the requested type, delta, requirements, scenario, or requirement filters1516#### Scenario: Validate artifacts17- **WHEN** an agent calls `openspec_validate`18- **THEN** the tool invokes the OpenSpec CLI validation command with strict JSON non-interactive output and the requested target or scope1920#### Scenario: Retrieve implementation instructions21- **WHEN** an agent calls `openspec_instructions`22- **THEN** the tool returns OpenSpec's enriched instructions for the requested artifact, schema, and optional change2324#### Scenario: Semantic spec diff25- **WHEN** an agent calls `openspec_spec_diff` with `workdir`, `spec`, and optional `change`26- **THEN** the tool returns a structured semantic delta at the requirement and scenario level plus a unified line diff fallback, without requiring the OpenSpec CLI binary