Speq Cli

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 | Features in a domain | | speq feature get / | Full feature spec | | speq feature get "//" | Single scenario | | speq search query "" | Semantic search | | speq feature validate | Validate all specs | | speq feature validate / | Validate single feature |

Workflow

1. Search first
   speq search query ""

2. Get specific content
   speq feature get "//"

3. Validate after changes
   speq feature validate

Example

Finding error handling scenarios:

# 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"

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: marconae
• Source: marconae/speq-skill
• License: MIT

Install and usage instructions live in the source repository linked above.