> For the complete documentation index, see [llms.txt](https://argos-ci.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://argos-ci.com/docs/learn/platform-fundamentals.md).

# Core concepts

Argos turns the screenshots your tests produce into a review signal on your pull requests. This page defines the concepts you'll meet everywhere else in the docs.

### Builds and snapshots

A **build** is the result of one test run: the set of **screenshots** (and other snapshots, like [ARIA snapshots](/docs/learn/platform-fundamentals/how-argos-detects-visual-differences.md#what-argos-compares) or [text files](/docs/learn/how-to-guides/visual-coverage/compare-non-image-files.md)) uploaded together from your CI. Each build belongs to a project and is tied to a commit and branch.

A build goes through three stages:

1. **Upload**: Your CI uploads the snapshots, either automatically through an SDK or with the [CLI](/docs/reference/argos-command-line-interface-cli.md).
2. **Comparison**: Argos picks a [baseline build](/docs/learn/platform-fundamentals/baseline-build.md) and diffs each snapshot against its counterpart.
3. **Conclusion**: The build concludes with **No changes detected** or **Changes detected**, and Argos reports it to your Git provider as a commit status.

### Build types

Argos assigns each build a type that describes how it is compared:

* **Check**: The standard build on a feature branch — compared against a baseline and awaiting review when changes are detected.
* **Auto-approved**: A build on an [auto-approved branch](/docs/learn/platform-fundamentals/baseline-build.md#auto-approved-branches) (your default branch by default) — approved automatically so it can serve as a future baseline.
* **Orphan**: A build with [no baseline to compare against](/docs/learn/platform-fundamentals/baseline-build.md#orphan-builds) — expected for a project's first builds.
* **Skipped**: A build [intentionally marked as skipped](/docs/learn/how-to-guides/ci-pipelines/skipping-a-build.md) — reports success without screenshots.

### Review

When a build concludes with **Changes detected**, your team [reviews it](/docs/learn/review-workflow/review-a-build.md): approve the changes to accept them as the new expected state, or reject them to flag a regression. The review outcome updates the commit status on your pull request, so you can [require it before merging](/docs/learn/review-workflow/summary-checks.md).

### Go deeper

* [How Argos detects visual differences](/docs/learn/platform-fundamentals/how-argos-detects-visual-differences.md) – The deterministic diff algorithm behind comparisons
* [Baseline build](/docs/learn/platform-fundamentals/baseline-build.md) – How Argos chooses the build to compare against
* [Build modes](/docs/learn/platform-fundamentals/build-modes.md) – CI mode and Monitoring mode, and when to use each

Once the concepts are clear, head to the [Review workflow](/docs/learn/review-workflow.md) to see how builds are reviewed day to day.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://argos-ci.com/docs/learn/platform-fundamentals.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
