speq-cli git:20260720.15e76d6A

Immutable. This exact content is served forever at /api/v1/blob/d5a8affb19a93ba4.

---
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`.

## Search-First Rule

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

Apply **information foraging** — search narrows the scent trail before committing context window 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"
```