# Orquestrador de qualidade — casca

Fundação de um orquestrador de QA: o motor de pipeline, os contratos, a infraestrutura de
execução e a observabilidade. **Sem nenhuma regra de negócio.**

As ausências são intencionais e verificadas: zero prompts, zero gates concretos, zero chamadas
reais a modelo de linguagem, zero lógica de ferramenta de teste. O pipeline inteiro roda com
adaptador simulado, sem gastar um token.

## Comece por aqui

```bash
npm install
```

```bash
npm run verify
```

```bash
npm run pipeline -- --pack api --dry
```

```bash
npm run mcp
```

## Estrutura

```
packages/core/         motor: estágios, execução, trace, contratos, packs
packages/knowledge/    acesso a dados: derivado, curado, externo
packages/mcp-server/   servidor MCP stdio, 7 tools
packages/packs/api/    pack registrado e vazio
packages/packs/front/  pack registrado e vazio
scripts/               CLI e pipeline simulada de demonstração
docs/                  arquitetura, ADRs, formato das regras, pendências
```

## Onde as regras vão entrar

| Pack    | Diretório                      | Formato                                        |
| ------- | ------------------------------ | ---------------------------------------------- |
| `api`   | `packages/packs/api/regras/`   | [`docs/rules/README.md`](docs/rules/README.md) |
| `front` | `packages/packs/front/regras/` | [`docs/rules/README.md`](docs/rules/README.md) |

Um pack novo é um diretório com um `pack.json` — nenhum arquivo do motor precisa mudar.

## Documentação

- [Memória do projeto](CLAUDE.md) — o que um assistente precisa saber antes de mexer aqui
- [O produto](docs/produto.md) — o que estamos construindo e por quê
- [Achados da pesquisa](docs/pesquisa/achados.md) — o que restringe o desenho, com fonte
- [Arquitetura](docs/architecture/README.md) — visão geral, fluxo de execução e diagramas
- [Decisões](docs/decisions/) — ADRs numerados
- [Pendências](docs/pendencias.md) — o que ficou de fora, e por quê

## Comandos

| Comando                                 | O que faz                                     |
| --------------------------------------- | --------------------------------------------- |
| `npm run verify`                        | lint, formatação, typecheck e cobertura       |
| `npm run pipeline -- --pack <id> --dry` | executa a pipeline simulada e imprime o trace |
| `npm run mcp`                           | sobe o servidor MCP por stdio                 |
| `npm test`                              | só os testes                                  |
| `npm run format`                        | aplica a formatação                           |