Reference

Reference pages answer exact lookup questions. Start with the artifact you need to type or interpret; return to a task guide when you need an end-to-end procedure.

Common lookups

Native commandsLook up the current ptah command tree and one-line behavior summaries.

Command flagsFind accepted flags, defaults, environment bindings, and mutation behavior.

ConfigurationLook up project files, environments, variables, data sources, and policy fields.

Schema formatsOpen the Go, HCL, or YAML field and directive reference.

Rules and diagnosticsInterpret capabilities, lint identifiers, exit codes, and stable failure contracts.

Generated versus authored reference

Command, flag, lint-rule, capability, and support inventories come from the registries they describe. Their pages identify the generator and edit source in frontmatter. Do not copy those enumerations into a workflow page.

Concept pages explain the mental model around desired schemas, migration directories, database URLs, dialects, and capabilities. They are grouped here because they support lookup, but they do not replace task guides.

Atlas compatibility

Use the separate Atlas compatibility overview before the Atlas command reference. It distinguishes native Ptah, default ptah-compat, strict Community Edition mode, and measured conformance evidence.