git:20260720.15e76d6 to git:20260825.418db64

2 added, 19 removed. Audit A to A.

---

name: speq-cli

description: Query specs via the speq CLI — semantic search, feature listing, structure validation. Use before reading any spec file; every speq orchestrator and sub-agent invokes this first for spec discovery, search, or validation.

---

# speq CLI

- Spec-driven development via the speq CLI. The spec CLI is installed locally and available in the path. Invoke via `speq`.

+ The CLI is installed locally and on the path. Invoke via `speq`.

## Search-First Rule

- **Never read full spec files without searching first.**

- Apply **information foraging** — search narrows the scent trail before committing context window budget.

+ **Never read full spec files without searching first.** Search narrows the target before you spend context budget.

## Command Reference

| Command | Purpose |

|---------|---------|

| `speq domain list` | List all domains |

| `speq feature list` | Tree view of all features |

| `speq feature list <domain>` | Features in a domain |

| `speq feature get <domain>/<feature>` | Full feature spec |

| `speq feature get "<domain>/<feature>/<scenario>"` | Single scenario |

| `speq search query "<query>"` | Semantic search |

| `speq feature validate` | Validate all specs |

| `speq feature validate <domain>/<feature>` | Validate single feature |

## Workflow

```

1. Search first

speq search query "<relevant terms>"

2. Get specific content

speq feature get "<domain>/<feature>/<scenario>"

3. Validate after changes

speq feature validate

- ```

- ## Example

- Finding error handling scenarios:

- ```bash

- # Search for related scenarios

- speq search query "error handling validation"

- # Get specific scenario

- speq feature get "cli/validate/Validation fails on missing field"

- # Validate structure

- speq feature validate cli/validate

```

## Anti-Pattern

```

# Wrong: Loading entire spec files

cat specs/cli/validate/spec.md

# Right: Search and get specific

speq search query "validation"

speq feature get "cli/validate/Required field missing"

```