Reference
Complete reference documentation for autospec commands, configuration, and YAML schemas.
Overview
This reference section provides detailed documentation for:
- CLI Commands - All autospec commands with syntax, flags, and examples
- Configuration - Configuration options, file locations, and environment variables
- YAML Schemas - Structure and validation rules for spec.yaml, plan.yaml, and tasks.yaml
Quick Reference
Common Commands
| Command |
Description |
autospec run -a "desc" |
Full workflow: specify, plan, tasks, implement |
autospec prep "desc" |
Planning only: specify, plan, tasks |
autospec implement |
Execute tasks from tasks.yaml |
autospec st |
Check current spec status and progress |
autospec doctor |
Verify dependencies |
Exit Codes
| Code |
Meaning |
| 0 |
Success |
| 1 |
Validation failed |
| 2 |
Retries exhausted |
| 3 |
Invalid arguments |
| 4 |
Missing dependencies |
| 5 |
Timeout |
Configuration Priority
- Environment variables (
AUTOSPEC_*)
- Project config (
.autospec/config.yml)
- User config (
~/.config/autospec/config.yml)
- Defaults
File Locations
Configuration Files
| File |
Purpose |
~/.config/autospec/config.yml |
User configuration |
.autospec/config.yml |
Project configuration |
State Files
| File |
Purpose |
~/.autospec/state/retry.json |
Retry state tracking |
~/.autospec/state/history.yaml |
Command history |
Specification Files
| File |
Purpose |
specs/<name>/spec.yaml |
Feature specification |
specs/<name>/plan.yaml |
Implementation plan |
specs/<name>/tasks.yaml |
Task breakdown |
Table of contents