# Fashion360 — AGENTS.md

> Arquivo-raiz de instruções para agentes executores do repositório.
> Este arquivo existe principalmente para Codex, mas também pode ser usado como referência por qualquer agente automatizado.

## 1. Regra máxima deste repositório

Este projeto está em **modo de execução por fases e por pacotes**, com governança documental obrigatória.

Nenhum agente pode:
- pular fase;
- misturar pacotes;
- antecipar implementação de pacote futuro;
- usar material legado, histórico, backup ou diretórios fora do escopo permitido;
- tratar mock como implementação final;
- tratar persistência local como integração central;
- tratar integração como hardening final.

## 2. Ordem obrigatória de leitura antes de qualquer ação

Leia, nesta ordem:
1. `CURRENT-PHASE.md`
2. `CURRENT-PACKAGE.md`
3. `ALLOWED-PATHS.md`
4. `BLOCKED-PATHS.md`
5. `REGRAS-DE-BLOQUEIO.md`
6. `docs/01-plano-mestre-final.md`
7. `docs/02-padroes-gerais-do-projeto.md`
8. `docs/03-ordem-oficial-de-execucao.md`
9. `docs/04-matriz-de-dependencia-entre-modulos.md`
10. `docs/05-roadmap-de-implementacao-por-fases.md`
11. `docs/06-checklist-geral-de-pronto-para-codificar.md`
12. `SEQUENCIA-DE-USO.md`
13. `ENTREGA-ESPERADA-POR-PACOTE.md`
14. `agents/README.md`
15. o pacote atual em `docs/pacotes/`
16. o checklist do pacote atual em `docs/pacotes/checklists/`
17. o prompt do pacote atual em `agents/prompts/`, quando existir
18. o agente especializado estritamente necessário para a tarefa

## 3. Regra de pacote ativo

Só existe **um pacote ativo por vez**.

O pacote ativo está definido em `CURRENT-PACKAGE.md`.

Sem aprovação explícita do checklist do pacote atual, é proibido:
- iniciar o próximo pacote;
- criar artefatos do próximo pacote;
- alterar arquivos de escopo exclusivo do próximo pacote;
- assumir que “já dá para adiantar”.

## 4. Regra de saída obrigatória por execução

Toda resposta operacional do agente deve conter, no mínimo:
- documentos lidos;
- pacote atual;
- fase atual;
- objetivo do que foi feito;
- arquivos criados/alterados;
- o que **não** foi feito por estar fora do escopo;
- checklist de validação aplicado;
- pendências para o próximo passo.

## 5. Regra de segurança de contexto

A pasta `docs/` é a fonte principal de verdade.

A pasta `agents/` é camada operacional.

Se houver conflito entre:
- `docs/`
- `agents/`
- código atual
- instrução informal
- material legado

vence sempre nesta ordem:
1. `docs/`
2. `agents/`
3. código atual oficial compatível
4. demais referências

## 6. Regra de bloqueio

Se faltar qualquer definição crítica, o agente deve:
- parar no limite seguro;
- apontar a lacuna;
- não completar por dedução;
- não misturar fases.