# Documentation


- **Start**
- [Installation](/docs/installation): Install the openspec CLI on your machine, update it, and uninstall it.
- [Set up your project](/docs/setup): Add OpenSpec to a project: run init, see what it wrote, and adjust it.
- [Quickstart](/docs/quickstart): Your first change on your existing repo, from idea to archived.

- **Customize**
- [Overview](/docs/customize): Your options for customizing OpenSpec.
- [Profiles](/docs/profiles): Choose which workflows are installed, and whether they install as skills, commands, or both.
- [Project configuration](/docs/project-config): Make the workflows plan changes the way you want with a few lines in config.yaml.
- [Schemas](/docs/customize-schemas): Change what OpenSpec produces: the artifacts, their order, and their templates.

- **Multi-repo (beta)**
- [Stores (beta)](/docs/stores): Plan changes that span repositories: one store, many repos.
- [Worksets (beta)](/docs/worksets): Open the store and the repos that use it in one editor window, so your agent sees both.

- **Reference**
- [Skills](/docs/skills): Every OpenSpec skill: arguments, what it creates, and what it responds with.
- [CLI](/docs/cli): The openspec terminal commands.
- Schemas
  - [Overview](/docs/schemas): Every available workflow schema and the artifacts it defines.
  - [schema.yaml](/docs/schemas/schema-yaml): Every field of a schema definition, for reading or writing one.
  - [spec-driven](/docs/schemas/spec-driven): The default workflow's artifacts: their order, their formats, and the change folder they produce.
- Configuration
  - [Overview](/docs/configuration): Every file and setting that changes how OpenSpec behaves, and where each lives.
  - [Project configuration (config.yaml)](/docs/configuration/config-yaml): Every field of openspec/config.yaml: the schema, context, and rules this project plans with.
  - [Change metadata (.openspec.yaml)](/docs/configuration/change-metadata): The supported fields and validation rules for the metadata stored with each change.
  - [CLI settings (config.json)](/docs/configuration/config-json): Every field of config.json: how the openspec CLI behaves on your machine.
- [Supported tools](/docs/supported-tools): Which AI coding tools OpenSpec supports, and each one's command syntax.
- [Glossary](/docs/glossary): Every OpenSpec term, one line each.