> For the complete documentation index, see [llms.txt](https://cumbucadev.gitbook.io/github-essentials/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cumbucadev.gitbook.io/github-essentials/dia-3/adicionando-arquivos-a-area-de-preparacao-via-git-add.md).

# Adicionando Arquivos à Área de Preparação via \`git add\`

O comando <mark style="color:purple;">git</mark> <mark style="color:orange;">add</mark> é usado para preparar mudanças feitas nos arquivos do seu projeto para serem incluídas no próximo commit.

## **Como Funciona**

1. **Modificar arquivos**

   Primeiro, você faz alterações nos arquivos do seu projeto. Essas mudanças podem incluir a edição de arquivos existentes, a adição de novos arquivos ou a exclusão de arquivos.&#x20;
2. **Adicionar à Área de Preparação**\
   Quando você está satisfeito com as alterações e deseja incluí-las no próximo commit, você usa o comando <mark style="color:purple;">git</mark> <mark style="color:orange;">add</mark> para mover essas mudanças para a área de preparação (*staging area*).\
   \
   Exemplo:  Se você editou um arquivo chamado `index.html`, você usaria <mark style="color:purple;">git</mark> <mark style="color:orange;">add</mark> <mark style="color:green;">index.html</mark> para preparar essas alterações.

## **Estrutura**

O formato base do comando <mark style="color:purple;">git</mark> <mark style="color:orange;">add</mark> é:

> <mark style="color:purple;">git</mark> <mark style="color:orange;">add</mark> <mark style="color:green;">arquivo</mark>

## **Exemplos de uso**

* Adicionar um arquivo específico:
  * <mark style="color:purple;">git</mark> <mark style="color:orange;">add</mark> <mark style="color:green;">index.html</mark>
  * Prepara as mudanças feitas em `index.html` para o próximo commit.
* Adicionar uma pasta específica:
  * <mark style="color:purple;">git</mark> <mark style="color:orange;">add</mark> <mark style="color:green;">images/</mark>
  * Prepara todas as mudanças feitas dentro da pasta `images/` para o próximo commit.
* Adicionar vários arquivos de uma vez:
  * <mark style="color:purple;">git</mark> <mark style="color:orange;">add</mark> <mark style="color:green;">index.html style.css script.js</mark>
  * Prepara as mudanças feitas em `index.html`, `style.css` e `script.js` para o próximo commit.
* Adicionar todos os arquivos modificados
  * <mark style="color:purple;">git</mark> <mark style="color:orange;">add</mark> <mark style="color:green;">.</mark>
  * Prepara todas as mudanças feitas em todos os arquivos do diretório atual e seus subdiretórios para o próximo commit.

{% hint style="danger" %}
**Importante:** Um erro muito comum entre iniciantes é usar o comando <mark style="color:purple;">git</mark> <mark style="color:orange;">add</mark> <mark style="color:green;">.</mark> sem revisar as mudanças, o que pode levar a adicionar e comitando arquivos indesejados. Prefira adicionar arquivos individualmente (<mark style="color:purple;">git</mark> <mark style="color:orange;">add</mark> <mark style="color:green;">arquivo</mark>) para ter mais controle sobre o que está sendo versionado.
{% endhint %}

O comando <mark style="color:purple;">git</mark> <mark style="color:orange;">add</mark> não altera o repositório de maneira significativa; ele apenas move as mudanças para a área de preparação (*staging area*). Isso informa ao Git que você deseja incluir essas alterações no próximo commit. No entanto, as mudanças não são realmente registradas no repositório até que você execute o comando <mark style="color:purple;">git</mark> <mark style="color:orange;">commit</mark>.&#x20;

Portanto, <mark style="color:purple;">git</mark> <mark style="color:orange;">add</mark> é uma etapa intermediária que permite que você **revise** e **selecione** as mudanças antes de salvá-las permanentemente no repositório.

{% hint style="warning" %}
Esta é uma explicação simplificada para fins didáticos. Para explorar todas as possibilidades do comando <mark style="color:purple;">`git`</mark><mark style="color:orange;">`add`</mark>, consulte a [documentação oficial](https://git-scm.com/docs/git-add/pt_BR).
{% endhint %}


---

# 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://cumbucadev.gitbook.io/github-essentials/dia-3/adicionando-arquivos-a-area-de-preparacao-via-git-add.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.