| name | speq-cli |
| description | Query specs via speq CLI. Search scenarios, list features, validate structure. |
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:
speq search query "error handling validation"
speq feature get "cli/validate/Validation fails on missing field"
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"