# Reference

Complete reference documentation for PromptScript.

## Language Paths

| Need                                | Start here                                                       |
| ----------------------------------- | ---------------------------------------------------------------- |
| Learn file structure                | [File Anatomy](https://getpromptscript.dev/reference/language/file-anatomy/index.md)                         |
| Understand composition              | [Composition and Precedence](https://getpromptscript.dev/reference/language/composition/index.md)            |
| Choose merge or replacement         | [Merge and Replacement](https://getpromptscript.dev/reference/language/merge-and-replacement/index.md)       |
| Resolve syntax warnings             | [Versions and Diagnostics](https://getpromptscript.dev/reference/language/versions-and-diagnostics/index.md) |
| Browse every block and grammar rule | [Complete Language Reference](https://getpromptscript.dev/reference/language/index.md)                       |

- [Agent Platform](https://getpromptscript.dev/features/index.md): Core features for instructions, skills, agents, MCP servers, plugins, hooks, workflows, and target delivery.
- [Language Reference](https://getpromptscript.dev/reference/language/index.md): Full specification of the PromptScript language syntax - blocks, directives, inheritance, and more.
- [CLI Reference](https://getpromptscript.dev/reference/cli/index.md): All commands and options for the PromptScript CLI - compile, validate, pull, and more.
- [Configuration](https://getpromptscript.dev/reference/config/index.md): Configuration file format and options - targets, registry, validation, and output settings.
- [Model Catalog](https://getpromptscript.dev/reference/models/index.md): Built-in model profiles, floating aliases, and the model name each target writes.
- [Formatters](https://getpromptscript.dev/reference/formatters/index.md): All 50 supported AI agent targets and two prompt targets - output paths, features, quirks, and examples.

