> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.astropods.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.astropods.com/_mcp/server.

# ast spec

Validate and explain `astropods.yml` spec files. The `--file/-f` flag is available on all `spec` subcommands.

```bash
ast spec <subcommand> [-f path/to/astropods.yml]
```

## spec validate

Validate `astropods.yml` against the spec schema.

```bash
ast spec validate [-f <file>]
```

Checks YAML syntax, JSON schema conformance, and semantic rules. Exit code `0` on success, making it suitable for CI.

## Next steps

* [Astropods Spec](/astropods-package-spec): the full spec reference
* [ast blueprint](/cli/blueprint): build and push once the spec validates