docs: corrige avisos de lint no markdown (MD040, MD060)

- Adiciona linguagem nos fenced code blocks (text)
- Corrige estilo de tabelas (espacos ao redor dos pipes)
- Adiciona requisito GitHub Pro para acesso ao GitHub Models

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Jesse Freitas 2026-03-22 15:46:06 -03:00
parent a5a6748a72
commit 49d82efcad
2 changed files with 12 additions and 7 deletions

View file

@ -20,9 +20,14 @@ claude --version
> Requer conta Anthropic com acesso ao Claude Code.
## 3. GitHub Personal Access Token (Worker)
## 3. GitHub Pro (obrigatorio para GitHub Models)
O Worker usa o GitHub Models API. Gere um token em:
O Worker usa o **GitHub Models API**, que exige uma conta **GitHub Pro** (ou superior: Team, Enterprise, Copilot Business/Enterprise).
> Contas GitHub Free **nao tem acesso** ao GitHub Models.
> Assine em: `https://github.com/settings/billing`
Apos ter o plano Pro, gere um Personal Access Token em:
`https://github.com/settings/tokens`**Fine-grained token** com permissao `models:read`.
## 4. Dependencias Python
@ -48,7 +53,7 @@ WORKER_MODEL=o4-mini # opcional, este e o padrao
## Modelos disponiveis (GitHub Models)
| Modelo | Perfil |
|---|---|
| --- | --- |
| `o4-mini` | Melhor para codigo (padrao) |
| `o3` | Mais poderoso, mais lento |
| `gpt-4.1` | Rapido, sem raciocinio |

View file

@ -7,7 +7,7 @@ O Reviewer valida e aprova via Claude Code CLI — sem custo adicional de API.
## Como funciona
```
```text
sua tarefa
└→ Worker (GitHub Models / o4-mini) ← geração barata e paralela
└→ Reviewer (Claude Code CLI) ← validação inteligente
@ -104,7 +104,7 @@ decisao = reviewer.decide(
## Modelos disponíveis
| Modelo | Perfil |
|---|---|
| --- | --- |
| `o4-mini` | **Melhor para código** — raciocínio interno (padrão) |
| `o3` | Mais poderoso, mais lento |
| `gpt-4.1` | Rápido, sem raciocínio, bom para tasks simples |
@ -112,7 +112,7 @@ decisao = reviewer.decide(
## Estrutura
```
```text
orchestrator/
├── config.py # Configuração e env vars
├── worker.py # Worker via GitHub Models API
@ -128,7 +128,7 @@ PREREQUISITES.md # Dependências do sistema
Comparando 1.000 tasks/mês versus usar apenas Claude Sonnet:
| Abordagem | Custo estimado |
|---|---|
| --- | --- |
| 100% Claude Sonnet | ~$33/mês |
| Worker (o4-mini) + Reviewer (Claude CLI) | ~$715/mês |
| **Economia** | **5680%** |