> For the complete documentation index, see [llms.txt](https://docs.skail.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.skail.dev/conceitos/introducao/projetos.md).

# Projetos

No skail, um **projeto** é o agrupador de mais alto nível da plataforma. Ele reúne, em um único espaço, tudo que pertence a uma mesma iniciativa, produto ou domínio de negócio — workloads, environments, configurações, integrações e acessos — funcionando como o ponto de partida a partir do qual o restante dos recursos é organizado.

### Identidade

Um projeto é identificado pelo **nome** cadastrado no portal, por exemplo:

```
faturamento
logistica
portal-cliente
```

Cada projeto funciona como um espaço próprio, com seus próprios workloads, environments e membros.

### Para que serve

O projeto é o **escopo organizacional** da plataforma. Ele agrupa tudo o que pertence a uma mesma iniciativa e define a fronteira de visibilidade e gestão dos recursos. Isso significa que:

* **Workloads** são cadastrados e publicados sempre dentro de um projeto — o conjunto de aplicações que compõem aquela iniciativa fica reunido em um único lugar.
* **Environments** (como `dev`, `hml` e `prod`) existem no contexto do projeto, permitindo que cada iniciativa tenha seus próprios estágios de execução, independentes dos demais projetos.

### Relação com environments e workloads

A organização dos conceitos no skail forma uma hierarquia natural:

* O **projeto** define a iniciativa ou o produto.
* Dentro do projeto existem os **environments**, que separam os estágios do ciclo de vida (dev, hml, prod).
* Em cada environment são publicados os **workloads** (nome + versão), que de fato executam comandos, funções e features.

Assim, o projeto é o **onde tudo vive**, o environment é o **em qual estágio está rodando** e o workload é o **o que está executando**.

### Resumindo

> Um **projeto** no skail é o agrupador de mais alto nível da plataforma. Ele reúne todos os environments, workloads, configurações e acessos de uma mesma iniciativa/produto, servindo como fronteira de organização, isolamento e governança dentro da plataforma.